SuperAPI AI 工具集

harness-init

智能体与模型

查看项目

更新于 10-15 16:51

技能介绍

harness-init 用于把 Harness Engineering 控制循环安装到当前项目,使 /harness 系列(harness-plan、harness-loop、harness-rules-update)能够驱动自主冲刺(sprint)开发。每个项目运行一次,重复运行会协调已有配置。

用途与前置:需在 git 仓库内运行,需 jq(所有钩子依赖它,Claude Code 钩子经 stdin 接收 JSON 并由脚本用 jq 解析)。若 .harness/_config.yml 已存在则进入重配置模式。共享规则文件 docs/coding-rules.md、docs/review_rules.md、docs/issue-to-pr-workflow.md 缺失时会警告但不阻塞,由 /spec-rules-init 与 /spec-workflow-init 生成。

主要能力:环境听证六轮收集项目类型、生成器后端(claude / codex_cli / codex_cmux)、评估工具、钩子级别、跟踪器与自动停止限制及成本上限、MCP 允许列表,写入 .harness/_config.yml;复制模板到 .harness/templates/;渲染 Planner/Generator/Evaluator 代理定义到 .claude/agents/(Codex 后端或已有 .codex/ 时另生成 .codex/agents/*.toml 并打补丁 config.toml);生成钩子与辅助脚本到 .harness/scripts/(如 progress-append.sh、stop-guard.sh、tier-a-guard.sh、mcp-allowlist.sh、codex-cli-dispatch.sh 等);Codex 后端时部署 .codex/hooks/ 脚本并启用 codex_hooks 特性。

模式:重配置(合并)会按最新模板重渲染生成物,手改会被覆盖,需先 git commit 或用重新初始化并备份 .harness/;配置仅更新听证涉及的键,运行时状态(_state.json / progress.md / metrics.jsonl)在合并模式下不动。完成后建议退出 Claude Code,用 claude --resume 重开仓库并运行 /harness-plan。

限制:非 git 仓库或缺少 jq 会报错停止,不生成部分内容;Codex CLI 通过 codex --version 检测,缺失时移除相应选项并提示 npm install -g @openai/codex。其余细节暂未提供。