SuperAPI AI 工具集

agency-agents-zh-skill

智能体与模型

查看项目

更新于 10-15 15:14

技能介绍

agency-agents-zh 是一个中文 AI 智能体角色库,为 AI 编程工具提供 215 个即插即用的专家角色,覆盖 18 个专业部门。根据资料,它完整翻译了上游 165 个角色,并新增 50 个中国市场原创智能体。

用途

该角色库用于在 AI 编程工具中以自然语言激活特定专家角色,例如“激活前端开发者模式,帮我构建一个 React 组件”“切换到小红书运营专家角色,帮我策划一个产品种草方案”或“使用安全工程师角色审查这段代码的安全漏洞”。其目标是在不同专业任务中提供带有明确身份、工作流程和交付物的角色化助手。

主要能力

  • 215 个专家角色:每个智能体有明确的身份、工作流程和交付物。
  • 17 种工具支持:包括 Claude Code、Cursor、Copilot、OpenClaw、Gemini CLI、Qwen、Codex 等。
  • 50 个中国市场原创智能体:如小红书运营、抖音种草、微信小程序、飞书集成、钉钉开发等。
  • 18 个专业部门:工程、设计、营销、产品、游戏、安全、金融、数据等。
  • 自动化编排:配合 Agency Orchestrator 实现多智能体协作。

资料中列出的部门与数量为:工程部 33 个、设计部 18 个、营销部 40 个、产品部 22 个、游戏 15 个、安全 12 个、金融 10 个、数据 18 个、运营 14 个、客服 8 个、法务 6 个、HR 9 个。

资料给出的核心智能体示例包括:小红书运营专家(用户画像分析、内容选题矩阵、笔记范例、KOL 合作清单及报价、数据监控仪表盘);上位机工程师(Qt/QML UI 开发、QSerialPort/QModbusTCP 通信、QChart 实时曲线、SQLite 数据存储、多语言);微信小程序开发者(WXML/WXSS 组件化开发、微信支付集成、云开发数据库、分包加载优化、用户授权流程);飞书集成开发工程师(飞书机器人开发、审批流接口、多维表格操作、飞书文档 API、事件订阅);前端开发者(React/Vue 组件开发、响应式设计、性能优化、状态管理、类型安全)。

使用方式

安装方式一:一键安装脚本

git clone https://github.com/jnMetaCode/agency-agents-zh.git
cd agency-agents-zh
./scripts/install.sh
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool claude-code
./scripts/install.sh --tool cursor
./scripts/install.sh --tool copilot
./scripts/install.sh --tool gemini-cli
./scripts/install.sh --tool qwen
./scripts/install.sh --tool codex
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf
./scripts/install.sh --tool hermes

安装方式二:OpenClaw 专用安装(推荐),采用 SOUL.md + AGENTS.md + IDENTITY.md 三文件结构:

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

智能体文件安装到 ~/.openclaw/souls/,重启 OpenClaw 网关后生效。

安装方式三:手动安装,例如 Claude Code 使用 cp -r marketing/*.md ~/.claude/agents/;GitHub Copilot 使用 cp -r marketing/*.md ~/.github/copilot/agents/;Cursor 使用 cp -r marketing/*.md ~/.cursor/agents/。

安装后在 AI 编程工具中通过自然语言激活角色。可用 ls -R engineering/ design/ marketing/ product/ game/ security/ finance/ data/ 列出所有智能体。

Agency Orchestrator 多智能体编排:通过 npm install -g agency-orchestrator 安装。基本用法为 ao compose "帮我写一篇关于 AI Agent 的深度分析文章" --run;可查看模板 ao templates,使用预设模板如 ao run --template web-app-mvp --params "项目名称=电商平台,技术栈=Next.js",或使用 YAML 工作流配置(定义 agents、role、task、depends_on 及 config)。支持断点续跑:ao resume workflow.yaml --step content_creator、ao resume workflow.yaml --from ad_planner。

配置

Agency Orchestrator 配置位于 ~/.agency-orchestrator/config.yaml,可配置 LLM(provider、api_key_env、model、temperature、max_tokens)、智能体路径(base_dir、auto_discover)、输出(default_dir、format、include_metadata)、并行执行(max_parallel、timeout、retry)。环境变量示例包括 DEEPSEEK_API_KEY、CLAUDE_API_KEY、OPENAI_API_KEY、GEMINI_API_KEY、FEISHU_APP_ID、FEISHU_APP_SECRET、DINGTALK_APP_KEY、DINGTALK_APP_SECRET、WECHAT_APP_ID、WECHAT_APP_SECRET。

适用场景

  • 单智能体咨询:切换到某角色后处理具体任务。
  • 智能体切换:完成 UI 开发后切换到后端架构师设计 API。
  • 多智能体协作:用 Agency Orchestrator 一句话描述复杂需求,自动选角、编排、执行。
  • 预设模板:如电商小程序全栈开发、工业上位机开发、小红书营销全流程。

限制

资料提到若干故障排除项,包括智能体未加载、OpenClaw 格式转换失败、Agency Orchestrator 无法连接 LLM、中文乱码、工作流执行超时。convert.sh 需要 Python 3.7+;中文乱码需设置终端编码为 UTF-8;超时可通过增大 timeout 或减少 max_parallel 解决。资料未说明各智能体的收费、价格或效果保证。