---
title: "Qwen Code Integration"
type: source
tags: []
date: 2026-05-02
---

## Source File
- [[Agent/agency-agents/integrations/qwen/README.md]]

## Summary（用中文描述）
- 核心主题：Agency Agents 项目如何将 SubAgent 定义导出为 Qwen Code 可用的格式
- 问题域：AI Agent 的跨平台复用与工具无关的 SubAgent 文件标准化
- 方法/机制：通过 `scripts/convert.sh --tool qwen` 将 agency agents 转换为 Qwen Code 的 `.qwen/agents/` SubAgent Markdown 文件；通过 `install.sh --tool qwen` 部署到目标项目
- 结论/价值：实现 Agent 定义的"一次编写，多工具导出"，降低多 AI 工具生态中的重复配置成本

## Key Claims（用中文描述）
- Agency Agents 通过项目级 `.md` SubAgent 文件在 `.qwen/agents/` 中管理 Agent 定义
- `convert.sh --tool qwen` 脚本负责将 agency agents 逐一转换为 Qwen Code SubAgent Markdown 格式
- Qwen Code 为项目级作用域（project-scoped），而非 home-scoped
- Qwen SubAgent 文件采用最小化 frontmatter（name、description、tools）
- 更新 agency agents 后需重新生成并重新安装

## Key Quotes
> "Qwen Code is project-scoped, not home-scoped" — Qwen Code 的作用域设计原则，说明其 Agent 配置与特定项目绑定
> "If you update agents in this repo, regenerate the Qwen output before reinstalling" — 使用建议：SubAgent 源变更后必须重新生成
> "run `/agents manage` in Qwen Code to refresh the agent list, or restart the current Qwen Code session" — Qwen Code 中的 Agent 刷新方式

## Key Concepts
- [[SubAgent]]：一种以 Markdown 文件定义的 AI Agent 描述格式，支持 frontmatter 元数据
- [[Tool Integration Export]]：将同一套 Agent 定义转换为不同 AI 工具（Qwen Code、Claude Code 等）的专属格式

## Key Entities
- [[Agency Agents]]：开源多 Agent 框架，支持生成多种 AI 工具的 SubAgent 文件
- [[Qwen Code]]：阿里巴巴的 AI 编程助手，采用项目级作用域的 Agent 管理方式

## Connections
- [[Contributing]] ← extends ← [[Qwen Code Integration]]（Qwen 集成是 Agency Agents 对外扩展的一部分）
- [[Qwen Code Integration]] ← generates ← [[SubAgent Files]]

## Contradictions
- 无明显冲突