用途:让代码仓库对编程智能体更友好,使其能顺利启动、保持在任务范围内、验证工作成果,并在多次会话之间续接。不适用于模型选择、单独调优提示词、聊天界面设计或通用应用架构。
核心模型:一个可用的编程智能体 harness 包含五个子系统——指令(AGENTS.md 或 CLAUDE.md,说明启动路径、工作规则、完成定义)、状态(feature_list.json、progress.md,记录当前功能、状态、证据、下一步)、验证(init.sh 或文档化命令,智能体声明完成前必须运行)、范围(功能依赖与完成标准,防止越界和半成品)、生命周期(session-handoff.md、会话结束例程,使下次会话可重启)。
使用方式:先检查已有内容(指令文件、功能/状态文件、验证命令、文档、包清单),只询问无法安全推断的缺失信息(目标智能体、期望文件名、结构容忍度、是否允许覆盖)。优先最小化 harness,仅在用户问题需要时再加入记忆、工具安全、多智能体或基准细节。
创建 harness:node skills/harness-creator/scripts/create-harness.mjs --target /path/to/project;可选 --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)再评分目标与评估覆盖;真实效果仍需在代表性任务上做前后对比会话。
设计规则:根指令文件保持简短,只写路由与不变量;项目事实放项目文档;验证命令明确可运行;标记功能完成前需有证据;除非有明确多智能体归属边界,否则只保留一个活跃功能;优先追加/更新状态文件而非依赖聊天历史;脚本不得隐藏破坏性行为,覆盖需用户明确批准。
交付清单:AGENTS.md 或 CLAUDE.md、feature_list.json、progress.md、init.sh,多会话工作可选 session-handoff.md,以及文档化的验证证据或下一步动作。若无法创建文件,则提供确切的文件内容与命令。
限制:不涉及模型选择、提示词单独调优、聊天 UI 设计与通用应用架构;基准为结构性评估,不代表真实效果;覆盖文件需用户确认。