AI 辅助编程全生命周期实战指南 — 设计文档
体系概述
面向个人开发者的 AI 辅助编程工程化体系。24 篇设计文档覆盖全生命周期。 推荐技术栈：React/Next.js + Node.js + TypeScript + Prisma，移动端 Taro（国内多端）/ React Native + Expo（海外原生）。
新手？ 先看 快速上手指南，两个递进式练习带你掌握完整开发循环。
文档索引
| 编号 | 文档 | 内容 |
|---|---|---|
| 00 | 总体架构 | 架构总图、五要素职责表、设计原则、渐进式采用路径 |
| 01 | CLAUDE.md 设计 | 编写六原则、50-200 行 + @path 引用、.claude/rules/ 路径范围规则、五层分层策略、强调语法 |
| 02 | Skills 技能体系 | 22 个 Skills（含 /product-design 产品设计契约、/features 功能清单维护、/absorb 外部知识吸收），全部已实现 SKILL.md |
| 03 | 子代理体系 | 内置/自定义子代理、权限模式、Agent Teams、调度原则、成本控制 |
| 04 | Hooks 体系 | 5 个 Hook 脚本（含文件行数守卫 + 依赖拦截）、三层保障总览 |
| 05 | MCP 服务体系 | 不超过 5 个原则、P0/P1/P2 分级、MCP vs Skill 边界 |
| 06 | 文档体系 | 最小化策略、依赖白名单、ADR 模板 |
| 07 | 人的操作手册 | 日常操作循环、审查优先级、打断时机、提示词速查 |
| 08 | 运维与持续进化 | 进化闭环、健康检查清单（月度+季度）、故障恢复、版本化管理 |
| 09 | 脚手架设计 | CLI 工具 npx ai-dev-cli（init/check/takeover）、CI 集成、4 级渐进初始化 |
| 10 | 可靠性保障体系 | 影响分析、测试纪律、回归验证、监控兜底、健康度量 |
| 11 | UI 开发策略 | 三阶段工作流、Web/移动端技术栈（含 Taro）、设计参考资源与美化工作流 |
| 12 | 效率最佳实践 | 锚定文件、契约先行、会话规划、成本意识、Prompt 反模式、十条军规 |
| 13 | 上下文管理策略 | 会话管理命令、主动控制策略、子代理保护上下文、退化识别、成本视角 |
| 14 | 技术栈选型指南 | AI 友好度分级、推荐组合、Agent 栈、LLMOps、边缘部署、快速决策树 |
| 15 | Prompt 工程实战 | Prompt 四要素、高频库（8 类场景）、反模式、进阶技巧、个人积累区 |
| 16 | 功能清单体系 | 功能全景视图、开发进度跟踪、测试覆盖关联、/features Skill |
| 17 | API 接口维护体系 | Zod → OpenAPI 自动生成、apiHandler 包装器、Scalar 文档渲染、CI 集成 |
| 18 | Git 工作流 | 原子提交、Conventional Commits、暂存区纪律、分支策略、WIP commit、Git 调试 |
| 19 | 上下文管理执行手册 | 会话 SOP、WIP 模板、Handoff 模板、/checkpoint + /handoff、切换 Checklist |
| 20 | 体系外部进化机制 | 外部知识吸收流程、五种输入源 SOP、/absorb Skill、进化触发提示词库、与 doc-08 集成 |
| 21 | 面向 AI 的知识工程方法论 | 元方法论：质量方程（目标×约束×粒度）、三个失败模式、任务分解、控制单元结构、反馈校准、设计速查 |
| 22 | 项目知识沉淀机制 | 沉淀点设计、调研记录（docs/research/）、问题记录（docs/troubleshooting/）、决策记录增强、检索协议、与 doc-08/doc-20 三角关系 |
| 23 | 产品设计契约 | 产品设计阶段定位、product-spec.md + design-spec.md 协同、与上下游输入输出关系、/product-design Skill |
| — | 变更日志 | 文档体系的修订历史 |
规范执行保障体系（三层防线）
这是本体系区别于四份参考文件的核心设计：
┌──────────────────────────────────────────────────────┐
│ 第一层：Hooks — 实时自动执行 │
│ 每次工具调用自动触发，零人工成本 │
│ 安全防火墙 / 自动格式化 / 文件行数守卫 / 依赖拦截 │
├──────────────────────────────────────────────────────┤
│ 第二层：脚本 check — 定期审计 │
│ 人工或 CI 触发，秒级完成，不需要 AI │
│ 基础设施完整性 / 配置格式 / 禁止依赖 / .env 安全 │
├──────────────────────────────────────────────────────┤
│ 第三层：Skill /check — AI 深度体检 │
│ 人工触发，需要 AI 理解代码语义 │
│ CLAUDE.md 健康度 / 代码规范语义 / 测试覆盖 / 架构一致 │
└──────────────────────────────────────────────────────┘核心设计决策
- 实操优先 — 每个模块都有可直接使用的配置和脚本，不是纯概念文档
- 个人场景精简 — 去掉了团队协作才需要的 specs/、checkpoints/，保留可选的自定义 agents
- 渐进式采用 — 从 Level 0（5分钟）到 Level 3，按需逐步加码
- 三层规范保障 — Hooks 实时拦截 + 脚本定期审计 + AI 深度体检
- 全生命周期覆盖 — init 建立、check 维护、takeover 接管，不是一次性工具
- 四份参考文件精华融合：
- V3.0 手册 → 骨架（OODA、分层配置、生命周期阶段）
- 协作手册 → 编排逻辑（五要素表、五大原则、反模式）
- UI 手册 → 实操范式（多轮对话、MCP/Skill 分工）
- 防控指南 → 质量防线（三会话隔离、对抗性测试、每日清单）
快速开始
推荐直接使用 Skills：将 .claude/skills/ 中所需的 Skill 复制到你的项目即可。
CLI 工具
npx ai-dev-cli init仍可用但已冻结维护（2026-03），推荐直接使用 Skills。