# AI 全流程开发实战教程

> 从一句需求到线上验收：用 Claude Code + WSL + Figma MCP + Chrome MCP + 编译型后端，
> 把 AI 变成一支可管理、可验收、可复盘的工程团队。

本文件是给 AI Agent 的机器可读入口。所有路径都相对于本文件所在目录。

## 给 AI 的启动方式

1. 打开 `index.html`，找到“让 AI 直接开工”一节，复制其中的启动提示词。
2. 提示词会指示 AI 下载 `ai-project-kit.zip` 并校验 SHA256。
3. 提示词全文也保存在首页的代码块里；校验值由构建时生成。

## 核心文件

- 首页 / AI 启动提示词: `index.html`
- 项目脚手架（约 53 KB）: `ai-project-kit.zip`
- 完整导读（10 阶段 / 7 门禁）: `导读.html`
- 教程合订本 Word: `AI全流程开发教程-合订本.docx`
- 1 小时培训 PDF: `AI全流程开发-1小时培训.pdf`

## 主线章节

- 00 总览与工作模型: `00-总览与工作模型.html`
- 01 需求调研: `01-需求调研.html`
- 02 UI 设计与设计稿转代码: `02-UI设计与设计稿转代码.html`
- 03 前端开发: `03-前端开发.html`
- 04 后端技术选型: `04-后端技术选型.html`
- 05 开发环境搭建: `05-开发环境搭建.html`
- 06 技术设计: `06-技术设计.html`
- 07 AI 编码与多 Agent 并行开发: `07-AI编码与多Agent并行开发.html`
- 08 质量保证与 Word 验收报告: `08-质量保证与Word验收报告.html`
- 09 部署与发布: `09-部署与发布.html`
- 10 线上验证与运营: `10-线上验证与运营.html`

## 实战与附录

- 11 完整实战：从 0 到 1 做一个任务系统: `11-完整实战-从0到1做一个任务系统.html`
- 12 常见问题与反模式: `12-常见问题与反模式.html`
- Claude Code 使用指南: `Claude-Code使用指南.html`
- 附录 A：Chrome MCP / CDP 实战手册: `附录A-Chrome-MCP-CDP实战手册.html`
- 附录 B：提示词与模板合集: `附录B-提示词与模板合集.html`

## 模板（可读可下载）

- 模板总览: `模板/index.html`
- spec.md: `模板/spec.html`
- user-story-details.md: `模板/user-story-details.html`
- tech-design.md: `模板/tech-design.html`
- CLAUDE.md: `模板/CLAUDE.html`
- agent-brief.md: `模板/agent-brief.html`
- feature-implementation.md: `模板/feature-implementation.html`
- feature-report.md: `模板/feature-report.html`
- deploy-checklist.md: `模板/deploy-checklist.html`
- qa-checklist.md: `模板/qa-checklist.html`
- user-story.csv: `模板/user-story.csv`
- e2e-manifest.json: `模板/e2e-manifest.json`
- Makefile: `模板/Makefile`

## 脚本（可下载）

- 脚本总览: `脚本/index.html`
- update_story_status.py: `脚本/update_story_status.py`
- validate_user_stories.py: `脚本/validate_user_stories.py`
- build_test_report.py: `脚本/build_test_report.py`
- start-chrome-debug.sh: `脚本/start-chrome-debug.sh`
- check-env.sh: `脚本/check-env.sh`

## 约定

- 需求、用户故事、实现报告、E2E 证据都必须落成仓库文件，不能只留在聊天记录里。
- 用户故事 CSV（user-story.csv）是唯一状态源，状态只能通过 `scripts/update_story_status.py` 更新。
- 没有验收标准的需求不进入开发；没有证据的“完成”不算完成。
- 后端优先编译型语言（Go / Java / Rust）；开发环境优先 WSL / Linux。