Skip to content

Commit 0671b9a

Browse files
cursoragentxxg1413
andcommitted
docs: reconcile 0.0.3 TODOs and refresh 0.0.4 status header
Tick the 0.0.3 TODO items that have landed, each with the repository evidence checked on 2026-10-11, and keep FP-326, FP-332, and FP-335 open with notes on what is still missing. Replace stale master and website-pin SHAs in both plan headers with pointers to CHANGELOG.md, docs/REPO_TO_WEBSITE.md, and the website's content-pin.json. Co-authored-by: P小二 <xxg1413@gmail.com>
1 parent 5a7cb0c commit 0671b9a

2 files changed

Lines changed: 68 additions & 36 deletions

File tree

‎docs/repo-plan-0.0.3.md‎

Lines changed: 56 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,22 @@
11
# FlyPython 仓库 0.0.3 更新计划
22

3-
> 历史版本记录:本文件保留当时的范围与假设。2026-09-19 当前 `master` 已是
4-
> `39a3e79…`,生产网站也固定到该提交;不要把下文旧 pin 或未勾选 TODO 当成当前状态。
3+
> 历史版本记录:本文件保留当时的范围与假设,正文不再随仓库更新。§8 TODO 的
4+
> 勾选状态已于 2026-10-11 对照仓库核对;当前发布状态以 `CHANGELOG.md` 与
5+
> `docs/REPO_TO_WEBSITE.md` 为准,网站固定的提交记录在网站仓库
6+
> `src/data/content-pin.json`。
57
68
版本:0.0.3(规划稿)
7-
更新:2026-09-11
9+
更新:2026-09-11(TODO 勾选状态核对于 2026-10-11)
810

911
历史边界说明:本文记录 0.0.3 的内容模型和实施计划。当前挑战叙事、认领码、
10-
徽章与公开学习路线已经由 0.0.4 计划接续;网站当前固定到后续状态提交
11-
`920f790`。本文中的
12-
“Agent 授课”和未勾选 TODO 不代表当前状态。本文件按所有者决策以中文保留。
12+
徽章与公开学习路线已经由 0.0.4 计划接续,本文中的“Agent 授课”叙事不代表
13+
当前产品形态。本文件按所有者决策以中文保留。
1314
关联:flypython.com `docs/product-and-growth-plan-0.0.3.md`
1415

15-
状态:规划文档,不代表已实现。本计划遵守 `AGENTS.md` 的仓库边界:本仓库
16-
负责已审核内容、可运行证据与稳定 JSON 契约;网站负责展示与转化。
17-
所有新内容中英文同步产出。
16+
状态:已基本实现(2026-10-11 核对)。§8 中 FP-326、FP-332、FP-335 仍有
17+
未完成部分,见各项备注;其余各项已在仓库中落地。本计划遵守 `AGENTS.md` 的
18+
仓库边界:本仓库负责已审核内容、可运行证据与稳定 JSON 契约;网站负责展示与
19+
转化。所有新内容中英文同步产出。
1820

1921
## 1. 网站 0.0.3 方向对本仓库的要求
2022

@@ -140,32 +142,57 @@ risk: "…"
140142
5. `/from-github` 线上验证后做 README 导流改造。
141143
6. 首个课程落地时开始 Releases/tagging 节奏。
142144

143-
## 8. TODO(编号续接网站规划;全部未验收)
145+
## 8. TODO(编号续接网站规划)
144146

145-
- [ ] FP-325 `courses/` 规范写入 `AGENTS.md`;COURSE.md 授课契约经评审。
147+
勾选状态于 2026-10-11 对照仓库核对。网站侧的部分(pin、llms-links 测试)
148+
不在本仓库,无法从这里核实,备注中单独说明。
149+
150+
- [x] FP-325 `courses/` 规范写入 `AGENTS.md`;COURSE.md 授课契约经评审。
151+
(核对:`AGENTS.md` 内容规则含完整课程文件夹规范;12 门课均有 `COURSE.md`
152+
与 `REVIEW.md`)
146153
- [ ] FP-326 C1 课程文件夹完成(3 个场景皮、verify.py 双向、EN+CN、
147-
真实跟课的 REVIEW.md)。
148-
- [ ] FP-327 manifest `type: "course"` + schema + `build_content_manifest.py`
149-
遍历;网站 pin 更新同一次刻意完成(FP-224 规则)。
150-
- [ ] FP-328 `verify_courses.py` 进入验证工作流与 Makefile。
151-
- [ ] FP-329 `catalog/projects/` 迁为 per-project YAML(迁移 7 条种子)+
152-
`render_readmes.py` 重生成验证。
153-
- [ ] FP-330 `radar.json` 导出 + `schema/radar-v1.schema.json` +
154-
`export_catalog.py` 扩展;`--check` 全绿。
155-
- [ ] FP-331 `tools/radar_scan.py` 合入:限速与"不生成描述"有测试保证。
154+
真实跟课的 REVIEW.md)。(核对:3 个场景皮 `api-tool` / `data-monitor` /
155+
`excel-report`、verify.py 双向、EN+CN 均已完成,挑战模式可解性实测已录
156+
`REVIEW.md`;**授课式实机走查仍待做**,见该课 `REVIEW.md` 的 Pending 一节)
157+
- [x] FP-327 manifest `type: "course"` + schema + `build_content_manifest.py`
158+
遍历;网站 pin 更新同一次刻意完成(FP-224 规则)。(核对:manifest schema
159+
含 `course` 与 `path`,`build_content_manifest.py --check` 通过;网站 pin
160+
在网站仓库 `src/data/content-pin.json`)
161+
- [x] FP-328 `verify_courses.py` 进入验证工作流与 Makefile。(核对:
162+
`make check` 执行,CI 的 Validate 即 `make check`)
163+
- [x] FP-329 `catalog/projects/` 迁为 per-project YAML(迁移 7 条种子)+
164+
`render_readmes.py` 重生成验证。(核对:7 个 `*.yml`,
165+
`render_readmes.py --check` 通过)
166+
- [x] FP-330 `radar.json` 导出 + `schema/radar-v1.schema.json` +
167+
`export_catalog.py` 扩展;`--check` 全绿。(核对:
168+
`export_catalog.py --check --target both` 通过)
169+
- [x] FP-331 `tools/radar_scan.py` 合入:限速与"不生成描述"有测试保证。
170+
(核对:`tests/test_radar_scan.py` 含每来源上限与“候选不带结论字段”测试)
156171
- [ ] FP-332 llms.txt / llms-full.txt 增加 courses+radar 区块;深链有效
157-
(pin 更新后网站侧 llms-links 测试保持绿)。
158-
- [ ] FP-333 `CURATION_POLICY.md` scope + `ai_familiarity` 分级规则;
159-
`course-feedback.yml` issue 模板。
160-
- [ ] FP-334 仓库描述/topics/关键词;第一个 GitHub Release。
172+
(pin 更新后网站侧 llms-links 测试保持绿)。(核对:`llms.txt` 已有
173+
courses 与 radar 区块;`llms-full.txt` 由网站提供,本仓库只引用。**课程
174+
列表已过时**:只列 8 门,缺 `hands-on-with-cursor`、
175+
`hands-on-with-deepseek-harness`、`hands-on-with-kimi-code`、
176+
`hands-on-with-zcode`,且 `courses/hands-on-with-openai-codex-cli/` 深链
177+
失效,实际目录为 `courses/hands-on-with-openai-codex/`)
178+
- [x] FP-333 `CURATION_POLICY.md` scope + `ai_familiarity` 分级规则;
179+
`course-feedback.yml` issue 模板。(核对:两者均已在仓库中)
180+
- [x] FP-334 仓库描述/topics/关键词;第一个 GitHub Release。(核对:仓库
181+
描述与 10 个 topics 已设置;`v0.1.0` 标签于 2026-09-12 打在 `e420fca`,
182+
首个 GitHub Release 为 `v0.1.1`,2026-09-14)
161183
- [ ] FP-335 README/README_cn 横幅 + 各文档情境化文末链接,以线上
162-
`/from-github` 验证为前置。
163-
- [ ] FP-344 双许可 LICENSE 就位(MIT 代码 / CC BY 4.0 内容,两仓库同)——
164-
课程文件夹分发与 FP-326 的前置。
165-
- [ ] FP-350 校验器与 schema 追上政策:`validate_catalog.py` 与
184+
`/from-github` 验证为前置。(核对:guides / playbooks / examples 的
185+
文末情境化链接已全部加上;README 横幅链网站根域,**未切到 `/from-github`**。
186+
该路由已上线,`docs/REPO_TO_WEBSITE.md` 允许两种链法,是否切换待所有者决定)
187+
- [x] FP-344 双许可 LICENSE 就位(MIT 代码 / CC BY 4.0 内容,两仓库同)——
188+
课程文件夹分发与 FP-326 的前置。(核对:本仓库 `LICENSE` 已是双许可;
189+
网站仓库未在此核实)
190+
- [x] FP-350 校验器与 schema 追上政策:`validate_catalog.py` 与
166191
`catalog-v1`/`radar-v1` 支持 Radar 生命周期状态与 `ai_familiarity`;
167192
manifest schema 增加 `type: "course"`;首个 Release(FP-334)时把
168-
CHANGELOG `[Unreleased]` 切入 `0.1.0` 段。
193+
CHANGELOG `[Unreleased]` 切入 `0.1.0` 段。(核对:`radar-v1` schema 与
194+
`tools/catalog.py` 校验 6 种生命周期状态与 `ai_familiarity`,由
195+
`export_catalog.py --check` 执行;CHANGELOG 已有 `[0.1.0] - 2026-09-12`)
169196

170197
## 9. 非目标与风险
171198

‎docs/repo-plan-0.0.4.md‎

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,21 @@
11
# FlyPython 仓库 0.0.4 更新计划
22

3-
> 历史版本记录:本文件保留当时的挑战模型和发布证据。2026-09-19 当前 `master`
4-
> 已是 `39a3e79…`,learner verifier v2 已上线;下文旧 pin 只表示当时快照。
3+
> 历史版本记录:本文件保留当时的挑战模型和发布证据,正文不再随仓库更新;
4+
> 下文出现的提交 SHA 只表示当时快照。当前发布状态以 `CHANGELOG.md` 与
5+
> `docs/REPO_TO_WEBSITE.md` 为准,网站固定的提交记录在网站仓库
6+
> `src/data/content-pin.json`。
57
68
版本:0.0.4(规划草稿,第 3 版)
7-
更新日期:2026-09-12(第 3 版——挑战模型定稿 + A/B 阶段拆分)
9+
更新日期:2026-09-12(第 3 版——挑战模型定稿 + A/B 阶段拆分;状态说明核对于 2026-10-11)
810
关联:flypython.com `docs/product-and-growth-plan-0.0.4.md`
911

10-
状态:除 FP-414 外本计划已实现;真实 Agent 可解性试跑已于 2026-09-13
11-
完成(Devin, SWE-2 Max,全部 8 门课,挑战模式实测记录见各课
12-
`REVIEW.md`;授课式走查仍为另行待办)。网站当前固定
13-
到 `920f790`(阶段 A + 数据分析模块 live 状态)。`AGENTS.md` 的仓库边界不变:
12+
状态(2026-10-11 核对):除 FP-414 外本计划已实现。之后 2026-09-16 的
13+
learner verifier v2 把认领入口从 `progress --json` 换成 `check --json` +
14+
`--attest`,`progress --json` 只保留给旧版签名回执(见 CHANGELOG)。真实
15+
Agent 可解性试跑已于 2026-09-13 完成(Devin, SWE-2 Max,当时全部 8 门课,
16+
挑战模式实测记录见各课 `REVIEW.md`)。仍未完成两项:FP-414(SKILL.md 打包
17+
评估);授课式实机走查,目前 9 门课的 `REVIEW.md` 仍列为 Pending,属于发布
18+
证据,不阻塞内容。`AGENTS.md` 的仓库边界不变:
1419
本仓库拥有经审核的内容、可运行的证据与稳定的 JSON 契约;网站拥有呈现、
1520
账号体系与转化。所有新内容中英同一次变更交付。
1621

0 commit comments

Comments
 (0)