一键搭建 Harness 框架
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_00ed5214/harness-scaffold。
技能介绍
问题背景
很多团队把 Agent 能力全押在模型选型上,却忽略运行环境:跨会话失忆、上下文被无关文件撑爆、改完代码没人跑验证,协作越久越像「每次从零开始」。Harness Engineering 的核心观点是 Agent = Model + Harness——模型定下限,轨道系统定上限。
技能如何工作
本技能以 Harness Architect 角色按阶段初始化工作区,不写业务代码,只搭基建:
- Phase 0 环境扫描:识别 Unity / Node / Python / Go 等项目类型,检测 Git 或 SVN,盘点
.workbuddy/、.codebuddy/、CODEBUDDY.md等已有资产,输出扫描报告并等待确认。 - Phase 1 记忆系统:创建
.workbuddy/memory/骨架,生成或增量补齐MEMORY.md(ADR、Gotchas、偏好、进行中议题等),不覆盖已有内容。 - Phase 2 上下文工程:在项目根生成精简的
CODEBUDDY.md(约 200 行内),作为项目级知识契约;大型 monorepo 可按模块追加局部上下文。 - Phase 3 Rules:在
.codebuddy/rules/写入harness-core.md与按需的harness-verify.md,并按版本控制类型注入git diff或svn status等验证约束。 - Phase 4~5:七项 Harness 体检(记忆分层、上下文入口等)给出青铜~钻石段位,汇总文件清单、使用指南,并写入当天 daily log。
设计强调概率性生成 + 确定性校验、分层记忆(L0~L3)与「存储一切有价值且可被找到」。
适用边界
- 只增不改:已有
CODEBUDDY.md等文件不会被整文件覆盖,仅补缺失章节。 - 渐进式:先搭骨架,细节靠后续迭代;
MEMORY.md建议控制在约 300 行内。 - 无版本控制时会在体检中标注缺失项,验证 Rule 会相应简化。
- 实战取向来自游戏/配置表等复杂工程(含 SVN、大量 Excel/CSV),通用文档仓同样可用,但子目录上下文主要面向模块清晰的大项目。
使用场景
- 新接入 Cursor/CodeBuddy 的仓库还没有 MEMORY.md 与 daily log,需要先搭分层记忆再让 Agent 长期协作
- Unity 或策划向项目用 SVN 管控,希望自动生成 svn status 验证 Rule 而不手写 harness 规范
- Monorepo 根目录上下文过载,需要一份 200 行内的 CODEBUDDY.md 作为 Agent 的项目契约入口
- 改完代码后 Agent 常跳过 diff 检查,需要一次性初始化 harness-core 与 harness-verify 规则闭环
适合人员
- 维护 SVN + 大量 Excel/CSV 配置表的游戏工程负责人,希望 AI 按确定性验证改表与脚本
- 在多模块后端 monorepo 里带新人用 Agent 的技术 Lead,需要先统一记忆与 Rules 再分模块协作
- 个人开源作者刚把旧项目交给 Agent 维护,工作区仍是「裸奔」状态需要体检报告与改进路线
- Harness Engineering 实践者要在现有 .codebuddy 目录上增量补全,且不能覆盖已有 CODEBUDDY 内容