agency-agents-zh-skill

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

agency-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
undefined
bash
undefined

克隆仓库

克隆仓库

自动检测已安装工具并安装

自动检测已安装工具并安装

./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.md
(身份人设)+
AGENTS.md
(业务能力)+
IDENTITY.md
(简介)
bash
undefined
OpenClaw 使用三文件结构:
SOUL.md
(身份人设)+
AGENTS.md
(业务能力)+
IDENTITY.md
(简介)
bash
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 网关后生效

undefined
undefined

方式三:手动安装(Claude Code / Copilot)

方式三:手动安装(Claude Code / Copilot)

bash
undefined
bash
undefined

Claude 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/
undefined
cp -r marketing/*.md ~/.cursor/agents/
undefined

使用智能体

使用智能体

在 AI 编程工具中激活

在 AI 编程工具中激活

安装后,在任意 AI 编程工具中通过自然语言激活:
激活前端开发者模式,帮我构建一个 React 组件
切换到小红书运营专家角色,帮我策划一个产品种草方案
使用安全工程师角色审查这段代码的安全漏洞
安装后,在任意 AI 编程工具中通过自然语言激活:
激活前端开发者模式,帮我构建一个 React 组件
切换到小红书运营专家角色,帮我策划一个产品种草方案
使用安全工程师角色审查这段代码的安全漏洞

查看可用智能体列表

查看可用智能体列表

bash
undefined
bash
undefined

列出所有智能体

列出所有智能体

ls -R engineering/ design/ marketing/ product/ game/ security/ finance/ data/
ls -R engineering/ design/ marketing/ product/ game/ security/ finance/ data/

查看工程类智能体

查看工程类智能体

ls engineering/
undefined
ls engineering/
undefined

Agency Orchestrator 多智能体编排

Agency Orchestrator 多智能体编排

Agency Orchestrator 让多个智能体协作完成复杂任务。
Agency Orchestrator 让多个智能体协作完成复杂任务。

安装 Agency Orchestrator

安装 Agency Orchestrator

bash
npm install -g agency-orchestrator
bash
npm install -g agency-orchestrator

基本使用

基本使用

bash
undefined
bash
undefined

一句话描述需求,自动选角+编排+执行

一句话描述需求,自动选角+编排+执行

ao compose "帮我写一篇关于 AI Agent 的深度分析文章" --run
ao compose "帮我写一篇关于 AI Agent 的深度分析文章" --run

输出:

输出:

🎭 自动选角 → 叙事学家 + 心理学家 + 内容创作者

🎭 自动选角 → 叙事学家 + 心理学家 + 内容创作者

📊 自动编排 → DAG 工作流,并行执行

📊 自动编排 → DAG 工作流,并行执行

✅ 自动交付 → 完整成果

✅ 自动交付 → 完整成果

undefined
undefined

使用预设模板

使用预设模板

bash
undefined
bash
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 "产品=智能手表,平台=小红书"
undefined
ao run --template social-media-campaign --params "产品=智能手表,平台=小红书"
undefined

YAML 工作流配置

YAML 工作流配置

创建
workflow.yaml
yaml
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.yaml
yaml
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
undefined
bash
undefined

工作流失败后,单独重跑某个步骤

工作流失败后,单独重跑某个步骤

ao resume workflow.yaml --step content_creator
ao resume workflow.yaml --step content_creator

从某个步骤开始继续

从某个步骤开始继续

ao resume workflow.yaml --from ad_planner
undefined
ao 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.yaml
yaml
undefined
创建
~/.agency-orchestrator/config.yaml
yaml
undefined

LLM 配置

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
undefined
execution: max_parallel: 3 timeout: 300 # 秒 retry: 2
undefined

环境变量设置

环境变量设置

bash
undefined
bash
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
undefined
WECHAT_APP_ID=your_wechat_app_id WECHAT_APP_SECRET=your_wechat_app_secret
undefined

常见使用模式

常见使用模式

模式一:单智能体咨询

模式一:单智能体咨询

切换到安全工程师角色
请审查以下代码的安全问题:
[粘贴代码]
切换到安全工程师角色
请审查以下代码的安全问题:
[粘贴代码]

模式二:智能体切换

模式二:智能体切换

激活前端开发者
[完成 UI 开发后]
现在切换到后端架构师,设计对应的 API
激活前端开发者
[完成 UI 开发后]
现在切换到后端架构师,设计对应的 API

模式三:多智能体协作(通过 Agency Orchestrator)

模式三:多智能体协作(通过 Agency Orchestrator)

bash
undefined
bash
undefined

一句话描述复杂需求

一句话描述复杂需求

ao compose "开发一个小红书运营工具,包含内容创作、数据分析、KOL 推荐功能" --run
ao compose "开发一个小红书运营工具,包含内容创作、数据分析、KOL 推荐功能" --run

自动选角:

自动选角:

- 小红书运营专家(需求分析)

- 小红书运营专家(需求分析)

- 前端开发者(UI 实现)

- 前端开发者(UI 实现)

- 后端架构师(API 设计)

- 后端架构师(API 设计)

- 数据工程师(数据管线)

- 数据工程师(数据管线)

undefined
undefined

模式四:使用预设模板

模式四:使用预设模板

bash
undefined
bash
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
undefined
ao 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 工具

undefined
undefined

问题 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+
undefined
which python3 # 需要 Python 3.7+
undefined

问题 3:Agency Orchestrator 无法连接 LLM

问题 3:Agency Orchestrator 无法连接 LLM

症状
ao compose
报 API 错误
解决方案
bash
undefined
症状
ao compose
报 API 错误
解决方案
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
undefined
ao 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

undefined
undefined

问题 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 限流
undefined
config: max_parallel: 1 # 串行执行,避免 API 限流
undefined

高级技巧

高级技巧

自定义智能体

自定义智能体

创建
custom/my-agent.md
markdown
---
name: 我的自定义专家
role: 特定领域专家
department: 自定义部门
---
创建
custom/my-agent.md
markdown
---
name: 我的自定义专家
role: 特定领域专家
department: 自定义部门
---

角色定义

角色定义

你是一位...
你是一位...

核心能力

核心能力

  1. ...
  2. ...
  1. ...
  2. ...

工作流程

工作流程

  • 步骤 1:...
  • 步骤 2:...
  • 步骤 1:...
  • 步骤 2:...

交付物

交付物

  • ...

安装:
```bash
cp custom/my-agent.md ~/.claude/agents/
  • ...

安装:
```bash
cp custom/my-agent.md ~/.claude/agents/

组合使用智能体

组合使用智能体

yaml
undefined
yaml
undefined

combo-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
undefined
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
undefined

批量转换智能体

批量转换智能体

bash
undefined
bash
undefined

转换所有智能体为 Cursor 格式

转换所有智能体为 Cursor 格式

for dept in engineering design marketing product; do ./scripts/convert.sh --tool cursor --input $dept --output ./cursor-agents/$dept done
undefined
for dept in engineering design marketing product; do ./scripts/convert.sh --tool cursor --input $dept --output ./cursor-agents/$dept done
undefined

资源链接

资源链接

支持的 AI 工具完整列表

支持的 AI 工具完整列表

  1. OpenClaw ⭐ 推荐(多智能体协作)
  2. Claude Code(Anthropic 官方)
  3. Cursor(智能 IDE)
  4. GitHub Copilot
  5. Gemini CLI(Google)
  6. Qwen Code(阿里云)
  7. Codex CLI(OpenAI)
  8. Aider(开源 AI 编程助手)
  9. Windsurf
  10. Antigravity
  11. Kiro(Amazon)
  12. Trae
  13. OpenCode
  14. DeerFlow 2.0(字节跳动)
  15. WorkBuddy(腾讯)
  16. Hermes Agent(NousResearch)
  17. Qoder

快速开始:克隆仓库 → 运行
./scripts/install.sh
→ 在 AI 工具中激活智能体 → 开始使用 215 个专家角色!
  1. OpenClaw ⭐ 推荐(多智能体协作)
  2. Claude Code(Anthropic 官方)
  3. Cursor(智能 IDE)
  4. GitHub Copilot
  5. Gemini CLI(Google)
  6. Qwen Code(阿里云)
  7. Codex CLI(OpenAI)
  8. Aider(开源 AI 编程助手)
  9. Windsurf
  10. Antigravity
  11. Kiro(Amazon)
  12. Trae
  13. OpenCode
  14. DeerFlow 2.0(字节跳动)
  15. WorkBuddy(腾讯)
  16. Hermes Agent(NousResearch)
  17. Qoder

快速开始:克隆仓库 → 运行
./scripts/install.sh
→ 在 AI 工具中激活智能体 → 开始使用 215 个专家角色!