harness-creator

Harness Creator

使用此技能让代码仓库更便于编码 Agent 启动、保持工作范围、验证成果并在不同会话间接续工作。保持 harness 足够精简，确保 Agent 确实会遵循它。

不适用于模型选择、单独调整提示词、聊天界面设计或通用应用架构。

核心模型

每个实用的编码 Agent harness 都包含五个子系统：

子系统	最小构件	用途
指令	AGENTS.md 或 CLAUDE.md	启动路径、工作规则、完成标准
状态	feature_list.json、progress.md	当前功能、状态、证据、下一步
验证	init.sh 或已记录的命令	Agent 声称完成前必须运行的测试／检查
范围	功能依赖项和完成标准	防止越界和工作半途而废
生命周期	session-handoff.md、会话结束流程	确保下一会话能够重新开始

首要步骤

1. 检查现有内容：指令文件、功能／状态文件、验证命令、文档、包清单。
2. 只询问无法安全推断的缺失信息：目标 Agent、所需文件名、对结构的接受程度，以及是否允许覆盖。
3. 优先构建最精简的 harness。只有当用户的问题需要时，才添加记忆、工具安全、多 Agent 或基准测试方面的细节。

常见任务

创建 harness

在本地代码仓库中工作时，使用附带的脚本：

node skills/harness-creator/scripts/create-harness.mjs --target /path/to/project

选项：

• 对于面向 Claude 的项目，使用 --agent-file CLAUDE.md。
• 检测错误时，使用 --package-manager npm|pnpm|yarn|bun。
• 使用 --commands "cmd one,cmd two" 自定义验证命令。
• 只有在确认允许覆盖后才使用 --force。

然后说明创建了哪些内容，以及用户应如何替换占位功能条目。

审核现有 harness

运行：

node skills/harness-creator/scripts/validate-harness.mjs --target /path/to/project

报告五个子系统的评分、得分最低的部分，以及最先应进行的 2-3 项可靠性改进。将最低分项视为潜在瓶颈；在声称存在因果关系前，先通过失败情况、日志或任务结果加以确认。

生成报告

用户需要可分享的评估时使用：

node skills/harness-creator/scripts/render-assessment-html.mjs --target /path/to/project
node skills/harness-creator/scripts/run-benchmark.mjs --target /path/to/project --html /path/to/report.html

明确说明这是一项结构性基准测试。基准测试会先运行自检——搭建一个临时 harness 并验证它，以证明附带脚本能够端到端运行——然后再评估目标对象及其评测覆盖情况。要验证实际效果，仍需让 Agent 在有代表性的任务上进行前后对比会话。

何时阅读参考资料

只加载与用户问题相关的参考资料：

• 跨会话记忆：记忆持久化
• 可复用的技能工作流：技能运行时
• 权限、工具、并发：工具注册表与安全性
• 上下文预算与渐进式披露：上下文工程
• 委派与并行 Agent：多 Agent 协作
• 钩子、启动、长期运行的工作：生命周期与引导
• 不明显的故障模式：注意事项

设计规则

• 保持根目录指令文件简短：写路由规则和不变量，而不是完整手册。
• 将项目事实放在项目文档中，而不是技能中。
• 明确写出可运行的验证命令。
• 将功能标记为完成前，必须要求提供证据。
• 除非 harness 明确规定多 Agent 的所有权边界，否则一次只处理一个活动功能。
• 优先采用追加／更新状态文件，而不是依赖聊天记录。
• 切勿在脚本中隐藏破坏性行为；覆盖操作必须事先获得用户明确批准。

交付清单

要获得可用的最小化工作框架，请在目标项目中保留以下内容：

• AGENTS.md 或 CLAUDE.md
• feature_list.json
• progress.md
• init.sh
• 多次会话协作时可选的 session-handoff.md
• 已记录的验证证据或后续操作

如果无法创建文件，请改为提供准确的文件内容和命令。