向 agentsync 添加 harness
添加 harness 是判断工作(映射 harness 的配置概念),围绕一个确定性脚手架展开。请按顺序执行下列步骤,不要跳过文档阅读。
1. 检查是否已处理
查看 core/adapters/__init__.py(ADAPTERS)和 config/profile.json。如果该 harness 已存在,则停止——无需添加任何内容。
2. 搭建适配器脚手架(确定性)
python3 skills/add-harness/scaffold-adapter.py <name>
该命令会写入 core/adapters/<name>.py(存根)并注册。它不知道 harness 的细节——你将在下一步中填写。
3. 阅读 harness 的文档(判断工作——不要猜测)
从 harness 自己的文档中查找并确认:
- 指令——它是否读取用户作用域的指令/规则文件?在哪里?(如果仅在设置中内联,则镜像 VS Code 的方法。)
- MCP——它的 MCP 配置格式和文件位置(或者它没有 MCP)。
- 技能/权限——是否有任何技能可用性控制(或没有)。
- 执行(钩子)——棘手的部分:它能否在工具调用之前运行命令?钩子在标准输入上收到什么 JSON(命令字段名称)?它如何发出“阻止”信号?如果它没有钩子接口但拥有插件系统,则镜像 OpenCode 的插件。如果它根本无法执行,则将
enforcement排除在capabilities()之外。
4. 填充适配器
实现 capabilities()(诚实地——仅支持 harness 实际支持的)和 targets(),使用现有的目标类型(Link、Json、Merge、HookSpec)。重用共享的 core/enforcement/guard-commit.sh 和 session-nudge.sh——根据其约定将 harness 的钩子指向它们;不要重新实现门控。保留 self._passthrough(ctx) 中的 extra_owned/extra_hooks,以便设置传递正常工作。
5. 检测 + 测试 + 验证
- 在
init.sh中为它添加一行检测。 - 在
tests/test_apply.py中添加断言(其文件在沙箱中正确渲染)。 - 运行
make verify。它必须在完成之前通过。
参考
core/adapters/claude.py(全功能)和 vscode.py(仅指令,重用另一个 harness 的钩子)是可供复制的两个极端示例。