---
title: "Agent Integration"
type: concept
tags: []
sources: [qwen-readme]
last_updated: 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`）