1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | harness-engineering-github-awesome-copilot |
| 作者/维护者 | baskduf(提交者),归属合集仓库 github/awesome-copilot |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/harness-engineering |
| 许可证 | MIT(继承合集仓库许可证,来自 GitHub API) |
| GitHub Stars | 合集仓库整体 39,445(来自 GitHub API);该数字属整个合集,不代表本技能自身热度 |
| Forks | 合集仓库整体 5,013(来自 GitHub API) |
| 最新版本 | 无独立版本号;技能文件自 2026-06-16 加入后未再变更(来自 GitHub API commits) |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill harness-engineering,或复制 skills/harness-engineering/ 整个文件夹到目标 agent 的 skills 目录 |
2. 功能介绍与亮点
该技能引导 agent 把“重复出现的编码失误”转化为仓库级的持久化制品,核心框架是一句公式:Harness = 指令 + 约束 + 反馈 + 记忆 + 评估 + 治理。它不是一次性建议,而是一套六步“采纳工作流”:先扫描 README.md、AGENTS.md、.github/copilot-instructions.md、CI 配置等既有约定避免重复造轮子;再按“需求 → 制品”对照表只加必要的层(长期准则写进 AGENTS.md、单个高风险失误写进 docs/failures/*.md、易过期的指南配“漂移检测”脚本);为高风险或复发性失误建立“现象/根因/预防/证据”四段式记录;最后附带一套“反向审查”检查清单,用于排查别人或自己写的 harness 是否流于形式(模板未结合实证、规则无法执行、CI 未覆盖等)。整份技能是纯提示词 + Markdown 模板,没有任何需要执行的脚本,复制即可使用。
3. 适用场景
所属分类:元技能与 Agent 增强(Skill 开发工具、记忆、规划、多 Agent 编排一类)。
适用于长期使用编码 agent(GitHub Copilot、Claude Code、Codex 等)维护同一个代码仓库的团队或个人:当发现 agent 反复踩同一个坑(如误改生成文件、漏掉某个校验步骤、每次都要重新解释项目约定)时,用它来把这些经验固化成仓库里可被检查的规则、脚本或失败记录,而不是每次对话重新叮嘱一遍。也适合在接手一个“agent 常出错”的仓库时,用其审查模式排查现有规则文件哪些是空话、哪些没有配套检查。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 ✅ | 标准 Agent Skills 格式(YAML front matter + 指令正文),放入 ~/.claude/skills/ 即可被发现,无特殊依赖 |
| Codex | 需手动引用 ⚠️ | Codex 不会自动扫描 ~/.codex/skills 目录,需要在对话中手动指明该技能路径 |
| OpenClaw | 原生支持 ✅ | 与 Claude Code 同源的 Agent Skills 规范,纯 Markdown 无平台专有语法 |
| Hermes Agent | 原生支持 ✅ | Hermes 按路径扫描子目录探测 SKILL.md,能直接发现该技能 |
5. 推荐理由
多数“给 agent 定规矩”的技能停在“写一份 AGENTS.md”就结束,这个技能的价值在于把它拆成了可核验的闭环:每条规则都要对应一个能跑的检查、每次失误都要留下可复现的证据、每次改动都要有采纳报告收尾。对经常被同一个编码 agent 反复犯同一种错误折腾的用户,这是一套省心的标准操作程序,而不是又一份读完就忘的最佳实践清单。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | skills.sh 装机 182 次,在“harness engineering”这一概念的 100 余个独立第三方复刻版本中位居前列;该概念另有专门的 awesome-list(ai-boost/awesome-harness-engineering)收录归档、GitHub 上有独立 Topic 标签聚合,属“多平台大量独立讨论”的受欢迎程度 |
| 可用性 | 8 | 纯 Markdown 提示词技能,复制即用,六步工作流与检查清单结构清晰、含具体示例;技能文件自 2026-06-16 后未再更新(约 3.5 个月),略超“近 3 个月”窗口但仍在“近 6 个月”区间内 |
| 安全性 | 9 | 纯提示词/模板类,不含任何需要执行的脚本,无网络外联;第三方安全审计(Gen Agent Trust Hub、Socket、Snyk)均标注 PASS;许可证明确(MIT) |
综合评分:8.33(三项均值)
7. 跟同类 Skills 相比的优势
| 技能 | 核心定位 | 与本技能的差异 |
|---|---|---|
| harnessworks/harness-starter-kit | “harness engineering”概念的原始出处仓库(113★),提供脚手架式的初始化模板 | 偏“起始套件”,给一套现成文件去改;本技能偏“方法论 + 审查清单”,引导针对目标仓库现状定制内容,而非套用模板 |
| claude-md-management | 面向 Claude Code 的 CLAUDE.md 记忆指令归档与合并工具 | 只覆盖“记忆指令文件”这一单一制品类型;本技能覆盖指令、检查脚本、失败记录、漂移检测、采纳报告等更完整的制品谱系,且不限定单一 agent |
| ai-boost/awesome-harness-engineering | 该领域的资源聚合清单(工具、模式、评估、记忆、MCP、编排等) | 是导航型的资源列表,不直接指导具体操作;本技能是可直接套用的可执行工作流 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。但“harness engineering”作为一个方法论概念已被广泛验证:除本技能外,GitHub 上至少有数十个独立仓库(如 edtsmobile/edts-harness、Ghosteken/agent-harness、stone16/harness-engineering-skills 等)各自实现了同一思路的变体,且有专门的 awesome-list 与 GitHub Topic 标签聚合归档,反映该方法论在编码 agent 使用者社区中有真实、分散的自发采纳。
9. 其他补充
该技能已通过三家第三方安全审计平台(Gen Agent Trust Hub、Socket、Snyk)的扫描,结果均为 PASS(数据来自 skills.sh 技能详情页)。技能正文末尾附有一个可选参考链接(指向原始方法论出处仓库),仅供用户需要更完整脚手架示例时查阅,不影响技能本身的独立可用性。
10. 安装使用方式
- 通用方式(跨 agent):
npx skills add https://github.com/github/awesome-copilot --skill harness-engineering - GitHub Copilot CLI/VS Code:若已注册 Awesome Copilot 市场,可直接
copilot plugin install harness-engineering@awesome-copilot;未注册则先执行copilot plugin marketplace add github/awesome-copilot - 手动安装:从仓库
skills/harness-engineering/复制整个文件夹到目标 agent 的 skills 目录(如 Claude Code 的~/.claude/skills/) - 安装后无需重启,agent 会在用户请求“让仓库对编码 agent 更可靠”“记录失败经验”“审查现有 harness”等场景时自动触发;也可直接在对话中点名该技能
11. 注意事项
- 该技能不包含任何自动执行的脚本或校验工具,实际的“检查脚本”“漂移检测”等制品需要 agent 根据目标仓库的技术栈现场生成,效果取决于 agent 本身的实现质量;
- 技能文件自 2026-06-16 加入合集后未再更新,若“Agent Skills”规范或主流 agent 的技能发现机制发生变化,内容可能需要相应调整;
- 在 Codex 中使用需手动引用技能路径,无法依赖自动发现。