挑战课程 · 任一编码 Agent + uv

打包并发布一个 CLI

一门挑战课程——把 Markdown 索引脚本变成可安装的包:pyproject 元数据、console 入口、构建出的 wheel 与 sdist 由契约套件验证——包括在全新虚拟环境里真实安装并运行。

进阶5 个挑战1–2 hours完成基础路线者Pro(订阅)课程徽章:发布了 CLI审核于 2026-09-12中文 + EnglishPro

把这一句话粘贴给你的 Agent,即可开始:

Read https://flypython.com/skills/flypython/SKILL.md and start the FlyPython course `dt-packaging`.

需要一个能执行命令并联网的编码 Agent(纯网页聊天 AI 做不了)。Agent 会用一次性授权链接为你授权、 自己取回课程文件——你不需要下载任何东西。 还没装 FlyPython Skill选你工具对应的工具课 →

概览

学到什么一个打包好的 CLI 工具:可安装的 wheel + sdist、可用的命令行入口、诚实的元数据——端到端验证。
适合谁完成基础路线者 · PATH 中有 Python 3.11 或更新版本
时长与费用1–2 hours · Pro 订阅

题目

五课,每课一个检查点

每课都以一条要运行的命令和必须脱稿回答的问题收尾。English syllabus →

01

脚本不是包

动手前先看 `pip install .` 到底需要什么。

检查点 + 预期证据
02

pyproject 就是契约

名称、版本、入口——工具必须写对的字段。

检查点 + 预期证据
03

构建它

产出契约套件会检查的 wheel 与 sdist。

检查点 + 预期证据
04

证明入口能跑

装好的命令行入口必须真能执行——不只是存在。

检查点 + 预期证据
05

打包你自己的东西

把打包流程迁移到你自己的脚本上。

检查点 + 预期证据

开始

Pro 课程——订阅有效即可开始解题

Pro用 Agent 掌握 Python 开发工具链

属于「用 Agent 掌握 Python 开发工具链」路线

本课程的文件同样经上方入口语句到达——订阅生效后,授权链接会自动附带 pro:files 权限。只有订阅有效期间才能记录认领。

永久免费

免费课程不会缩水

基础路线与开源仓库里的每门社区课程永远免费,六门 Agent 工具课也全部免费——Pro 资助付费路线的建设,不会把公共资源收进收费墙。

场景皮肤

同样的技能,你熟悉的领域

三个皮肤走同一份代码和同一套测试。开课前选一个最贴近你工作的。

scenario/cli-tool/scenario/docs

mdindex——Markdown 索引工具

一个给 Markdown 文档建索引的脚本——要变成能在全新虚拟环境里安装运行的命令。

验证

“完成”由什么决定

契约套件构建产物并把 wheel 装进全新虚拟环境:wheel + sdist 存在、入口已声明、安装后的命令可执行。

python verify.py  # 在课程文件夹运行:打印检查点状态 + 认领码

把这套方法带回你的项目

第 5 课把工作流——而不是代码——迁移到你真正拥有的一个脚本上:三行任务契约、一个从红变绿的新测试、 一份写明测试不能证明什么的记录。同一个循环在AI Coding 工作方法指南中有完整描述, 并可由可运行示例练习。

认领你的证据

检查点通过后,python verify.py 会打印确定性认领码。 完成授权的 Agent 会替你一次性批量提交;手动提交则粘贴到进度页—— 每个检查点 10 分,集齐五个获得 发布了 CLI 课程徽章。认领码是自我声明的证据,不是证书。

验证不能证明什么

通过课程套件只证明被锚定的行为在测试输入上成立——不等于明天的数据也对,不等于生产性能达标, 在你为自己的项目写下契约之前,也不代表你项目里的任何事。仓库测试是证据,不是你的结果。