开发工作流 — 结构化开发冲刺

一个六阶段的开发流程，将模糊的想法转化为可交付的代码。每个阶段都有明确的角色、定义清晰的输出，并自然衔接至下一阶段。各阶段按顺序执行；若上下文已明确，也可跳过前置阶段。

阶段

使用方式

完整冲刺（推荐用于新功能）

# 从零开始
"我想构建 X" → 执行全部 6 个阶段

# 或直接向我提出请求：
"在 [功能描述] 上运行 dev-workflow"

我将逐阶段推进，为每个阶段启动一个专注的子智能体（subagent），并为其配置恰当的模型与提示词（prompt）。

部分冲刺

当已有充分上下文时，可跳过部分阶段：

• "跳过 Think，我已有 DESIGN.md" → 从 Plan 阶段开始
• "仅对此分支执行 Review 和 Ship" → 运行 Review → Test → Ship
• "我需要一次设计评审" → 仅运行第 2 阶段（Plan）

单阶段执行

任一阶段均可独立运行：

• /think — 重构问题视角、挑战既有假设、撰写 DESIGN.md
• /plan — 制定架构、数据流、测试策略，并撰写 PLAN.md
• /build — 基于 PLAN.md 实现功能
• /review — 执行代码评审，并对明显问题自动修复
• /test — 浏览器端测试、回归测试、生成缺陷报告
• /ship — 同步代码、运行测试、推送提交、创建 PR

各阶段详情

阶段 1：Think（YC Office Hours）

目标：在编写代码前，重新定义问题本身。

启动一个子智能体（Sonnet），使用 references/prompts.md 中的 Think 提示词。该智能体会：

1. 围绕真实痛点（而非功能需求）提出 6 个强制性问题
2. 挑战原始表述——例如：“你说的是 X，但实际需要的是 Y”
3. 提出 3 种实现方案，并预估各自投入成本
4. 推荐最窄可行切入点（narrowest wedge），确保明日即可交付
5. 撰写 DESIGN.md，凝练产品愿景

核心原则：倾听用户的“痛点”，而非其提出的“功能需求”。用户说“每日简报应用”，实际想要的是“个人首席助理 AI”。

阶段 2：Plan（Eng Manager）

目标：在编码前锁定系统架构。

启动一个子智能体（Sonnet），使用 Plan 提示词。它读取 DESIGN.md 并生成 PLAN.md，内容包括：

1. 架构图（ASCII 格式）
2. 数据流向与状态机
3. 文件结构与模块边界
4. 测试策略与典型故障模式
5. 里程碑拆解（优先交付什么）

核心原则：计划未获批准前，禁止编写任何代码。对范围蔓延须进行严苛质疑与控制。

阶段 3：Build（Implementer）

目标：依据 PLAN.md 编写代码。

可在主会话中执行，或启动子智能体（简单功能用 Haiku，复杂功能用 Sonnet）。该智能体读取 PLAN.md 并执行：

1. 按顺序实现各里程碑
2. 伴随代码同步编写测试（目标覆盖率 >80%）
3. 以里程碑为单位进行原子化提交
4. 在 PLAN.md 中更新实施过程中的关键备注

核心原则：严格遵循计划。若发现计划有误，须先更新 PLAN.md，再开展编码。

阶段 4：Review（Staff Engineer）

目标：发现能通过 CI 但会在生产环境崩溃的问题。

启动一个子智能体（Sonnet），使用 Review 提示词。它将：

1. 比对当前变更与 main/develop 分支的差异
2. 识别逻辑错误、竞态条件、边界情况等隐患
3. 自动修复明显问题（如格式、未使用导入项等）
4. 标记完整性缺失点与安全风险
5. 生成结构化评审报告

核心原则：保持偏执心态。假定这段代码明日就会遭遇各种边界场景。

阶段 5：Test（QA Lead）

目标：像真实用户一样测试，而非像开发者那样测试。

启动一个子智能体（Sonnet），使用 Test 提示词。它将：

1. 在真实浏览器中打开应用（使用 browser 工具）
2. 遍历所有用户操作路径
3. 覆盖边界情况与错误状态
4. 以可复现步骤形式报告缺陷
5. 自动修复问题并生成回归测试用例

核心原则：用户不读代码。请点按钮，主动破坏系统。

阶段 6：Ship（Release Engineer）

目标：一条命令直达生产环境。

在主会话中执行：

1. 与远程仓库同步（git pull/rebase）
2. 运行完整测试套件
3. 审核测试覆盖率
4. 推送代码并创建 PR
5. 更新项目文档

核心原则：若测试失败，则不得发布。必须先修复问题。

模型选型

并行冲刺

对于大型项目，可在不同分支上并行运行多个冲刺：

1. 为每个冲刺创建独立的功能分支
2. 为每一分支启动专属子智能体
3. 各子智能体完全隔离运行
4. 按顺序执行评审与合并

实际可支持的最大并行数：3–5 个冲刺（受限于上下文管理能力）。

输出文件

所有阶段输出均位于项目根目录：

• DESIGN.md — Think 阶段产出的产品愿景
• PLAN.md — Plan 阶段产出的架构与里程碑规划
• Review 报告输出至 stdout（保留在对话记录中）
• Test 报告输出至 stdout

若无需长期保留，可在 Ship 完成后清理相关输出文件。