39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
---
|
||
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`）
|