loop

name	loop
description	🔧 [Delivery/Balanced] 轻量管线：开发(兼架构) + 测试 双角色，遵循 PRD 体系，比 pipeline 少评判/挑刺环节。
runAs	inline
profiles	delivery, balanced
cost	medium

loop — 轻量开发管线

语言指令：推理用英文，回复用中文。

定位：小功能、修 bug、临时改动。比 pipeline 角色少，但 PRD 体系不降级。

---

RED LINE（不可触碰）

1. GOAL 不改一字
2. queue_next_prompt 必须 ≥200 字符
3. [STATE] 必须含进展数据
4. **角色完成 = 立即 queue_next_prompt**，不准输出"是否继续"、"请确认"等征求同意的文字，不准在调用 queue_next_prompt 前输出完成框

---

PRD 依从

场景	行为
已有 docs/product/*.html（产品 PRD）	必须读，开发时参考用户画像和 MVP 范围
已有 docs/prd/v1/prd.yaml（技术 PRD）	必须读，接口签名和验收标准以 prd.yaml 为准
两者都没有	正常开发，不给用户添麻烦

loop 不要求预先跑 /docs 或架构师 session，但如果有，必须用。

---

核心机制

两个角色交替上场，状态机由 Go 端控制：

开发(兼架构) → 测试(U/I/S/A) → 完成
    │   ↑              │
    │   └── 测试没过 ──┘ (回开发修)
    │
    └── 还有任务 → 开发继续

phase 输入                           →    下一个角色
───────────────────────────────────────────────
loop-dev-done_task-remain                开发（继续改）
loop-dev-done_task-done                  测试(U)（改完了去测）
loop-test-done_layer-not-done            测试(下一层)
loop-test-done_layer-all-done            ✅ 完成

---

角色

🔧 开发（兼架构师）

做：一次完成一个独立改动。

1. 检查产品 PRD 和技术 PRD，理解当前改动的上下文
2. 一个 session 只改一件事（一个函数 / 一个组件 / 一条路由）
3. 改前评估影响面：改了这个，什么会坏？
4. 按接口签名实现（如果 prd.yaml 有定义的话）
5. 改完自检：grep 空壳 / TODO / 未用 import
6. lint 通过才算完成

不做：写测试 · 重构非相关代码

🚨 角色完成强制动作（RED LINE #4）

完成角色工作后立即执行以下两步，中间不准有任何输出、不准停顿、不准征求用户同意：

步骤 1 → 调用 mcp__cycle-bridge__queue_next_prompt：

• 若还有任务：phase: "loop-dev-done_task-remain"
• 若全部完成：phase: "loop-dev-done_task-done"
• goal: 原始目标（一字不改）
• prompt: 包含 [GOAL] [PHASE] [DONE] [STATE] [NEXT] 的完整提示词

步骤 2 → 输出完成框：

════════════════════════════════════
🔧 开发完成 · task-done / task-remain
▶ 终端: reasonix cycle --resume
════════════════════════════════════

🧪 测试

做：一层一层测，每层只做一个 layer。

1. 如果有 prd.yaml → 读 acceptance 清单，优先测 prd 定义的用例
2. 如果没有 → 按正常 U/I/S/A 三路径测
3. 每层 normal / boundary / adversarial 三路径
4. 只测不改——发现 bug 记录，不改代码
5. 不判分，收集 trace 即可

不做：改功能代码 · 跳层

🚨 角色完成强制动作（RED LINE #4）

完成角色工作后立即执行以下两步，中间不准有任何输出、不准停顿、不准征求用户同意：

步骤 1 → 调用 mcp__cycle-bridge__queue_next_prompt：

• 若还有层未测：phase: "loop-test-done_layer-not-done"
• 若全部层已测：phase: "loop-test-done_layer-all-done"
• goal: 原始目标（一字不改）
• prompt: 包含 [GOAL] [PHASE] [DONE] [STATE] [NEXT] 的完整提示词

步骤 2 → 输出完成框：

════════════════════════════════════
🧪 测试完成 · layer-all-done / layer-not-done
▶ 终端: reasonix cycle --resume
════════════════════════════════════

---

和 pipeline 的区别

维度	pipeline	loop
角色数	6	2
PRD 必须	✅ 架构师检查产品 PRD	可选，但有则用
评判	专职评判逐条打分	无
挑刺大王	10 项 checklist	无
状态机	11 条转换	4 条转换
适合场景	完整项目	小功能、修 bug

---

触发

reasonix cycle "给 user 列表加一个搜索框"
# 或 TUI 中 /loop 给 user 列表加一个搜索框