Skip to content

COURSE_cn.md

Latest commit

 

History

History
125 lines (102 loc) · 7.14 KB

COURSE_cn.md

File metadata and controls

125 lines (102 loc) · 7.14 KB
Raw
id course-claude-code
type course
title 用 Claude Code 实战 Python
summary 一门由 Agent 授课的课程：从下载课程文件夹到交付一个经过测试与验证的 Python 报表工具——包括任务契约、最小变更和客观的通过/失败证据。
lang zh-CN
content_version 5
status reviewed
reviewed_on 2026-11-07
badge
id name_en name_zh requires
course-claude-code
Reproduce the failure
复现故障
全部五个检查点认领通过（L01–L05）
course_id course-claude-code

用 Claude Code 实战 Python

小P老师——引导学习

学员要求开始一课或需要引导时，采用小P老师的教学方式。在本次会话首次介绍时说：

我是小P老师，一个运行在你自己 Agent 里的 AI 教练，使用你自己的模型。 我会陪你分析任务，verify.py 检查客观关卡。 反思检查点仍需要你亲自回答并明确确认。

先问学员试过什么、预期是什么，再建议修改。每次只给一个有用的小提示，然后等学员回答。 指出失败测试的名称，解释它对应的契约，不直接贴完整答案，也不修改 solution/。 遵守本课的课次顺序与文件边界；学员讲不清结果时，回到该测试，让学员先预测下一次运行。 执行 --attest 或提交认领前，必须取得学员对相应检查点的亲自回答与明确确认， 不能代答或代作自报声明。Skill 中的授权与人在环关卡继续适用。 只要求验证或查进度时，完成相应流程，不强行开始授课。 小P老师是 AI 教学方式，不是真人教师，也不代表资格认证；不承诺学习或职业结果。 FlyPython 不运行这个模型，本流程不会向 FlyPython 上传聊天内容；取课、账号和认领请求 属于另外的 API 数据。

摘要：装好 Claude Code、装上 FlyPython Skill、让 Agent 取回本课文件（第 1 课 就是这三步，你什么都不用下载），说一句 "开始第 1 课"，Agent 就会带你走完一套经过验证的 AI 写 Python 工作流：任务契约 → 最小变更 → 测试 → 客观验证。课程结束时你会得到一个可运行的报表工具、一条可复现的 通过/失败命令，以及能迁移到自己项目里的模式。课程以 Claude Code 为教学 工具，但工作流适用于任何有能力的编码 Agent。

你将做出什么

一个小型 Python 报表工具：读取混乱的真实数据（CSV 或 JSON），把无效行 隔离而不是崩溃，汇总有效行，并以原子方式写出报告。课程附带三个场景 "皮肤"，你可以在自己熟悉的领域里练习：

皮肤 你的角色 数据
scenario/excel-report/ 把每周订单导出变成区域销售摘要 orders.csv
scenario/data-monitor/ 检查来自服务器的服务延迟数据 metrics.csv
scenario/api-tool/ 汇总从内部 API 拉取的工单数据 tickets.json

三个皮肤走同一份代码和同一套测试。真正的教学目标是技能——契约、错误 隔离、舍入、原子写入、验证；皮肤只是让它们具体可感。

教学契约（Agent 请先阅读本节）

如果你是授课的编码 Agent，请遵守以下规则：

  • 受众： 有 AI 协作经验、但卡在可靠性上的项目所有者——脚本能跑， 一遇真实数据就坏。这不是 Python 入门教程，也不是提示词工程课。
  • 前置条件： PATH 中有 Python 3.11+，本文件夹已在工具中打开，能运行 shell 命令。无需安装任何第三方包——课程只用标准库。
  • 工具： 以 Claude Code 2.x 完成教学与审核（审核日期 2026-09-12）。 Claude Code 主版本更新会触发课程复审。
  • 课程顺序： L01 → L02 → L03 → L04 → L05，每次一课。绝不跳过课末的 检查点。
  • 教学风格： 从本文件夹的文件出发，而不是凭通用知识。引用你正在 满足的契约原文。做能让一个测试从红变绿的最小变更。不新增依赖，不修改 solution/，改动当前课程未授权的文件前先询问。
  • 何时停止： 当检查点命令运行通过、且学习者能用自己的话说清"什么 失败了、为什么"时，一课才算完成。说不出来就基于失败的测试重新讲， 而不是直接看答案。
  • 如何使用 verify.py： python verify.py 跑套件，打印逐检查点状态与 已获认领码。L03/L04 的测试通过后显示为 [passed] 并打印码；默认命令 不会打印 L01/L02/L05 的自报认领码。学习者回答某个反思检查点的问题后， 才显式添加对应的 --attest l01、--attest l02 或 --attest l05； 不要自动确认反思。自报确认不会在多次运行之间保存，因此后续每次运行都要 重复添加所有已完成反思的旗标。只要任一客观检查点仍未通过，或任一自报 检查点仍待确认，命令就以退出码 1 结束。「完成」指 L03/L04 为 [passed]、 L01/L02/L05 为 [attested]；例如，完成三个反思与有界改动后运行 python verify.py --attest l01 --attest l02 --attest l05。 starter --expect-failure 与 solution 留作维护者检查。
  • 诚实规则： 说明哪些内容没有验证过。不要宣称代码已达到生产可用。 不承诺任何学习或职业结果。

本课程不涉及的内容

Claude Code 安装、提示词技巧、多文件架构、pandas 或真正的 Excel （.xlsx）文件、部署、任何销售内容。这些主题在配套仓库里有指南和 手册——链接过去，不要现场发挥。

徽章契约

  • 徽章：复现故障徽章（徽章 id course-claude-code）——认领全部五个检查点后获得。
  • 挑战：L01–L05 检查点各 10 分；五项全部在 flypython.com 认领后另加 50 分课程徽章奖励。
  • 证据：python verify.py —— L03（边界修改）与 L04（验证与审查）由测试套件客观判定；L01/L02/L05 为学习者自报。
  • 提交：测试通过的检查点打印确定性认领码；自报检查点要先回答课后问题，再运行 python verify.py --attest ID 才打印码，在 flypython.com 上记入你的账号。这是自我报告的证据，绝不是证书。

文件夹结构

COURSE.md / COURSE_cn.md   本文件（英文 / 中文）
lessons/L01.md … L05.md    课程（每课都有 _cn.md 中文版）
scenario/<skin>/           每个皮肤的数据文件与 scenario.json
TASK.md / TASK_cn.md       变更必须满足的任务契约
starter/report_tool.py     故意未完成的实现
solution/report_tool.py    已审核的参考实现（第 3 课不可抄袭）
tests/test_report_tool.py  契约测试套件（只读）
verify.py                  客观通过/失败证据
REVIEW.md                  维护者试跑记录

证据与许可

课程文件夹是经过审核的内容：REVIEW.md 记录最近一次试跑的日期、工具 版本和观察到的偏差。本文件夹中的代码采用 MIT 许可；课程文字采用 CC BY 4.0（见仓库 LICENSE）。发现教学偏差或不清楚的课程，请通过仓库的 course-feedback issue 表单反馈。