agency-agents-zh

环境要求

• 已安装 20 种受支持工具之一（如 Claude Code、GitHub Copilot、Cursor、OpenClaw 等）
• 可执行 bash 脚本的终端环境（用于运行 scripts/*.sh）
• 本地已有本项目仓库，脚本位于仓库 scripts/ 目录
• Cursor / Qwen Code 等工具需安装到你的具体项目目录下

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取项目，安装与转换脚本都在仓库的 scripts/ 目录内，后续命令需在仓库目录执行。

   git clone https://github.com/jnMetaCode/agency-agents-zh.git
   cd agency-agents-zh

   复制

2. 2一键自动安装

   不加参数运行安装脚本，会自动检测本机已安装的 AI 工具并完成安装，适合不确定用哪个工具时使用。

   ./scripts/install.sh

   复制

3. 3安装到指定工具

   用 --tool 指定目标工具。Claude Code 与 GitHub Copilot 可直接安装，无需先做格式转换。

   ./scripts/install.sh --tool claude-code
   ./scripts/install.sh --tool copilot

   复制

4. 4先转换再安装

   除 Claude Code、Copilot 外的多数工具需先用 convert.sh 转换格式，再执行安装脚本，两步都要做。

   ./scripts/convert.sh --tool cursor
   ./scripts/install.sh --tool cursor

   复制

5. 5OpenClaw 集成

   每个智能体拆成 SOUL.md、AGENTS.md、IDENTITY.md 三个文件，支持多智能体编排，安装后需重启网关。

   ./scripts/convert.sh --tool openclaw
   ./scripts/install.sh --tool openclaw
   openclaw gateway restart

   复制

6. 6装到项目目录

   Cursor、Qwen Code 等按项目生效的工具，转换后需切到你的项目目录再执行安装脚本，路径用真实仓库路径。

   cd /your/project
   /path/to/agency-agents-zh/scripts/install.sh --tool cursor

   复制

如何确认成功

安装后在 AI 工具中激活智能体，如 Claude Code 输入“激活前端开发者模式，帮我审查这个组件”，能进入角色即成功。

常见问题

注意事项

• 除 Claude Code 和 GitHub Copilot 外，其他工具都要先运行 ./scripts/convert.sh 转换格式再安装。
• Cursor 建议精选安装，避免规则数量过多导致智能匹配准确度下降。
• OpenClaw 安装后必须重启网关 openclaw gateway restart 才能生效。
• 想零代码使用可下载官方桌面客户端或在 ao.aiolaola.com/experts 在线体验。