1.7 KiB
1.7 KiB
title, type, tags, sources, last_updated
| title | type | tags | sources | last_updated | |
|---|---|---|---|---|---|
| Agent Integration | concept |
|
2026-05-01 |
Overview
Agent Integration（Agent 集成适配）是将统一的 Markdown Agent 规范转换为各 AI 编码工具原生格式的适配层技术。The Agency 通过 convert.sh 和 install.sh 两层脚本实现这一目标。
Definition
Agent Integration = 统一的 Agent 行为规范（.md） + 工具特定的转换器（convert.sh） + 标准化的安装机制（install.sh）
Key Properties
- 单向转换：从源
.md到目标格式，不做反向同步 - 工具原生：转换后的格式是该工具推荐/唯一的配置方式
- 作用域分层：Home-Scoped（全用户级）vs Project-Scoped（项目级）
- 注册机制差异：部分工具依赖自动发现（如 Claude Code），部分需要显式启动参数（如 Kimi
--agent-file）
Integration Patterns
| 工具 | 格式 | 作用域 | 注册机制 |
|---|---|---|---|
| Claude Code | .md |
Home | 自动发现 |
| GitHub Copilot | .md |
Home | 自动发现 |
| Antigravity | SKILL.md |
Home | 工具内置 |
| Gemini CLI | 扩展包 + Skill | Home | 自动加载 |
| OpenCode | .md |
Project | 自动发现 |
| OpenClaw | SOUL.md+AGENTS.md+IDENTITY.md |
Home | Gateway |
| Cursor | .mdc |
Project | 自动发现 |
| Aider | CONVENTIONS.md |
Project | 自动发现 |
| Windsurf | .windsurfrules |
Project | 自动发现 |
| Kimi Code | YAML | Home | 显式启动参数 |
| Qwen Code | .md SubAgent |
Project | 自动发现 |
Sources
- OpenCode Integration（
Agent/agency-agents/integrations/README.md） - OpenClaw Integration（
Agent/agency-agents/integrations/openclaw/README.md）