技能介绍

要解决什么问题

复杂功能往往卡在「需求还没写清就开始写代码」，或「计划有了却要靠长会话手工逐项实现」。goal-loop 把从 JTBD 到可提交增量拆成三条可路由的阶段，并在 Phase 2/3 提供 Ralph 式无头循环，让规划与构建在清空上下文的前提下按文件状态推进。

如何工作

技能通过触发词与项目目录状态共同决定入口：

Phase 1（当前会话）：按 brainstorming 流程把待完成工作拆成主题，在 specs/ 下写规格；在用户批准前不得写实现代码或搭骨架。
Phase 2：产出 IMPLEMENTATION_PLAN.md（细粒度任务）。默认在当前会话走 @phases/writing-plans.md；备选 ./loop.sh plan，仅做差距分析与计划迭代，不实现代码。
Phase 3：默认 ./loop.sh build，每轮选一个任务 → 实现 → 按 AGENTS.md 跑测试（反压）→ 更新计划 → git commit/push → 退出并清空上下文。

Phase 1 完成后会自动做首次设置：基础目录、loop.sh / clean-state.sh、从 build/package.json 填充测试命令的 AGENTS.md。Phase 1→2、Phase 2→3 过渡时会明确要求你在「交互式计划 / Ralph plan」与「无头 build / 当前窗口手工实现」之间做选择。

边界与安全

./loop.sh plan 与 ./loop.sh build 以 claude --dangerously-skip-permissions 运行，沙箱是主要安全边界；勿在含生产凭据或共享分支的环境裸跑。
触发词与文件状态冲突时（例如已有 specs/ 仍说「探索需求」），技能会先与你确认是补充探索还是进入下一阶段。
计划文件按设计可丢弃：出错可删 IMPLEMENTATION_PLAN.md 后重跑 ./loop.sh plan；循环可用 Ctrl+C 停止，未提交变更可用 git reset --hard 回滚。