harnesslisted
Install: claude install-skill hanzhangzzz/agent-skills-zh
# /harness
**Harness Engineering 最小实践。** 用三条约束带(Inspector、Worker、Reviewer)将 AI 的创造力约束在正确的轨道上,通过 TODO.md 共享看板驱动持续改进。灵感来自 Harness Engineering 方法论:用轻量但确定性的流程框架,让 AI Agent 从"自由发挥"变成"可预测地交付高质量成果"。
## 触发条件
### 即时执行
- 用户输入 `/harness` — 完整循环(Inspector + Worker+Reviewer loop)
- 用户输入 `/harness inspect` — 只运行 Inspector
- 用户输入 `/harness work` — 只运行 Worker+Reviewer 一次
- 用户输入 `/harness loop` — 持续运行 Worker+Reviewer 直到没有可做的任务
用户可以在命令后附带自然语言指令,作为本轮循环的额外上下文。例如:
- `/harness 这次重点关注静默数据丢失问题`
- `/harness work 先修 P0 的环境变量检测`
- `/harness inspect 只校准当前骨架目标,不执行 Worker`
### 定时调度(cron)
使用 Claude Code 内置 CronCreate/CronDelete/CronList 工具,天然 session 隔离——不同 session 的 cron 互不影响。
| 命令 | 说明 |
|------|------|
| `/harness cron "*/30 * * * *"` | 每 30 分钟跑一次 full cycle |
| `/harness cron "*/30 * * * *" inspect` | 每 30 分钟只跑 Inspector |
| `/harness cron "0 */2 * * *" work` | 每 2 小时跑一次 Worker+Reviewer |
| `/harness cron "*/15 * * * *" loop` | 每 15 分钟持续消化任务 |
| `/harness cron list` | 查看当前 session 所有 harness cron |
| `/harness cron stop <job_id>` | 删除指定 cron |
| `/harness cron stop` | 删除当前 session 所有 harness cron(交互确认后逐个删除) |
**限制说明:**
- Cron job 仅在当前 Claude Code session 存活期间有效,关闭终端后失效
- Recurring job 7 天后自动过期
- 只在 REPL idle 时触发,不会打断正在进行的对话
## 三角色协议
### 核心原则:验证产出
**每个角色都必须验证自己的产出,不能只"做完了"就交差。**
- Inspector:产出任务后,检查任务描述是否足够清晰、hint 是否可操作
- Worker:修完代码后,按项目文档(`AGENTS.md` / `CLAUDE.md` / `TODO.md` / README 等)定义的验证命令执行相关检查;如果项目定义了端到端或真实流程验证,必须执行并记录结果
- Reviewer:审查时,确认 Worker 已执行与本次改动相关的验证命令;如果项目定义了端到端或真实流程验证且改动