Harness Setup 是一个面向代码仓库的技能,用于搭建或扩展仓库 harness。它的核心思路是“先理解、再建设”:不预先做路由判断,而是先了解仓库的语言、框架、约束、测试与构建系统,盘点已有与缺失的 harness 工件,再决定每个工作项是否适用以及走哪条子路径。
使用方式
技能开始时先检查参数以确定模式:传入 interactive 时,每完成一节暂停供审阅;传入 one-shot 时,一次性生成全部章节,并在每个文件前附加验证警告;未传参数时会询问开发者选择哪种模式。选定后全程沿用,不再重复询问。
执行流程
第一步为变更前后探测:加载 before-after-probe 参考文件,在做出任何改动前记录当前代理行为。
第二步为理解仓库:可先运行 bash .agents/skills/harness-setup/scripts/scan.sh 快速获取工件概览;随后依次加载并执行 discovery 与 inventory 两个提示词,采集关于仓库技术栈、约束、测试、构建系统以及现有 harness 工件、缺失项与错位情况的输出。分析提示词需独立运行两遍,第二遍不参考第一遍结果,分歧解决后再继续。
第三步为制定计划:根据发现与盘点结果确定适用的工作项及子路径,包括 M0(README 范围与准确性,始终适用)、M1(CLAUDE.md shim 与 .claude/skills/ 符号链接,仅当 Claude Code 是目标时)、M2(AGENTS.md 与 INVARIANTS.md)、M3(模块级 AGENTS.md)、M4(技能,始终适用并询问是否需要新技能,同时整合非规范位置)、M5(Makefile)、M6(docs/ 下架构、决策、安装、测试、贡献等文档)。M1 设有门槛:若已存在 CLAUDE.md 或 .claude/ 目录则执行;否则询问开发者是否使用 Claude Code,拒绝则整体跳过并记录决定。执行顺序为 M0 → M2 → M1 → M3 → M4 → M5 → M6,计划在改动前呈现确认。
第四步为执行:加载 bootstrap 参考文件获取共享约定,按顺序处理各工作项——内容良好的工件只做必要扩展,位置错误的迁移到规范位置后删除原文件,缺失的从参考文件新建;删除前须确认内容已保留或不再需要。
第五步为验证:加载 validation 参考文件执行两个提示词,并再次运行变更前后探测。
第六步为评审:加载 review-panel 参考文件,由四名评审者各自独立阅读,不沿用前序上下文,发现的问题直接呈现而不写入文件。
适用场景与限制
适用于需要为 AI 编程代理建立或完善仓库级配置文件、技能目录、文档与构建入口的项目,尤其适合多工具(Claude Code、Copilot、Cursor、Codex)共存的仓库。限制方面:M1 仅针对 Claude Code,其他工具原生读取 AGENTS.md 与 .agents/skills/,无需该兼容层;计划需人工确认;多轮分析需处理分歧。关于收费、价格、平台支持等信息,资料暂未提供。