教学版（课堂用）

这是 Agent 工坊的教学版：还没有网页界面，用来上课。课上用 AI 编程工具打开项目，让它先讲清楚项目里有什么，再带着一步步走完整个流程，看清每一步是怎么实现的。

课堂上怎么用

1. 下载下面的学生包 agent-workshop-teaching.zip，解压。

2. 用 Codex、Claude Code、Kimi Code、pi 这类能读写本地文件、能运行命令的 AI 编程工具打开解压出来的文件夹。

3. 对它说：

   请先全局阅读这个项目，告诉我里面都有什么，然后按《使用引导.md》带我一步步做，每一步做完停下来等我说继续。
   

4. AI 会按这个顺序带你走：介绍项目 → 准备环境 → 你自己在 .env 里填 API Key（推荐 DeepSeek；用 GPT 也可以，OpenAI 官方或 OpenAI 格式的中转都行；不要把 Key 发进聊天）→ 出方案 → 回答待确认问题 → 写代码骨架 → 验收。

命令都由 AI 在终端里运行，不用双击启动文件，也就不会遇到 macOS「无法打开」的拦截。

里面有什么

位置	是什么
AGENTS.md / CLAUDE.md	给 AI 的课堂说明：怎么介绍项目、每一步怎么走、哪些事不能做
BLUEPRINT.md	五步推导：需求拆解 → 领域建模 → 组件选型 → 架构设计 → 代码生成
s01–s17	17 个 Harness 组件，每个都有说明和能运行的 code.py
blueprint/	推导引擎（Python）：拆需求、按规则选组件、出方案、审稿、检查项目
使用引导.md	产品循环的完整流程，AI 按它一步步做
scaffold/、skills/	生产骨架模板和领域技能

熟悉之后想直接在网页上用，换成网页版。

---

更新于 2026-10-31