dev

/dev — 开发流水线编排器

启动声明（必读 · 不可跳过）

收到 /dev 调用后，第一条回复必须严格按以下格式开头：

Using dev-harness:dev skill — running Step 0 (并行 3 条检测) now.

然后在同一条回复内立即并行调用下面"启动"段的 3 条 Bash 命令。

禁止行为：

• 只回复"收到，按 dev-harness 流程启动..."然后停下等下一轮
• 用抽象总结（"我会先检测环境"）代替实际 Bash 执行
• 只列出要做什么而不真正调用工具

Why：用户输入 /dev 是开始动作，不是请求解说。把"意图声明"绑死到"立即执行"，是 harness engineering 的核心防摆烂手段（参考 superpowers executing-plans skill 的 "Announce at start" 同源设计）。

约束

• 每完成一个阶段/Phase，必须 harness.py update — 续跑的唯一依据
• 不在阶段间停下等用户 — 更新状态后直接继续
• Skill 解析走三层（L1 项目 > L2 用户 > L3 内置）
• 同一 Phase/阶段失败 3 次必须停下报告用户

脚本路径

所有脚本通过 ${CLAUDE_PLUGIN_ROOT} 定位：

bash "${CLAUDE_PLUGIN_ROOT}/scripts/dh-python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/harness.py" <cmd>
bash "${CLAUDE_PLUGIN_ROOT}/scripts/detect-stack.sh"
bash "${CLAUDE_PLUGIN_ROOT}/scripts/dh-python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/skill-resolver.py" <stage>

---

启动

并行执行环境检测：

cat .claude/harness-state.json 2>/dev/null || echo "NO_STATE"
bash "${CLAUDE_PLUGIN_ROOT}/scripts/detect-stack.sh"
bash "${CLAUDE_PLUGIN_ROOT}/scripts/dh-python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/skill-resolver.py" --all

• 有 harness-state.json → 读取 current_stage，续接该阶段
• 无状态 → 询问用户任务名称和类型，判断路线，初始化：

bash "${CLAUDE_PLUGIN_ROOT}/scripts/dh-python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/harness.py" init "任务名" --route C

Skill 解析

对当前阶段运行三层解析：

bash "${CLAUDE_PLUGIN_ROOT}/scripts/dh-python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/skill-resolver.py" <stage_name>

• L1/L2 命中 → 调用 /skill-name
• L3 命中 → 读取插件内置 SKILL.md 执行

Pipeline 推进

每个阶段：

# 开始
bash "${CLAUDE_PLUGIN_ROOT}/scripts/dh-python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/harness.py" update <stage> IN_PROGRESS

# 执行 Skill（根据解析结果）

# 完成
bash "${CLAUDE_PLUGIN_ROOT}/scripts/dh-python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/harness.py" update <stage> DONE

# 直接继续下一个阶段，不停下

---

各阶段

research（路线 B）

产出: .claude/researches/*.md

prd（路线 A/B）

需要多轮对话。产出: .claude/project-design/*-prd.md

plan（路线 A/B/C）

产出: .claude/plans/*.md。等待策略读 pipeline.yml 或 dev-config.yml 的 plan.fallback：

• fallback: wait（默认）— plan 写完停下，明确告诉用户"请 review，说'通过'后我会继续"。等审批
• fallback: auto-approve — plan 写完立即 harness.py update plan DONE 并进入 implement，不等用户。告诉用户已自动通过但不要等回复
• fallback: skip — 跳过整个 plan 阶段（D 路线/修 typo 类极简任务）

无配置时默认 wait。禁止在 wait 模式下用任何形式自作主张进入 implement。

implement

读取 .claude/plans/ 下的计划文档，逐 Phase 执行。

每个 Phase:

1. 按 plan 变更清单修改文件
2. 运行门禁（detect-stack.sh 检测 build/test 命令）
3. 门禁通过 → harness.py update implement IN_PROGRESS --phase N --gate build=pass
4. 继续下一个 Phase

Phase > 3 时，可用 background Agent(isolation: "worktree") 并行执行无依赖的 Phase。

门禁命令来源（优先级）:

1. .claude/dev-config.yml 的 gates 段
2. detect-stack.sh 自动检测

post-implement 并行组（audit + docs + test）

implement 完成后，用 background Agent 同时启动三路：

Agent(name="audit-worker", run_in_background=true):  解析 audit Skill → 执行 → harness.py update audit DONE
Agent(name="docs-worker", run_in_background=true):   解析 docs Skill → 执行 → harness.py update docs DONE
Agent(name="test-worker", run_in_background=true):   解析 test Skill → 执行 → harness.py update test DONE

等待三路全部完成后进入 review。

review

三路联合审查（code-reviewer + security-reviewer + architect）。CRITICAL → 自动修复。

remember

调用 /remember 保存进度。

---

自动续跑

Stop Hook 检查六道防线（上下文/超时/频率/rate limit/死循环），通过则注入续跑指令。你应该尽量自己直接推进，Stop Hook 是兜底。

---

用户交互模板

新任务

检测到项目: {project_name}，技术栈: {stack}
未找到进行中的任务。请告诉我：
1. 任务名称  2. 类型（新功能/bugfix/紧急）  3. 涉及模块

续接

续接任务: {task_name}
当前阶段: implement (Phase 3/4)
继续实现 Phase 3...

完成

全流程完成！
Task: {task_name} | Route: {route} | Stages: {completed}/{total}
Reports: .claude/reports/