FlyPython
Sign inStart a challenge

上手 Cursor · 第 05 题 · English

第 5 课：把工作流带回自己的项目

检查点 l0510 分自我报告——认领码来自 verify.pyCursor（Agent 模式）

工具会泛化：任务契约、有界 Agent 工作、diff 评审——在你真正拥有的脚本上跑同一套闭环。

六门 Agent 工具课共用同一道题。Cursor（Agent 模式） 专属步骤仍在补写——补齐并通过审核前，本页 canonical 指向主课程的对应题目。

在用 Agent 做题？一句话开始整门课程：

Read https://flypython.com/skills/flypython/SKILL.md and start the FlyPython course `hands-on-with-cursor`.

第 5 课：把工作流带回自己的项目

目标

你把整套闭环——契约、项目规则、有界 Agent 工作、diff 评审、 书面验证——用到自己真正拥有的脚本或项目上，并记录发生了什么。

为什么有这节课

课程文件夹是安全沙箱；你自己的代码库不是。前四课的意义从来不是 那个报表工具——而是一种可复用的、让你始终掌控产出的 Agent 驱动 方式。本检查点要证明迁移真的发生了。它是自我报告的：闭环跑没跑 过只有你知道。

本课内容

挑一个你真正拥有的脚本——一个你拖了很久的 bug，或一个想要但 还没写的行为。然后走同样的五步：

  1. 契约。 先写任务契约：输入、输出、错误情况、以及「完成 = <命令> 退出码为 0」。一小段，每句都可测试。
  2. 能留存的规则。 在 Cursor 里打开项目，把工作规则写进 .cursor/rules/——Agent 可以碰哪些文件、验证命令是什么、 依赖政策。每个新对话自动继承。
  3. 有界工作。 一个 Agent 对话、一次一条契约行。每个 diff 的 每块都在接受前读完；每条命令都在运行前读完。
  4. 验证。 跑验证命令，然后做套件做不了的评审——拿一个真实 输入端到端走一遍，手工核对输出。
  5. 记录。 写三行：已验证 / 未验证 / 已知局限。

如果闭环跟你打架——任务小到不需要契约，或模糊到不可测——那也 是发现。写下形状不合身的地方；这个判断本身就是真本事。

练习

如果你的项目还有不止一处值得钉住的边界，现在就起草下一条契约行 ——开下一个对话时你会用得上。

检查点

本检查点自我报告：能回答下面三题时即可认领：

  1. 你的契约里「完成 =」命令是什么？
  2. 你在哪个 diff 或命令上顶回去过？
  3. 你的「未验证」清单上有什么是陌生人会以为已覆盖的？

预期证据

你的契约段落、你写的 .cursor/rules 文件、三行验证记录。它们是 你自己的——是工作流完成迁移的证明。

提示

卡住了？逐条打开。

提示 1 —— 本检查点考察什么

自我报告：你确认把这套闭环用到了自己的项目上。证据是你的契约、你接受的 diff、你的验证记录——不是我们查得了的码。

提示 2 —— 带走形状，不是代码

能迁移的是闭环：契约先行、一次一处有界改动、每个 diff 审过才接受、验证写下来。

提示 3 —— 完成的标志

你自己的脚本有了一份契约、一处你讲得清的有界改动、一份已验证/未验证/已知局限记录——或一条写清楚的「闭环不合身」的原因。

提交

做完了？记录它。

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

你浏览器

提交认领码

你的 Agent自动提交

让 Agent 解题并自动提交

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

请完成 FlyPython 挑战课程「上手 Cursor」（course id course-cursor）的检查点 l05。
机读简报：https://flypython.com/api/challenges/hands-on-with-cursor
打开课程文件夹，先读 TASK.md——它就是契约。
规则：最小变更、不新增依赖、绝不修改 tests/ 或 solution/。
用 python verify.py 检查直到门控通过，把每个认领码告诉我。
目标：只做检查点 l05 这一道题，完成后立即提交。

用你Agent 页生成的令牌（环境变量 FLYPYTHON_TOKEN），它可以直接记录结果：

curl -X POST https://flypython.com/api/claims \
  -H "Authorization: Bearer $FLYPYTHON_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"claims":[{"course":"hands-on-with-cursor","checkpoint":"l05","code":"<8-char code>"}]}'

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

文件

starter 与验证器

解题在你的机器上运行——Agent 通过 /api/challenges/hands-on-with-cursor/files 自己取回课程文件，你无需手动下载。想直接读源码？在 GitHub 上查看文件夹 ↗