技能介绍

要解决的问题

把复杂功能直接丢给编码模型，最常见的失败模式是「边写边想」：需求没有冻结，测试没有先写，领域边界没有划分，模型在一次长对话里同时扮演架构师、测试工程师和实现者。结果是返工、验收条件遗漏，以及越写越乱的文件结构。这个技能针对的正是流程问题——它不修改 Claude Code 本身，而是通过 MoAI-ADK 把规范优先、TDD、DDD 和质量门控的约束加载进开发循环。

工作方式

核心入口是 /moai run SPEC-XXX，靠三条机制支撑整个流程：

会话持久化：progress.md 记录已完成的阶段，中断后重跑可自动续上，不必人工回忆上次停在哪一步。
失败清单：运行开始时把验收条件全部注册为待办，只有实现之后才标记完成，让「测试通过」成为可核查的状态而非口头承诺。
先搭骨架：实现前先创建空文件桩，避免模型在空目录中随意扩张、把结构熵拖到后期。

适用边界

前置条件为 Claude Code、MoAI-ADK CLI、Git 和本地 shell。上游资料明确要求先安装 Git for Windows，并给出 8.3 文件名生成的变通方案（需要管理员权限），可见它主要面向 Windows 本地环境，macOS / Linux 用户需自行确认兼容性。它提供的是流程约束，不负责领域建模或规范撰写——SPEC-XXX 本身的质量仍取决于使用者。