Agent 规则的单一真源 · 第 02 题 · English

确定唯一真源

检查点 l0210 分自我报告——认领码来自 verify.py任一编码 Agent(Claude Code 2.x / Codex CLI 0.x / Cursor)

AGENTS.md 成为 Agent 唯一阅读的文件;其余都只能是指针或副本——先决定,再写下来。

在用 Agent 做题?一句话开始整门课程:

Read https://flypython.com/skills/flypython/SKILL.md and start the FlyPython course `agent-rules-single-source`.

确定唯一真源

目标

AGENTS.md 成为 Agent 唯一阅读的文件;其余都只能是指针或副本——先决定,再写下来。

课程内容

读仓库自己的 AGENTS.md 与 templates/AGENT_RULES.example.md。本课程强制的决定是:AGENTS.md 是真源(AAIF 治理、Agent 原生的标准);CLAUDE.md 与 .cursorrules 只能指向它。把你仓库的决定写成一句话——那句话就是你的契约。

练习

  • 列出你的哪些规则文件在复述规则而不是指向真源
  • 让 Agent 点评这句话里的歧义

检查点

本课的命令运行通过,并且你能用自己的话回答下面的问题(由 Agent 提问、你作答——这就是关口):

  1. 本课跑了哪条命令,它判定了什么?
  2. 一开始什么失败了、为什么——用你自己的话说?
  3. 下次再信任类似的改动之前,你会先检查什么?

预期证据

命令输出记录与你的回答。

提示

卡住了?逐条打开。

提示 1 —— 这个检查点考什么

定出唯一真源:AGENTS.md 是 Agent 真正读的文件,其余规则文件只能是薄指针或逐字节副本。

提示 2 —— 指针还是副本

指针最多 10 个非空行且引用 AGENTS.md;副本与真源逐字节一致。其余都是 diverged。写下你自己仓库里每个文件会被判成哪类。

提示 3 —— 完成标准

你的决定落了字:谁是真源,其余文件允许装什么。

提交

做完了?记录它。

提交 verify.py progress 为本检查点打印的 8 位认领码——浏览器里交,或让你的 Agent 直接交。

浏览器

提交认领码

你的 Agent自动提交

让 Agent 解题并自动提交

把这题交给它(悬停出现复制按钮)——解题、验证、提交全程自动:

请完成 FlyPython 挑战课程「Agent 规则的单一真源」(course id course-agent-rules)的检查点 l02。
机读简报:https://flypython.com/api/challenges/agent-rules-single-source
打开课程文件夹,先读 TASK.md——它就是契约。
规则:最小变更、不新增依赖、绝不修改 tests/ 或 solution/。
用 python verify.py 检查直到门控通过,把每个认领码告诉我。
目标:只做检查点 l02 这一道题,完成后立即提交。

用你Agent 页生成的令牌(环境变量 FLYPYTHON_TOKEN),它可以直接记录结果:

curl -X POST https://flypython.com/api/claims \
  -H "Authorization: Bearer $FLYPYTHON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"claims":[{"course":"agent-rules-single-source","checkpoint":"l02","code":"<8-char code>"}]}'

或一次性安装完整的 FlyPython Agent Skill,连粘贴都省了。

文件

starter 与验证器

解题在你的机器上运行——Agent 通过 /api/challenges/agent-rules-single-source/files 自己取回课程文件,你无需手动下载。想直接读源码?在 GitHub 上查看文件夹 ↗