Skip to content

COURSE_cn.md

Latest commit

 

History

History
103 lines (86 loc) · 5.48 KB

COURSE_cn.md

File metadata and controls

103 lines (86 loc) · 5.48 KB
Raw
id course-kimi-code
type course
title 上手 Kimi Code
summary 经过验证的 Python 工作流——任务契约、有界改动、客观 verify.py 证据——在 Kimi Code 里手把手教：内置子代理把只读勘察、规划和经你批准的编辑分在三条道上。
lang zh-CN
content_version 2
status reviewed
reviewed_on 2026-09-13
badge
id name_en name_zh requires
course-kimi-code
Reproduce with Kimi Code in the loop
Kimi Code 协同复现
认领全部五个检查点（L01–L05）
course_id course-kimi-code

上手 Kimi Code

一句话：装好 kimi CLI、装上 FlyPython Skill、让 Agent 取回本课文件（第 1 课 就是这三步，你什么都不用下载），对它说**「开始第 1 课」**。 完成时你会得到一个能跑的报表工具、一条可复现的通过/失败命令， 以及 Kimi Code 工作流：内置 explore/plan/coder 子代理把读、 规划、改代码分在三条道上。练习核心与其他 Agent 工具课程完全相同 ——变的只是你驱动的工具。

你要做的东西

一个小型 Python 报表工具：读进脏乱的真实数据（CSV 或 JSON）、隔离 无效行而不是直接崩溃、聚合有效行、原子地写出报告。课程自带三个 「场景皮肤」，让你在自己熟悉的领域里练习：

皮肤 你是…… 数据
scenario/excel-report/ 把每周订单导出整理成区域汇总 orders.csv
scenario/data-monitor/ 检查自家服务器的延迟数据 metrics.csv
scenario/api-tool/ 汇总从内部 API 拉取的工单数据 tickets.json

三个皮肤跑的是同一份代码、同一套测试。真正的产品是这些技能——契约、 错误隔离、舍入、原子写、验证——皮肤只是让它们变得具体。

教学契约（先读，Agent）

如果你是教授本课程的 Kimi Code Agent，请遵守以下规则：

  • 受众： 有 AI 协作经验、但困在可靠性上的项目所有者——脚本能跑， 一遇真实数据就坏。这不是 Python 入门教程，也不是提示词工程课。
  • 前置条件： PATH 上有 Python 3.11+，装有 kimi CLI 并完成认证 （学习者自备 Moonshot/Kimi 账号或 API key）。无需安装任何包—— 课程只用标准库。免费档能否撑完整门课在编写时未经证实——见 REVIEW.md。
  • 工具： 按 moonshotai.github.io/kimi-code 上文档描述的 Kimi Code 编写（内置 coder/explore/plan 子代理、用于编辑器集成 的 kimi acp）。真实授课实跑尚待完成——REVIEW.md 记录已验证 与未验证的部分。Kimi Code 主版本发布会触发课程重审。
  • 课序： L01 → L02 → L03 → L04 → L05，一次课一个会话。 绝不跳过课尾的检查点。
  • 教学风格： 从本文件夹里的文件出发，不要凭通用知识发挥。引用 你正在满足的那条契约原文。做让测试从红变绿的最小改动。绝不加 依赖、绝不改 solution/、动当前课程未点名的任何文件前先询问。 仓库根若有 AGENTS.md，读它。
  • 何时停下： 一节课的检查点命令跑通、且学习者能用自己的话说清 哪里坏了、为什么，这节课才算完。学习者说不出就从失败测试重新教， 不要从 solution 教。
  • 如何使用 verify.py： 学员命令就是 python verify.py——它跑套件、 打印逐检查点状态与已获认领码，在门控检查点（l03、l04）未全通过时以 非零退出。starter --expect-failure 与 solution 留作维护者检查。 「完成」指学习者做完有界改动后，默认命令把所有门显示为 [passed]。- 诚实规则： 说清你没验证什么。不要声称代码达到生产可用。不要 承诺学习或职业结果。

本课程不覆盖什么

Kimi Code 的安装与计费、自定义子代理编写、ACP 客户端开发，以及 任何推销内容。这些由配套仓库的指南与手册承载——给链接，不即兴 发挥。

徽章契约

  • 徽章：Kimi Code 协同复现徽章（badge id course-kimi-code）——认领全部五个检查点获得。
  • 挑战：L01–L05 检查点，各 10 分；在 flypython.com 上集齐五个再加 50 分课程徽章奖励。
  • 证据：python verify.py——L03（有界改动）与 L04（验证与评审）由套件客观把关；L01/L02/L05 为学习者自我报告。
  • 提交：每个通过的检查点打印一个确定性的认领码；在 flypython.com 上记入你的账号。这是自我报告的证据，从来不是证书。

文件夹地图

COURSE.md / COURSE_cn.md   本文件（EN / 中文）
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 表单反馈。