通过 Editor 中的 Better Harness Skill 分析项目工程实践并规划改进。
什么是 Agent Harness
Agent Harness 是支撑智能体完成任务的项目上下文、工具、执行边界、验证方法和反馈机制。Better Harness 帮助检查这些机制,找出影响任务交付的薄弱环节。
Better Harness 如何工作
在 Editor 的智能体对话中输入 /better-harness,调用 Better Harness 分析项目并提出改进建议。
分析会结合允许访问的项目内容和 Agent 配置,识别问题、说明证据并提出改进建议。可以在请求中限制项目范围、排除历史会话,或要求只分析、不修改文件。缺少数据时,应先核对报告的分析范围和证据限制。
评估内容
- 任务理解:目标、上下文和项目说明是否清晰。
- 可控执行:执行入口、工具权限和操作边界是否明确。
- 改动验证:测试、构建和其他检查能否验证结果。
- 可靠交付:是否具备验收证据和必要的恢复方式。
- 经验沉淀:可复用经验是否进入 Rules、Skills、Hooks 等项目资产。
在 Editor 中使用
- 在 Editor 中打开需要分析的项目,进入智能体模式。
- 在对话输入框中输入
/better-harness,确认它被识别为 Skill。 - 补充分析范围、目标和限制后发送。例如:
- 根据当前权限设置审阅工具或终端执行请求。
- 查看对话中的分析结果,核对结论引用的证据和未覆盖的内容。
阅读分析结果
优先查看分析范围、已发现的问题、证据、建议和未完成的检查。项目为空或可用证据不足时,分析结论不能代表完整项目评估。
修复与验证
审阅建议后,在对话中明确要处理的问题、允许修改的文件和验收方式,再让智能体执行相应改进。检查生成的变更并运行相关验证。
分析阶段也可能需要工具调用或生成报告。若只希望只读检查,请在请求中明确说明;不要把调用 Skill 等同于授权所有修复。
再次分析
完成改进或项目结构发生变化后,可以再次调用 /better-harness,说明需要复查的内容。比较问题是否解决,并核对新的验证证据。