WslLoopBuild/loop-build/QUICKSTART.md

loop-build 快速开始（5 分钟上手）

这是一份“少解释、直接跑”的版本。

一、最短路径（照抄即可）

1. 初始化：

./.loop-build/scripts/init.sh

2. 让 Codex 生成计划，并写入：

./.loop-build/state/current_task.json

3. 审批计划：

./.loop-build/scripts/run_task.sh APPROVE_PLAN

4. 执行一步：

./.loop-build/scripts/run_task.sh step

5. 通过后放行下一步：

./.loop-build/scripts/run_task.sh APPROVE_NEXT

6. 重复第 4、5 步直到完成。

---

二、你只需要记住这 6 条命令

./.loop-build/scripts/init.sh
./.loop-build/scripts/run_task.sh status
./.loop-build/scripts/run_task.sh APPROVE_PLAN
./.loop-build/scripts/run_task.sh step
./.loop-build/scripts/run_task.sh APPROVE_NEXT
APPROVE=1 ./.loop-build/scripts/verify.sh unit

---

三、三种常见“下一步”

计划不合适：

./.loop-build/scripts/run_task.sh REVISE_PLAN "写你要调整的点"

任务终止：

./.loop-build/scripts/run_task.sh CANCEL_TASK

看当前卡在哪：

./.loop-build/scripts/run_task.sh status

---

四、避免踩坑（精简版）

• 每次 step 只改一小块，别贪大。
• step 结束后先 APPROVE_NEXT，再继续下一步。
• 手动跑验证时必须加 APPROVE=1。
• 遇到策略拦截先看提示，不要直接放开高风险命令。

---

五、给 Codex 的最短提示词

请按 .loop-build/prompts/planner.md 生成严格 JSON 计划（3~7步），并写入 .loop-build/state/current_task.json。
目标：<goal>
约束：<constraints>
上下文：<repo_context_hint>
现状：<current_state_summary>