规格驱动开发

解决的核心问题

开发者常面临三类典型困境：需求模糊导致返工频繁、长周期项目上下文信息逐步丢失、阶段验收缺失使得问题累积至交付后期才暴露。这些问题在多人协作或需求易变的场景中尤为突出，传统线性开发模式难以有效应对。

核心工作逻辑

强制分阶段确认机制

技能通过四个关键检查点控制流程节奏：

1. 需求讨论阶段：必须通过交互式提问锁定用户真实意图，生成结构化需求文档
2. 阶段规划阶段：每个Phase的PLAN.md需经用户确认才能执行
3. 执行过程阶段：支持wave groups并行执行独立计划，但关键决策点需暂停确认
4. 验证阶段：采用must_haves目标回溯验证，强制检查交付物与初始目标的匹配度

结构化文档体系

通过.planning/目录维护全周期文档：

• PROJECT.md定义项目愿景与约束
• ROADMAP.md分解阶段目标与验收标准
• STATE.md记录跨会话决策与进展
• PLAN.md包含可执行任务清单与验证规则

上下文预算管理

针对长上下文场景设计三级控制策略：

• 读取深度控制：根据context_window设置动态调整文件加载深度
• 状态监控机制：实时跟踪上下文使用率（PEAK/GOOD/DEGRADING/POOR）
• 阶段重置规则：Phase切换时仅保留STATE.md和新PLAN.md，避免信息过载

适用边界与限制

该技能更适合需求不明确或易变的中大型项目，特别是需要多角色协作或技术决策的场景。对于快速原型开发或需求高度确定的小型工具类项目，其严格的检查点机制可能增加沟通成本。使用时需注意：

• 必须保持用户参与度，所有检查点都依赖人工确认
• 文档维护需要持续投入，建议至少每Phase更新一次STATE.md
• 验证机制依赖现有测试框架，需配合自动化测试工具使用

通过这种结构化方法，技能将模糊的开发需求转化为可验证的执行路径，同时保持足够的灵活性来适应需求变化。