Community写作与编辑github.com

RachidChabane/agentsync

一份声明式配置渲染到所有AI编码助手(Claude Code、Copilot CLI、OpenCode、VS Code)+ 一个确定性优先于AI的执行协议。与LLM和适配器无关。

agentsync 是什么?

agentsync 是一个与 LLM 和 harness 无关的工具,旨在通过一份声明式配置统一管理多个 AI 编码助手(如 Claude Code、Copilot CLI、OpenCode、VS Code)的设置,并引入一个“确定性优先于AI”的执行协议。它的核心价值在于解决多助手环境下的配置碎片化和行为不可控问题:开发者只需维护一份来源配置,agentsync 会自动将其渲染为每个助手所需的专属格式,同时通过钩子(hooks)机制在助手调用工具前强制执行预设规则(如安全检查、权限控制),确保 AI 生成代码的行为符合预期。该技能文档详细说明了如何为新的 harness(例如 Copilot CLI 或 OpenCode)添加适配器,包括读取官方文档以理解其配置格式、指令文件位置、MCP 支持情况以及可用的执行钩子,然后实现标准的 capabilities() 和 targets() 方法,并确保通过测试验证。支持平台包括所有主流 AI 编码助手,当前适配器示例涵盖 Claude Code(全功能)和 VS Code(仅指令模式),新增适配器需遵循从确定性脚手架到人工填充的明确步骤。

兼容平台✓Claude Code~Codex CLI✓Cursor✓OpenCode✓Windsurf
npx skills add RachidChabane/agentsync

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

向 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 的钩子)是可供复制的两个极端示例。

相关技能