CopilotKit

解决什么问题

使用 AI Agent 的工程师常遇到一个现实问题：你在 Claude Code 上写了一套好用的技能，换到 Codex 或 Hermes Agent 后就得重新适配一遍。每个平台的技能格式、工具调用方式、元数据约定都不完全一致，跨平台复用往往意味着把 17 个文件挨个重写。

CopilotKit 要解决的就是这个重复适配问题：把一批子技能打包成统一集合，让同一份能力描述可以在多个 Agent 运行时上直接使用。

它是怎么工作的

• 集合式组织：整个技能由 17 个子技能文件构成，每个子技能是独立的能力单元，可以单独启用、单独跳过，而不必一次性全量加载。
• 声明式描述：每个子技能通过 SKILL.md 这类元数据文件描述它的用途、触发条件和执行步骤，宿主 Agent 运行时读取后自行决定何时调用。
• 一次编写，多端运行：集合声明兼容 Claude Code、Codex、Hermes Agent、OpenClaw、QClaw、WorkBuddy 六个平台，迁移时不需要改写能力本身，只需要在目标平台上加载同一批文件。
• 按子技能组合：由于拆分粒度细到 17 个文件，你可以只取其中几个子技能接入现有项目，其余部分保持闲置，不会影响宿主的上下文。

适用边界与注意点

• 技能文件只是能力声明与配套脚本，实际执行效果取决于宿主平台的工具实现，例如文件读写、命令执行的权限策略各不相同。
• 不同平台对技能的触发时机、上下文注入方式支持程度不一，接入后建议在目标平台上逐个子技能做验证，而不是假设行为完全一致。
• 如果你只用一个平台，且没有跨端复用的需求，集合的多平台兼容价值会被稀释；此时更直接的方案是按需手写少量技能。
• 17 个子技能之间可能存在隐含依赖，接入时建议先通读各子技能的描述，确认调用顺序和资源引用关系，避免出现加载了但触发不到的情况。