Skip to content

Commit b38667f

Browse files
author
pxiaoer
committed
0.0.8 A3: bare verify.py default command, standalone folders, tool-course lesson 1 rework
FP-820: python verify.py (no args) is the learner's command on all 12 free courses, 3 pro courses, and the data-analysis capstone - suite status, per-checkpoint claim codes, English-first output, non-zero exit while gated checkpoints are open. Published progress --json and --receipt-out formats unchanged; the four explicit usages stay for maintainers. FP-821: verify_courses.py copies each course plus tools/claim_receipt.py into an isolated tree and enforces the default command + receipts there. FP-822: six agent-tool courses' lesson 1 (EN+ZH) rewritten to the fixed order tool -> FlyPython Skill (network on) -> agent fetches the course files; download wording removed from COURSE.md and lessons; solution no longer the completion standard. FP-823: prose checkpoints in three 0.0.3 courses became question lists for the human-in-the-loop gate. FP-824: README/README_cn start section leads with the Skill entry sentence and the six tool courses.
1 parent c87db55 commit b38667f

144 files changed

Lines changed: 2154 additions & 738 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,41 @@ This file records notable catalog-contract and maintenance changes.
44

55
## [Unreleased]
66

7+
0.0.8 — Skill as the main entry (companion-repository half; see the
8+
website plan `docs/product-and-growth-plan-0.0.8.md`).
9+
10+
### Added
11+
12+
- FP-820: bare `python verify.py` is the learner's default command on
13+
every course and the data-analysis capstone — runs the suites, prints
14+
per-checkpoint status and earned claim codes (English first, Chinese
15+
after), exits non-zero while gated checkpoints are open. The four
16+
explicit usages remain maintainer checks; the published
17+
`progress --json` / `--receipt-out` formats are unchanged.
18+
- FP-821: `tools/verify_courses.py` now copies each course folder plus
19+
the shared `tools/claim_receipt.py` into an isolated tree and runs the
20+
default command and the receipts contract there — a course fetched via
21+
the files endpoint verifies alone.
22+
23+
### Changed
24+
25+
- FP-822: the six agent-tool courses' lesson 1 (EN+ZH) is rewritten
26+
around the fixed order get-the-tool-running → install the FlyPython
27+
Skill (network access included) → let the agent fetch the course
28+
files; every "download this folder" wording is gone from `COURSE.md`,
29+
`COURSE_cn.md`, and the lessons, and `verify.py solution` is no longer
30+
presented as a completion standard.
31+
- FP-823: the prose checkpoints of `agent-rules-single-source`,
32+
`mcp-server-in-python`, and `verifying-ai-generated-code` are question
33+
lists the agent can ask directly at the human-in-the-loop gate;
34+
data-analysis courses keep their concrete checkpoint criteria and
35+
frontmatter hint questions.
36+
- FP-824: both READMEs' "Start in three minutes" leads with the Skill
37+
entry sentence and the six agent-tool courses instead of a clone +
38+
download flow.
39+
40+
## [Unreleased-0.0.4-phase-A]
41+
742
0.0.4 phase A — challenge-platform rework on top of 0.1.0.
843

944
### Added

‎README.md‎

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,24 @@ versions into a browsable learning experience.
2525

2626
## Start in three minutes
2727

28-
No installation is required beyond Python 3.11+ (development pins 3.12
29-
through `.python-version`):
28+
You need a coding agent that can run commands and reach the network
29+
(Claude Code, the Codex app, Cursor, DeepSeek Harness, Kimi Code, or
30+
ZCode — chat-only web AIs cannot run these courses). Install the
31+
[FlyPython Skill](https://flypython.com/skills/flypython/SKILL.md) in
32+
your agent, then paste this one sentence:
33+
34+
> Read https://flypython.com/skills/flypython/SKILL.md and start the FlyPython course `da-eda`.
35+
36+
The agent authorizes you with a one-time link (you never hand it a
37+
password), fetches the course files itself — you download nothing — and
38+
drives the challenges with you. New to driving an agent? Start with the
39+
tool course for *your* agent: [Hands-on Python with Claude Code](courses/hands-on-python-with-claude-code/COURSE.md),
40+
[Codex app](courses/hands-on-with-openai-codex/COURSE.md), [Cursor](courses/hands-on-with-cursor/COURSE.md),
41+
[DeepSeek Harness](courses/hands-on-with-deepseek-harness/COURSE.md),
42+
[Kimi Code](courses/hands-on-with-kimi-code/COURSE.md), or
43+
[ZCode](courses/hands-on-with-zcode/COURSE.md).
44+
45+
Maintainers can still reproduce an example locally without any agent:
3046

3147
```bash
3248
git clone https://github.com/flypythoncom/python.git
@@ -35,10 +51,6 @@ python examples/product-slug/verify.py starter --expect-failure
3551
python examples/product-slug/verify.py solution
3652
```
3753

38-
You just reproduced a bug and verified its fixed behavior. Now give the
39-
[task contract](examples/product-slug/TASK.md) and [agent rules](templates/AGENT_RULES.example.md)
40-
to a coding agent (Cursor, Windsurf, Claude Code, Copilot) and make the starter pass without copying the solution.
41-
4254
## Choose what you need to accomplish
4355

4456
| Goal | Start here | What you will produce |

‎README_cn.md‎

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,23 @@ FlyPython 是一个面向实践的双语仓库，帮助你写好 Python，并把
2222

2323
## 3 分钟开始
2424

25-
只需要 Python 3.11+（开发环境通过 `.python-version` 固定在 3.12）：
25+
你需要一个能执行命令并联网的编码 Agent（Claude Code、Codex 应用、
26+
Cursor、DeepSeek Harness、Kimi Code 或 ZCode——只能聊天的网页 AI 做
27+
不了这些课程）。在你的 Agent 里装上
28+
[FlyPython Skill](https://flypython.com/skills/flypython/SKILL.md)，
29+
然后粘贴这一句话：
30+
31+
> Read https://flypython.com/skills/flypython/SKILL.md and start the FlyPython course `da-eda`.
32+
33+
Agent 会用一次性授权链接为你授权（你不用把密码交给它），自己取回
34+
课程文件——你不下载任何东西——并陪你完成挑战。还没用过编码 Agent？
35+
从*你的*工具对应的工具课开始：[Claude Code 实战](courses/hands-on-python-with-claude-code/COURSE_cn.md)、
36+
[Codex 应用](courses/hands-on-with-openai-codex/COURSE_cn.md)、[Cursor](courses/hands-on-with-cursor/COURSE_cn.md)、
37+
[DeepSeek Harness](courses/hands-on-with-deepseek-harness/COURSE_cn.md)、
38+
[Kimi Code](courses/hands-on-with-kimi-code/COURSE_cn.md)、
39+
[ZCode](courses/hands-on-with-zcode/COURSE_cn.md)。
40+
41+
维护者仍然可以不借助任何 Agent 在本地复现示例：
2642

2743
```bash
2844
git clone https://github.com/flypythoncom/python.git
@@ -31,10 +47,6 @@ python examples/product-slug/verify.py starter --expect-failure
3147
python examples/product-slug/verify.py solution
3248
```
3349

34-
你刚刚复现了一个 Bug，并验证了修复后的行为。接下来把[任务契约](examples/product-slug/TASK_cn.md)
35-
与 [Agent 规则模板](templates/AGENT_RULES.example_cn.md) 提供给 Coding Agent（如 Cursor、Windsurf、Claude Code、Copilot），
36-
让 starter 通过测试，但先不要复制 solution。
37-
3850
## 选择你现在要完成的事
3951

4052
| 目标 | 从这里开始 | 最终产出 |

0 commit comments

Comments
 (0)