agency-agents-zh-skill
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chineseagency-agents-zh Skill
agency-agents-zh Skill
Skill by ara.so — AI Agent Skills collection.
agency-agents-zh 是一个包含 215 个即插即用 AI 专家角色的中文智能体库,覆盖工程、设计、营销、产品、游戏、安全、金融等 18 个部门。支持 Claude Code、Cursor、Copilot、OpenClaw 等 17 种 AI 编程工具。除了完整翻译上游 165 个角色外,新增了 50 个中国市场原创智能体(小红书、抖音、微信、飞书、钉钉、跨境电商等)。
Skill by ara.so — AI Agent Skills collection.
agency-agents-zh 是一个包含 215 个即插即用 AI 专家角色的中文智能体库,覆盖工程、设计、营销、产品、游戏、安全、金融等 18 个部门。支持 Claude Code、Cursor、Copilot、OpenClaw 等 17 种 AI 编程工具。除了完整翻译上游 165 个角色外,新增了 50 个中国市场原创智能体(小红书、抖音、微信、飞书、钉钉、跨境电商等)。
核心特性
核心特性
- 215 个专家角色:每个智能体有明确的身份、工作流程和交付物
- 17 种工具支持:Claude Code、Cursor、Copilot、OpenClaw、Gemini CLI、Qwen、Codex 等
- 50 个中国市场原创:小红书运营、抖音种草、微信小程序、飞书集成、钉钉开发等
- 18 个专业部门:工程、设计、营销、产品、游戏、安全、金融、数据等
- 自动化编排:配合 Agency Orchestrator 实现多智能体协作
- 215 个专家角色:每个智能体有明确的身份、工作流程和交付物
- 17 种工具支持:Claude Code、Cursor、Copilot、OpenClaw、Gemini CLI、Qwen、Codex 等
- 50 个中国市场原创:小红书运营、抖音种草、微信小程序、飞书集成、钉钉开发等
- 18 个专业部门:工程、设计、营销、产品、游戏、安全、金融、数据等
- 自动化编排:配合 Agency Orchestrator 实现多智能体协作
安装方法
安装方法
方式一:一键安装脚本
方式一:一键安装脚本
bash
undefinedbash
undefined克隆仓库
克隆仓库
git clone https://github.com/jnMetaCode/agency-agents-zh.git
cd agency-agents-zh
git clone https://github.com/jnMetaCode/agency-agents-zh.git
cd agency-agents-zh
自动检测已安装工具并安装
自动检测已安装工具并安装
./scripts/install.sh
./scripts/install.sh
指定工具安装
指定工具安装
./scripts/install.sh --tool openclaw # OpenClaw(推荐)
./scripts/install.sh --tool claude-code # Claude Code
./scripts/install.sh --tool cursor # Cursor
./scripts/install.sh --tool copilot # GitHub Copilot
./scripts/install.sh --tool gemini-cli # Gemini CLI
./scripts/install.sh --tool qwen # Qwen Code
./scripts/install.sh --tool codex # Codex CLI
./scripts/install.sh --tool aider # Aider
./scripts/install.sh --tool windsurf # Windsurf
./scripts/install.sh --tool hermes # Hermes Agent
undefined./scripts/install.sh --tool openclaw # OpenClaw(推荐)
./scripts/install.sh --tool claude-code # Claude Code
./scripts/install.sh --tool cursor # Cursor
./scripts/install.sh --tool copilot # GitHub Copilot
./scripts/install.sh --tool gemini-cli # Gemini CLI
./scripts/install.sh --tool qwen # Qwen Code
./scripts/install.sh --tool codex # Codex CLI
./scripts/install.sh --tool aider # Aider
./scripts/install.sh --tool windsurf # Windsurf
./scripts/install.sh --tool hermes # Hermes Agent
undefined方式二:OpenClaw 专用安装(推荐)
方式二:OpenClaw 专用安装(推荐)
OpenClaw 使用三文件结构:(身份人设)+ (业务能力)+ (简介)
SOUL.mdAGENTS.mdIDENTITY.mdbash
undefinedOpenClaw 使用三文件结构:(身份人设)+ (业务能力)+ (简介)
SOUL.mdAGENTS.mdIDENTITY.mdbash
undefined第一步:转换为 OpenClaw 格式
第一步:转换为 OpenClaw 格式
./scripts/convert.sh --tool openclaw
./scripts/convert.sh --tool openclaw
第二步:安装到 OpenClaw 目录
第二步:安装到 OpenClaw 目录
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool openclaw
智能体文件会安装到:~/.openclaw/souls/
智能体文件会安装到:~/.openclaw/souls/
重启 OpenClaw 网关后生效
重启 OpenClaw 网关后生效
undefinedundefined方式三:手动安装(Claude Code / Copilot)
方式三:手动安装(Claude Code / Copilot)
bash
undefinedbash
undefinedClaude Code
Claude Code
cp -r marketing/.md ~/.claude/agents/
cp -r engineering/.md ~/.claude/agents/
cp -r design/*.md ~/.claude/agents/
cp -r marketing/.md ~/.claude/agents/
cp -r engineering/.md ~/.claude/agents/
cp -r design/*.md ~/.claude/agents/
GitHub Copilot
GitHub Copilot
cp -r marketing/.md ~/.github/copilot/agents/
cp -r engineering/.md ~/.github/copilot/agents/
cp -r marketing/.md ~/.github/copilot/agents/
cp -r engineering/.md ~/.github/copilot/agents/
Cursor
Cursor
cp -r marketing/*.md ~/.cursor/agents/
undefinedcp -r marketing/*.md ~/.cursor/agents/
undefined使用智能体
使用智能体
在 AI 编程工具中激活
在 AI 编程工具中激活
安装后,在任意 AI 编程工具中通过自然语言激活:
激活前端开发者模式,帮我构建一个 React 组件切换到小红书运营专家角色,帮我策划一个产品种草方案使用安全工程师角色审查这段代码的安全漏洞安装后,在任意 AI 编程工具中通过自然语言激活:
激活前端开发者模式,帮我构建一个 React 组件切换到小红书运营专家角色,帮我策划一个产品种草方案使用安全工程师角色审查这段代码的安全漏洞查看可用智能体列表
查看可用智能体列表
bash
undefinedbash
undefined列出所有智能体
列出所有智能体
ls -R engineering/ design/ marketing/ product/ game/ security/ finance/ data/
ls -R engineering/ design/ marketing/ product/ game/ security/ finance/ data/
查看工程类智能体
查看工程类智能体
ls engineering/
undefinedls engineering/
undefinedAgency Orchestrator 多智能体编排
Agency Orchestrator 多智能体编排
Agency Orchestrator 让多个智能体协作完成复杂任务。
Agency Orchestrator 让多个智能体协作完成复杂任务。
安装 Agency Orchestrator
安装 Agency Orchestrator
bash
npm install -g agency-orchestratorbash
npm install -g agency-orchestrator基本使用
基本使用
bash
undefinedbash
undefined一句话描述需求,自动选角+编排+执行
一句话描述需求,自动选角+编排+执行
ao compose "帮我写一篇关于 AI Agent 的深度分析文章" --run
ao compose "帮我写一篇关于 AI Agent 的深度分析文章" --run
输出:
输出:
🎭 自动选角 → 叙事学家 + 心理学家 + 内容创作者
🎭 自动选角 → 叙事学家 + 心理学家 + 内容创作者
📊 自动编排 → DAG 工作流,并行执行
📊 自动编排 → DAG 工作流,并行执行
✅ 自动交付 → 完整成果
✅ 自动交付 → 完整成果
undefinedundefined使用预设模板
使用预设模板
bash
undefinedbash
undefined查看可用模板
查看可用模板
ao templates
ao templates
使用开发类模板
使用开发类模板
ao run --template web-app-mvp --params "项目名称=电商平台,技术栈=Next.js"
ao run --template web-app-mvp --params "项目名称=电商平台,技术栈=Next.js"
使用营销类模板
使用营销类模板
ao run --template social-media-campaign --params "产品=智能手表,平台=小红书"
undefinedao run --template social-media-campaign --params "产品=智能手表,平台=小红书"
undefinedYAML 工作流配置
YAML 工作流配置
创建 :
workflow.yamlyaml
name: 小红书产品种草全流程
description: 从调研到投放的完整流程
agents:
- id: researcher
role: marketing/marketing-xiaohongshu-operator.md
task: 分析目标用户画像和竞品内容策略
- id: content_creator
role: marketing/marketing-content-creator.md
task: 创作 5 篇种草笔记(3 图文 + 2 视频)
depends_on: [researcher]
- id: kol_matcher
role: marketing/marketing-xiaohongshu-operator.md
task: 推荐 10 位匹配 KOL 及报价预估
depends_on: [researcher]
- id: ad_planner
role: marketing/marketing-ad-campaign-manager.md
task: 制定信息流投放计划和预算分配
depends_on: [content_creator, kol_matcher]
config:
llm: deepseek # 或 claude, gemini, openai
parallel: true # 无依赖步骤并行执行
output_dir: ./output运行工作流:
bash
ao run workflow.yaml创建 :
workflow.yamlyaml
name: 小红书产品种草全流程
description: 从调研到投放的完整流程
agents:
- id: researcher
role: marketing/marketing-xiaohongshu-operator.md
task: 分析目标用户画像和竞品内容策略
- id: content_creator
role: marketing/marketing-content-creator.md
task: 创作 5 篇种草笔记(3 图文 + 2 视频)
depends_on: [researcher]
- id: kol_matcher
role: marketing/marketing-xiaohongshu-operator.md
task: 推荐 10 位匹配 KOL 及报价预估
depends_on: [researcher]
- id: ad_planner
role: marketing/marketing-ad-campaign-manager.md
task: 制定信息流投放计划和预算分配
depends_on: [content_creator, kol_matcher]
config:
llm: deepseek # 或 claude, gemini, openai
parallel: true # 无依赖步骤并行执行
output_dir: ./output运行工作流:
bash
ao run workflow.yaml断点续跑
断点续跑
bash
undefinedbash
undefined工作流失败后,单独重跑某个步骤
工作流失败后,单独重跑某个步骤
ao resume workflow.yaml --step content_creator
ao resume workflow.yaml --step content_creator
从某个步骤开始继续
从某个步骤开始继续
ao resume workflow.yaml --from ad_planner
undefinedao resume workflow.yaml --from ad_planner
undefined核心智能体示例
核心智能体示例
1. 小红书运营专家
1. 小红书运营专家
文件:
marketing/marketing-xiaohongshu-operator.md使用场景:
切换到小红书运营专家,帮我策划一款智能手表的种草方案交付物:
- 用户画像分析
- 内容选题矩阵(5W1H)
- 笔记范例(图文+视频脚本)
- KOL 合作清单及报价
- 数据监控仪表盘
文件:
marketing/marketing-xiaohongshu-operator.md使用场景:
切换到小红书运营专家,帮我策划一款智能手表的种草方案交付物:
- 用户画像分析
- 内容选题矩阵(5W1H)
- 笔记范例(图文+视频脚本)
- KOL 合作清单及报价
- 数据监控仪表盘
2. 上位机工程师
2. 上位机工程师
文件:
engineering/engineering-pc-host-engineer.md使用场景:
激活上位机工程师角色,帮我开发一个工业检测设备的 Qt 界面核心能力:
- Qt/QML UI 开发
- QSerialPort/QModbusTCP 通信
- QChart 实时曲线
- SQLite 数据存储
- 多语言(中英文)
代码示例(自动生成):
cpp
// ModbusManager.h
class ModbusManager : public QObject {
Q_OBJECT
public:
explicit ModbusManager(QObject *parent = nullptr);
bool connectDevice(const QString &ip, int port);
signals:
void dataReceived(quint16 registerAddr, quint16 value);
private:
QModbusTcpClient *modbusClient;
};文件:
engineering/engineering-pc-host-engineer.md使用场景:
激活上位机工程师角色,帮我开发一个工业检测设备的 Qt 界面核心能力:
- Qt/QML UI 开发
- QSerialPort/QModbusTCP 通信
- QChart 实时曲线
- SQLite 数据存储
- 多语言(中英文)
代码示例(自动生成):
cpp
// ModbusManager.h
class ModbusManager : public QObject {
Q_OBJECT
public:
explicit ModbusManager(QObject *parent = nullptr);
bool connectDevice(const QString &ip, int port);
signals:
void dataReceived(quint16 registerAddr, quint16 value);
private:
QModbusTcpClient *modbusClient;
};3. 微信小程序开发者
3. 微信小程序开发者
文件:
engineering/engineering-wechat-mini-program-developer.md使用场景:
使用微信小程序开发者角色,帮我构建一个电商小程序核心能力:
- WXML/WXSS 组件化开发
- 微信支付集成
- 云开发数据库
- 分包加载优化
- 用户授权流程
代码示例:
javascript
// pages/product/product.js
Page({
data: {
product: null,
canvasId: 'shareCanvas'
},
onLoad(options) {
this.loadProduct(options.id);
},
async loadProduct(id) {
const db = wx.cloud.database();
const res = await db.collection('products').doc(id).get();
this.setData({ product: res.data });
},
async onBuyNow() {
const res = await wx.cloud.callFunction({
name: 'createOrder',
data: { productId: this.data.product._id }
});
wx.requestPayment({
...res.result.payment,
success: () => wx.navigateTo({ url: '/pages/order/order' })
});
}
});文件:
engineering/engineering-wechat-mini-program-developer.md使用场景:
使用微信小程序开发者角色,帮我构建一个电商小程序核心能力:
- WXML/WXSS 组件化开发
- 微信支付集成
- 云开发数据库
- 分包加载优化
- 用户授权流程
代码示例:
javascript
// pages/product/product.js
Page({
data: {
product: null,
canvasId: 'shareCanvas'
},
onLoad(options) {
this.loadProduct(options.id);
},
async loadProduct(id) {
const db = wx.cloud.database();
const res = await db.collection('products').doc(id).get();
this.setData({ product: res.data });
},
async onBuyNow() {
const res = await wx.cloud.callFunction({
name: 'createOrder',
data: { productId: this.data.product._id }
});
wx.requestPayment({
...res.result.payment,
success: () => wx.navigateTo({ url: '/pages/order/order' })
});
}
});4. 飞书集成开发工程师
4. 飞书集成开发工程师
文件:
engineering/engineering-feishu-integration-developer.md使用场景:
切换到飞书集成开发工程师,帮我开发一个审批流机器人核心能力:
- 飞书机器人开发
- 审批流接口
- 多维表格操作
- 飞书文档 API
- 事件订阅
代码示例:
javascript
// server.js
const express = require('express');
const app = express();
app.post('/webhook/approval', async (req, res) => {
const { event } = req.body;
if (event.type === 'approval_instance.approved') {
const instanceCode = event.instance_code;
// 更新多维表格
await fetch('https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.FEISHU_ACCESS_TOKEN}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
fields: {
'审批状态': '已通过',
'审批时间': new Date().toISOString()
}
})
});
// 发送通知
await sendMessage(event.user_id, '您的审批已通过!');
}
res.json({ code: 0 });
});文件:
engineering/engineering-feishu-integration-developer.md使用场景:
切换到飞书集成开发工程师,帮我开发一个审批流机器人核心能力:
- 飞书机器人开发
- 审批流接口
- 多维表格操作
- 飞书文档 API
- 事件订阅
代码示例:
javascript
// server.js
const express = require('express');
const app = express();
app.post('/webhook/approval', async (req, res) => {
const { event } = req.body;
if (event.type === 'approval_instance.approved') {
const instanceCode = event.instance_code;
// 更新多维表格
await fetch('https://open.feishu.cn/open-apis/bitable/v1/apps/{app_token}/tables/{table_id}/records', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.FEISHU_ACCESS_TOKEN}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
fields: {
'审批状态': '已通过',
'审批时间': new Date().toISOString()
}
})
});
// 发送通知
await sendMessage(event.user_id, '您的审批已通过!');
}
res.json({ code: 0 });
});5. 前端开发者
5. 前端开发者
文件:
engineering/engineering-frontend-developer.md使用场景:
激活前端开发者模式,帮我构建一个现代化的 React Dashboard核心能力:
- React/Vue 组件开发
- 响应式设计
- 性能优化
- 状态管理(Redux/Zustand)
- 类型安全(TypeScript)
代码示例:
tsx
// components/Dashboard.tsx
import { useEffect, useState } from 'react';
import { Card, Chart } from '@/components/ui';
interface DashboardData {
users: number;
revenue: number;
trend: Array<{ date: string; value: number }>;
}
export function Dashboard() {
const [data, setData] = useState<DashboardData | null>(null);
useEffect(() => {
fetch('/api/dashboard')
.then(res => res.json())
.then(setData);
}, []);
if (!data) return <div>加载中...</div>;
return (
<div className="grid grid-cols-3 gap-4">
<Card title="总用户数">
<span className="text-3xl font-bold">{data.users}</span>
</Card>
<Card title="总收入">
<span className="text-3xl font-bold">¥{data.revenue}</span>
</Card>
<Card title="增长趋势" className="col-span-3">
<Chart data={data.trend} type="line" />
</Card>
</div>
);
}文件:
engineering/engineering-frontend-developer.md使用场景:
激活前端开发者模式,帮我构建一个现代化的 React Dashboard核心能力:
- React/Vue 组件开发
- 响应式设计
- 性能优化
- 状态管理(Redux/Zustand)
- 类型安全(TypeScript)
代码示例:
tsx
// components/Dashboard.tsx
import { useEffect, useState } from 'react';
import { Card, Chart } from '@/components/ui';
interface DashboardData {
users: number;
revenue: number;
trend: Array<{ date: string; value: number }>;
}
export function Dashboard() {
const [data, setData] = useState<DashboardData | null>(null);
useEffect(() => {
fetch('/api/dashboard')
.then(res => res.json())
.then(setData);
}, []);
if (!data) return <div>加载中...</div>;
return (
<div className="grid grid-cols-3 gap-4">
<Card title="总用户数">
<span className="text-3xl font-bold">{data.users}</span>
</Card>
<Card title="总收入">
<span className="text-3xl font-bold">¥{data.revenue}</span>
</Card>
<Card title="增长趋势" className="col-span-3">
<Chart data={data.trend} type="line" />
</Card>
</div>
);
}智能体部门分类
智能体部门分类
工程部(Engineering)
工程部(Engineering)
33 个智能体,涵盖:
- 前端/后端/全栈开发
- AI/ML 工程
- DevOps/SRE
- 安全工程
- 嵌入式/物联网
- 上位机/工控
- 微信/飞书/钉钉集成
33 个智能体,涵盖:
- 前端/后端/全栈开发
- AI/ML 工程
- DevOps/SRE
- 安全工程
- 嵌入式/物联网
- 上位机/工控
- 微信/飞书/钉钉集成
设计部(Design)
设计部(Design)
18 个智能体,涵盖:
- UI/UX 设计
- 品牌设计
- 视觉叙事
- 无障碍设计
- AI 图像生成
18 个智能体,涵盖:
- UI/UX 设计
- 品牌设计
- 视觉叙事
- 无障碍设计
- AI 图像生成
营销部(Marketing)
营销部(Marketing)
40 个智能体,涵盖:
- 小红书/抖音/B站运营
- SEO/SEM
- 内容创作
- 社交媒体
- 跨境电商
- 广告投放
40 个智能体,涵盖:
- 小红书/抖音/B站运营
- SEO/SEM
- 内容创作
- 社交媒体
- 跨境电商
- 广告投放
产品部(Product)
产品部(Product)
22 个智能体,涵盖:
- 产品管理
- 需求分析
- 用户研究
- 数据驱动决策
- A/B 测试
22 个智能体,涵盖:
- 产品管理
- 需求分析
- 用户研究
- 数据驱动决策
- A/B 测试
其他部门
其他部门
- 游戏(Game):15 个
- 安全(Security):12 个
- 金融(Finance):10 个
- 数据(Data):18 个
- 运营(Operations):14 个
- 客服(Support):8 个
- 法务(Legal):6 个
- HR(Human Resources):9 个
- 游戏(Game):15 个
- 安全(Security):12 个
- 金融(Finance):10 个
- 数据(Data):18 个
- 运营(Operations):14 个
- 客服(Support):8 个
- 法务(Legal):6 个
- HR(Human Resources):9 个
配置与环境变量
配置与环境变量
Agency Orchestrator 配置
Agency Orchestrator 配置
创建 :
~/.agency-orchestrator/config.yamlyaml
undefined创建 :
~/.agency-orchestrator/config.yamlyaml
undefinedLLM 配置
LLM 配置
llm:
provider: deepseek # deepseek, claude, openai, gemini
api_key_env: DEEPSEEK_API_KEY # 环境变量名称
model: deepseek-chat
temperature: 0.7
max_tokens: 4000
llm:
provider: deepseek # deepseek, claude, openai, gemini
api_key_env: DEEPSEEK_API_KEY # 环境变量名称
model: deepseek-chat
temperature: 0.7
max_tokens: 4000
智能体路径
智能体路径
agents:
base_dir: ~/.openclaw/souls # 或 ~/.claude/agents
auto_discover: true
agents:
base_dir: ~/.openclaw/souls # 或 ~/.claude/agents
auto_discover: true
输出配置
输出配置
output:
default_dir: ./agency-output
format: markdown # markdown, json, html
include_metadata: true
output:
default_dir: ./agency-output
format: markdown # markdown, json, html
include_metadata: true
并行执行配置
并行执行配置
execution:
max_parallel: 3
timeout: 300 # 秒
retry: 2
undefinedexecution:
max_parallel: 3
timeout: 300 # 秒
retry: 2
undefined环境变量设置
环境变量设置
bash
undefinedbash
undefined.env 文件
.env 文件
DEEPSEEK_API_KEY=your_deepseek_api_key
CLAUDE_API_KEY=your_claude_api_key
OPENAI_API_KEY=your_openai_api_key
GEMINI_API_KEY=your_gemini_api_key
DEEPSEEK_API_KEY=your_deepseek_api_key
CLAUDE_API_KEY=your_claude_api_key
OPENAI_API_KEY=your_openai_api_key
GEMINI_API_KEY=your_gemini_api_key
飞书/钉钉集成
飞书/钉钉集成
FEISHU_APP_ID=your_feishu_app_id
FEISHU_APP_SECRET=your_feishu_app_secret
DINGTALK_APP_KEY=your_dingtalk_app_key
DINGTALK_APP_SECRET=your_dingtalk_app_secret
FEISHU_APP_ID=your_feishu_app_id
FEISHU_APP_SECRET=your_feishu_app_secret
DINGTALK_APP_KEY=your_dingtalk_app_key
DINGTALK_APP_SECRET=your_dingtalk_app_secret
微信小程序
微信小程序
WECHAT_APP_ID=your_wechat_app_id
WECHAT_APP_SECRET=your_wechat_app_secret
undefinedWECHAT_APP_ID=your_wechat_app_id
WECHAT_APP_SECRET=your_wechat_app_secret
undefined常见使用模式
常见使用模式
模式一:单智能体咨询
模式一:单智能体咨询
切换到安全工程师角色
请审查以下代码的安全问题:
[粘贴代码]切换到安全工程师角色
请审查以下代码的安全问题:
[粘贴代码]模式二:智能体切换
模式二:智能体切换
激活前端开发者
[完成 UI 开发后]
现在切换到后端架构师,设计对应的 API激活前端开发者
[完成 UI 开发后]
现在切换到后端架构师,设计对应的 API模式三:多智能体协作(通过 Agency Orchestrator)
模式三:多智能体协作(通过 Agency Orchestrator)
bash
undefinedbash
undefined一句话描述复杂需求
一句话描述复杂需求
ao compose "开发一个小红书运营工具,包含内容创作、数据分析、KOL 推荐功能" --run
ao compose "开发一个小红书运营工具,包含内容创作、数据分析、KOL 推荐功能" --run
自动选角:
自动选角:
- 小红书运营专家(需求分析)
- 小红书运营专家(需求分析)
- 前端开发者(UI 实现)
- 前端开发者(UI 实现)
- 后端架构师(API 设计)
- 后端架构师(API 设计)
- 数据工程师(数据管线)
- 数据工程师(数据管线)
undefinedundefined模式四:使用预设模板
模式四:使用预设模板
bash
undefinedbash
undefined电商小程序全栈开发
电商小程序全栈开发
ao run --template wechat-mini-program-ecommerce
ao run --template wechat-mini-program-ecommerce
工业上位机开发
工业上位机开发
ao run --template industrial-hmi-qt
ao run --template industrial-hmi-qt
小红书营销全流程
小红书营销全流程
ao run --template xiaohongshu-full-campaign
undefinedao run --template xiaohongshu-full-campaign
undefined故障排除
故障排除
问题 1:智能体未加载
问题 1:智能体未加载
症状:在 AI 工具中无法激活智能体
解决方案:
bash
undefined症状:在 AI 工具中无法激活智能体
解决方案:
bash
undefined检查安装路径
检查安装路径
ls ~/.claude/agents/
ls ~/.openclaw/souls/
ls ~/.claude/agents/
ls ~/.openclaw/souls/
重新安装
重新安装
./scripts/install.sh --tool claude-code --force
./scripts/install.sh --tool claude-code --force
重启 AI 工具
重启 AI 工具
undefinedundefined问题 2:OpenClaw 格式转换失败
问题 2:OpenClaw 格式转换失败
症状: 报错
convert.sh解决方案:
bash
undefined症状: 报错
convert.sh解决方案:
bash
undefined确保有执行权限
确保有执行权限
chmod +x scripts/convert.sh
chmod +x scripts/convert.sh
手动指定输出目录
手动指定输出目录
./scripts/convert.sh --tool openclaw --output ./converted
./scripts/convert.sh --tool openclaw --output ./converted
检查依赖
检查依赖
which python3 # 需要 Python 3.7+
undefinedwhich python3 # 需要 Python 3.7+
undefined问题 3:Agency Orchestrator 无法连接 LLM
问题 3:Agency Orchestrator 无法连接 LLM
症状: 报 API 错误
ao compose解决方案:
bash
undefined症状: 报 API 错误
ao compose解决方案:
bash
undefined检查环境变量
检查环境变量
echo $DEEPSEEK_API_KEY
echo $DEEPSEEK_API_KEY
测试连接
测试连接
ao test-connection --provider deepseek
ao test-connection --provider deepseek
切换到免费 LLM
切换到免费 LLM
ao compose "任务描述" --llm gemini-cli --run
undefinedao compose "任务描述" --llm gemini-cli --run
undefined问题 4:中文乱码
问题 4:中文乱码
症状:智能体输出乱码
解决方案:
bash
undefined症状:智能体输出乱码
解决方案:
bash
undefined设置终端编码
设置终端编码
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8
检查文件编码
检查文件编码
file -i marketing/marketing-xiaohongshu-operator.md
file -i marketing/marketing-xiaohongshu-operator.md
应显示:charset=utf-8
应显示:charset=utf-8
undefinedundefined问题 5:工作流执行超时
问题 5:工作流执行超时
症状:Agency Orchestrator 任务超时
解决方案:
yaml
undefined症状:Agency Orchestrator 任务超时
解决方案:
yaml
undefined在 workflow.yaml 中增加超时时间
在 workflow.yaml 中增加超时时间
config:
timeout: 600 # 从 300 秒增加到 600 秒
config:
timeout: 600 # 从 300 秒增加到 600 秒
或减少并行度
或减少并行度
config:
max_parallel: 1 # 串行执行,避免 API 限流
undefinedconfig:
max_parallel: 1 # 串行执行,避免 API 限流
undefined高级技巧
高级技巧
自定义智能体
自定义智能体
创建 :
custom/my-agent.mdmarkdown
---
name: 我的自定义专家
role: 特定领域专家
department: 自定义部门
---创建 :
custom/my-agent.mdmarkdown
---
name: 我的自定义专家
role: 特定领域专家
department: 自定义部门
---角色定义
角色定义
你是一位...
你是一位...
核心能力
核心能力
- ...
- ...
- ...
- ...
工作流程
工作流程
- 步骤 1:...
- 步骤 2:...
- 步骤 1:...
- 步骤 2:...
交付物
交付物
- ...
安装:
```bash
cp custom/my-agent.md ~/.claude/agents/- ...
安装:
```bash
cp custom/my-agent.md ~/.claude/agents/组合使用智能体
组合使用智能体
yaml
undefinedyaml
undefinedcombo-workflow.yaml
combo-workflow.yaml
name: 全栈开发+运营组合
agents:
- role: engineering/engineering-frontend-developer.md
- role: engineering/engineering-backend-architect.md
- role: marketing/marketing-xiaohongshu-operator.md
- role: design/design-ui-designer.md
undefinedname: 全栈开发+运营组合
agents:
- role: engineering/engineering-frontend-developer.md
- role: engineering/engineering-backend-architect.md
- role: marketing/marketing-xiaohongshu-operator.md
- role: design/design-ui-designer.md
undefined批量转换智能体
批量转换智能体
bash
undefinedbash
undefined转换所有智能体为 Cursor 格式
转换所有智能体为 Cursor 格式
for dept in engineering design marketing product; do
./scripts/convert.sh --tool cursor --input $dept --output ./cursor-agents/$dept
done
undefinedfor dept in engineering design marketing product; do
./scripts/convert.sh --tool cursor --input $dept --output ./cursor-agents/$dept
done
undefined资源链接
资源链接
- GitHub 仓库: https://github.com/jnMetaCode/agency-agents-zh
- Agency Orchestrator: https://github.com/jnMetaCode/agency-orchestrator
- 上游英文版: https://github.com/msitarzewski/agency-agents
- 配套书籍: https://book.aibuzhiyu.com/(AI 编程实战方法论)
- GitHub 仓库: https://github.com/jnMetaCode/agency-agents-zh
- Agency Orchestrator: https://github.com/jnMetaCode/agency-orchestrator
- 上游英文版: https://github.com/msitarzewski/agency-agents
- 配套书籍: https://book.aibuzhiyu.com/(AI 编程实战方法论)
支持的 AI 工具完整列表
支持的 AI 工具完整列表
- OpenClaw ⭐ 推荐(多智能体协作)
- Claude Code(Anthropic 官方)
- Cursor(智能 IDE)
- GitHub Copilot
- Gemini CLI(Google)
- Qwen Code(阿里云)
- Codex CLI(OpenAI)
- Aider(开源 AI 编程助手)
- Windsurf
- Antigravity
- Kiro(Amazon)
- Trae
- OpenCode
- DeerFlow 2.0(字节跳动)
- WorkBuddy(腾讯)
- Hermes Agent(NousResearch)
- Qoder
快速开始:克隆仓库 → 运行 → 在 AI 工具中激活智能体 → 开始使用 215 个专家角色!
./scripts/install.sh- OpenClaw ⭐ 推荐(多智能体协作)
- Claude Code(Anthropic 官方)
- Cursor(智能 IDE)
- GitHub Copilot
- Gemini CLI(Google)
- Qwen Code(阿里云)
- Codex CLI(OpenAI)
- Aider(开源 AI 编程助手)
- Windsurf
- Antigravity
- Kiro(Amazon)
- Trae
- OpenCode
- DeerFlow 2.0(字节跳动)
- WorkBuddy(腾讯)
- Hermes Agent(NousResearch)
- Qoder
快速开始:克隆仓库 → 运行 → 在 AI 工具中激活智能体 → 开始使用 215 个专家角色!
./scripts/install.sh