# Demo 项目索引

本目录存放教程配套的**可运行 demo**。每个 demo 自包含（自带 README + 依赖 + 源码），可独立 clone 运行，对应教程里的某个核心概念。

## Demo 列表

| Demo | 对应教程 | 说明 | 运行 |
|---|---|---|---|
| [ai-test-frame](./ai-test-frame/) | [《AI 自动化测试：方法论与实践》](../assets/ref/AI自动化测试-方法论与实践.html) §8 | 最小可运行的 AI 自动化测试框架（数据驱动 + 注册中心 + 软断言 + 录制转生成思想） | `cd ai-test-frame && python main.py` |
| [rag-service](./rag-service/) | [阶段 3 · 基础设施](../pages/stage3.html) §2 | AI RAG 端到端 demo：L1 纯向量 → L2 +FTS 混合（RRF 融合）→ L3 +CrossEncoder 重排 + 自动化评估（recall@k / MRR） | `cd rag-service && python main.py` |
| [ai-metrics](./ai-metrics/) | [阶段 5 · 推广与度量](../pages/stage5.html) | AI 代码占比度量，已升级**四维度**（`--dim code/quality/cost/agent`：代码三层识别 + 风格学反伪造 + 提效同比 Excel 模板） | `cd ai-metrics && python main.py` |
| [report-templates](./report-templates/) | [《汇报材料 AI 生成指南》](../assets/ref/汇报材料-AI生成指南.html) | 5 类汇报 prompt 模板包（PPT/计划书/周报/总结/度量）+ ppt-master 渲染可编辑 PPT | 复制 prompt 填数据 → AI 生成 |
| [role-handbooks](./role-handbooks/) | [《角色操作手册》](../assets/ref/角色操作手册.html) | 5 份角色手册（开发/测试/组长/产品/运营），各含定位+任务+怎么做+工具+清单+坑 | 各级人员拿自己那份照做 |
| [claude-skills](./claude-skills/) | [阶段 4 闭环](../pages/stage4.html) / [阶段 6 沉淀](../pages/stage6.html) | Claude Code skill 集合（团队 Skill 仓库）：7 个 skill（devflow 编排型 / sql-query / crud-gen / brand-guidelines / perf-diagnosis / session-memory / code-review）+ 13 份团队规范 | 复制 skills/ + rules/ 到 .claude/ |
| [agent-teams](./agent-teams/) | [阶段 5 推广](../pages/stage5.html) | 多 Agent 并行编排 skill：6 步流程（检测→蓝图→确认→并行→验收→交付）拉起团队做完复杂任务，含 Anthropic 五模式 + cookbooks 补充、Swarm/code-review 两个 example | `/agent-teams <任务>` 或对话触发 |
| [handover-templates](./handover-templates/) | [阶段 4 闭环](../pages/stage4.html) / [阶段 5 推广](../pages/stage5.html) | 团队交接协作模板：开发↔测试 / 前后端 / 跨部门（产品↔研发见产品手册） | 按场景挑模板落进工作流 |
| [review-checklists](./review-checklists/) | [阶段 4 闭环](../pages/stage4.html) / [阶段 5 推广](../pages/stage5.html) | 落地验收清单（试点 / 推广）+ 代码审查 checklist（给人看） | 试点结项 / 合并 AI 产出前核对 |
| [fde-fieldkit](./fde-fieldkit/) | [番外·FDE篇](../pages/fde.html) | FDE 现场四件套：客户需求探索画布 + PoC→生产清单 + 能力自评矩阵 + 客户干系人地图（番外配套，复用技术武器库 demos） | 见 [fde-fieldkit/README](./fde-fieldkit/README.md) |

> 后续 demo（代码知识图谱等）按下方规范追加。

## 新增 Demo 规范

1. 在本目录下新建子目录，命名 **kebab-case**（如 `rag-service`、`code-graph`）
2. 每个 demo **自包含**：
   - `README.md`：运行步骤 + 架构说明 + 思想映射（对应教程哪个概念）
   - `requirements.txt`：独立依赖（不污染教程主站）
   - 源码 + 数据 + 必要的被测对象（让读者 clone 即能跑）
3. 在上方「Demo 列表」表追加一行
4. 教程对应章节加一句指向该 demo 的链接
5. **运行产物分离**：生成的数据/报告/截图等放 demo 内的 `workspace/`（加 `.gitignore` 忽略），与源码分开；自带的被测对象/示例数据保留原位

原则：**任何 demo 都应开箱即跑**——自带被测对象/示例数据，不依赖读者的私有环境。