规格工作流指南

要解决的问题

当需求里出现“新页面、新系统、重构、跨模块协作”时，直接写代码容易把模糊验收、边界遗漏和返工一起带进实现。这个技能把先澄清问题再动手的规则显式化：先判断是否值得走完整规格流程，再在 requirements.md、design.md、tasks.md 中留下可追溯的产物，减少“我以为你要的是 A，结果实现成了 B”的偏差。

技能如何工作

它要求 agent 按阶段推进：

• 需求：重述问题与范围，写用户故事，并用 EARS 风格写出可验收的标准，同时明确约束和非目标。
• 设计：描述架构、模块边界、技术取舍，必要时补充数据模型、API、安全与测试策略。
• 任务：把设计拆成具体、可审查的任务，并回链到对应需求。
• 执行：仅在用户确认任务计划后开始实现，保持任务状态和“变更 -> 任务 -> 需求”的追踪关系。

适用边界

它适合中大型、验收边界模糊、需要规划确认的改动；不适合范围明确的小修小补、单文件文档更新、简单配置变更或用户已给出精确实现指令的小重构。遇到页面或视觉决策时，应尽早引入 UI 设计相关技能；数据模型复杂时，也要切换到专门的数据建模流程。