harness-builder
Skill3 starsChanged 13 days agoMITView on GitHub
在目标项目搭或修 agent 工作台：项目入口、恢复面初始化、验证闸门、能力配置。触发：新项目第一次接入本套技能，或用户要搭/初始化/修工作台；日常任务不经过（任务级建档由 plan 自动做），已有工作台足够时直接回原任务。
3 other projects use a version of this.
Adopted by
Most recently taken up by
- li-xisheng/claude-skillstheir own version, first seen Sep 8, 2026
- duniecdawid/ultra-claudetheir own version, first seen Jul 16, 2026
- JohnnySun/skillstheir own version, first seen Jul 12, 2026
Other versions3 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 3
- JohnnySun/skills★ 2same name
- li-xisheng/claude-skills★ 2same name
- duniecdawid/ultra-claude★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository17 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- autoresearchSkill
- brainstormSkill
- cleanupSkill
- diagnoseSkill
- find-skillsSkill
- handoffSkill
- implementSkill
- planSkill
- remove-deadcode-pySkill
- researchSkill
- reviewSkill
- shipSkill
- sweepSkill
- tddSkill
- writing-for-agentsSkill
The file
Files
Harness Builder
这是跨工作台问题的总控；交付与缺口相称的配置或建议，不把完整工作流当作所有任务前置条件。
流程
- 阅读与用户目标相关的入口、配置、脚本、恢复记录和实际错误。确认 canonical source、目标运行时及已有能力。
- 仅对真实缺口选方案，并识别可拆除的过期组件；简单修复可直接说明文件和检查，跨领域改造用一张 HARNESS RECOMMENDATION MATRIX 汇总缺口、证据、处理方式、负责人和验证。Required / Recommended / Deferred / Rejected 是建议等级，不是安装授权。
- helper 路由见下表。独立、边界明确的只读调查可并行；简单一行修改无需为每类文件完整启动另一套工作流，跨 helper 传递已有目标和授权。
- USER CHECKPOINT 仅用于实际缺少的授权或关键取舍。仅审计/推荐时只读；明确要求建立、修复或优化时完成范围内可逆编辑和必要验证，不要求用户批准每个精确 patch。新增外部操作或扩大配置范围需另行授权。
- 修改 canonical source；安装面受影响时同步
.claude-plugin/manifest 与README.md、docs/install.md，验证真实目标。不要默认往目标项目安装 hooks、MCP、子代理配置或所有模板。（本插件自带的hooks/harness_guard.py不写进目标项目：它随 Claude Code 插件加载，只在项目已有.harness/index.md时拦截写入.harness/清单外的路径，停用插件即关闭。）目标项目选harness恢复面时，按../writing-for-agents/references/recovery_surface_policy.md的合同：用templates/index.md.j2、track.md.j2建.harness/，可用lessons.md.j2建带说明头的lessons.md，AGENTS.md的 Recovery 段取自templates/AGENTS.md.j2；把本 skill 的scripts/harness_lint.py复制到目标项目scripts/，并在检查入口（templates/check.sh.j2）调用它。生成的文本不引用目标项目不存在的东西；旧布局（work_index.md、state.md）交给sweep迁移。 - 相关检查通过且风险低时可以完成；复杂合同修改按
review进一步审阅。若用户同时授权后续产品工作，继续该工作；仅工作台推荐不授权执行产品任务。
Helper Skill routing
| 缺口 | Helper Skill |
持久指令与恢复面（AGENTS / CLAUDE / Cursor rules、.harness/ 索引与轨道、plan） | writing-for-agents（Writing for Agents） |
| 能力选型、寻找技能（hooks、MCP、子代理、插件只读推荐） | find-skills |
按需参考
- 范围与授权：
references/controller_discipline.md、references/install_policy.md。 - 推荐矩阵：
references/recommendation_matrix_policy.md；配置落点：references/decision_matrix.md。 - 验证入口：
references/verification_policy.md；架构守卫：references/architecture_enforcement_policy.md；漂移：references/anti_entropy.md。 - 缺少 helper 时可用
references/capability_discovery_playbook.md；不要把 fallback 当重复必读。 - 需要并行调查时：
references/subagent_orchestration.md。
Recommended next skill
按尚未完成的实际工作选择 helper、implement、diagnose 或 review；只有本次记录需要整理时用 cleanup，否则结束。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.