[OpenClaw] Skill Agency-agents 介绍分析与使用

comedate2026-05-30 8:52

agency-agents 技术文档

创建日期：2026-04-26

版本：1.0.0

状态：生产就绪

📚 目录

  1. 概述
  2. 核心原理
  3. 系统架构
  4. 使用方法
  5. 技术实现
  6. 使用案例
  7. 最佳实践
  8. 故障排除

概述

产品定位

agency-agents 是一个完整的 AI 代理团队系统，包含 61 个专业 Agent ，分为 8 大业务部门，可独立完成专业任务或协同完成复杂项目。

核心价值

  • 专业化 - 每个 Agent 深耕特定领域，不是通用模板
  • 人格化 - 独特的沟通风格和工作方式
  • 结果导向 - 每个 Agent 都有明确的交付物
  • 开箱即用 - 完整的工作流和最佳实践

适用场景

  • 创业公司 MVP 开发
  • 企业级功能开发
  • 营销活动执行
  • 产品设计与规划
  • 测试与质量保证
  • 项目管理与协调

核心原理

设计理念

1. 专业化分工

每个 Agent 都有明确的职责范围和专业技能：

复制代码 
通用 AI 助手 → 专注特定领域 → 深度专业知识 + 人格化

示例对比：

通用助手 Frontend Developer Agent
基础 React 知识 深度 React 生态知识
通用代码建议 性能优化最佳实践
简单组件 可复用组件库设计
基础测试 完整测试策略
2. 人格化设计

每个 Agent 有独特的人格特质：

  • Frontend Developer: 注重细节、性能导向、用户中心
  • Backend Architect: 系统化思维、安全优先、可扩展性驱动
  • Growth Hacker: 数据驱动、实验导向、增长黑客思维
  • Reality Checker: 质量导向、批判性思维、严格标准
3. 编排器协调

Agents Orchestrator 作为核心调度引擎：

复制代码 
用户需求 → 任务分解 → Agent 调度 → 质量验证 → 交付

关键机制：

  • 流水线管理 - 管理完整工作流
  • 质量门禁 - 每个任务必须通过 QA
  • 自动重试 - 失败任务带反馈返回开发（最多 3 次）
  • 上下文传递 - 在 Agent 之间传递完整上下文

技术架构

三层记忆系统
复制代码 
HOT Memory (memory.md ≤100 行)
    ↓
WARM Memory (projects/domains)
    ↓
COLD Memory (archive)

生命周期管理：

  • 3 次使用 → 确认 → HOT
  • 30 天未用 → WARM
  • 90 天未用 → COLD
命名空间继承
复制代码 
global → domain → project

优先级：最具体的命名空间优先级最高

学习触发机制
  • 显式修正 - 高置信度（"No...", "Actually...", "Always..."）
  • 隐式模式 - 需 3 次确认

系统架构

部门结构

部门 Agent 数量 核心职责
Engineering 7 工程开发
Design 7 设计相关
Marketing 8 市场营销
Product 3 产品管理
Project Management 5 项目管理
Testing 7 测试 QA
Support 6 业务支持
Specialized 6 专业领域

Agent 完整列表

💻 Engineering（工程部）
Agent 职责 技术栈
frontend-developer 前端开发专家 React/Vue/Angular/Svelte
backend-architect 后端架构师 API/数据库/云
mobile-app-builder 移动端开发 iOS/Android/跨平台
ai-engineer AI 工程师 ML/深度学习/AI 集成
devops-automator DevOps 自动化 CI/CD/基础设施
rapid-prototyper 快速原型 MVP/POC
senior-developer 高级开发 复杂实现/架构决策
🎨 Design（设计部）
Agent 职责 核心能力
ui-designer UI 设计师 视觉/组件/设计系统
ux-researcher UX 研究员 用户研究/可用性测试
ux-architect UX 架构师 技术架构/CSS 系统
brand-guardian 品牌守护者 品牌策略/一致性
visual-storyteller 视觉叙事者 视觉故事/多媒体
whimsy-injector 趣味注入师 微交互/品牌个性
image-prompt-engineer 图像提示工程师 AI 图像生成
📢 Marketing（市场部）
Agent 职责 核心能力
growth-hacker 增长黑客 用户获取/转化优化
content-creator 内容创作者 多平台内容/编辑日历
twitter-engager Twitter 互动专家 实时互动/思想领导
tiktok-strategist TikTok 策略师 病毒内容/算法优化
instagram-curator Instagram 策划师 视觉叙事/社群
reddit-community-builder Reddit 社群建设者 社群运营
app-store-optimizer 应用商店优化师 ASO/转化
social-media-strategist 社交媒体策略师 跨平台策略
📊 Product（产品部）
Agent 职责 核心能力
sprint-prioritizer 冲刺优先级专家 敏捷规划
trend-researcher 趋势研究员 市场情报/竞争分析
feedback-synthesizer 反馈整合师 用户反馈分析
🎬 Project Management（项目管理部）
Agent 职责 核心能力
studio-producer 工作室制作人 高层协调/组合管理
project-shepherd 项目协调员 跨职能协调
studio-operations 工作室运营 日常效率/流程优化
experiment-tracker 实验追踪师 A/B 测试
senior-pm 高级项目经理 范围规划/任务分解
🧪 Testing（测试部）
Agent 职责 核心能力
evidence-collector 证据收集师 截图 QA/视觉验证
reality-checker 现实检查员 质量认证/发布审批
test-results-analyzer 测试结果分析师 测试评估
performance-benchmarker 性能基准师 性能测试
api-tester API 测试师 API 验证/集成测试
tool-evaluator 工具评估师 技术评估
workflow-optimizer 工作流优化师 流程分析
🛟 Support（支持部）
Agent 职责 核心能力
support-responder 客服响应师 客户服务
analytics-reporter 分析报告师 数据分析/仪表板
finance-tracker 财务追踪师 财务规划/预算
infrastructure-maintainer 基础设施维护师 系统可靠性
legal-compliance-checker 法律合规师 合规/法规
executive-summary-generator 高管摘要生成师 C-suite 沟通
🎯 Specialized（特别部门）
Agent 职责 核心能力
orchestrator Agent 编排器 多 Agent 调度核心
data-analytics-reporter 数据分析报告师 商业智能
lsp-index-engineer LSP/索引工程师 代码智能
sales-data-extraction-agent 销售数据提取师 数据提取
data-consolidation-agent 数据整合师 数据整合
report-distribution-agent 报告分发师 报告分发

使用方法

方式 1：单个 Agent

bash 复制代码 
# 语法
/openclaw skill use agency-agents --agent <agent-name> "<任务描述>"

# 示例 1：前端开发
/openclaw skill use agency-agents --agent frontend-developer "帮我创建一个 React 登录页面组件"

# 示例 2：后端架构
/openclaw skill use agency-agents --agent backend-architect "设计一个电商平台的 API 架构"

# 示例 3：增长策略
/openclaw skill use agency-agents --agent growth-hacker "为我的 SaaS 产品设计增长策略"

方式 2：编排器（推荐）

bash 复制代码 
# 自动调度多个 Agent 完成复杂项目
/openclaw skill use agency-agents --agent orchestrator "开发一个完整的电商网站，包括前端、后端和营销策略"

编排器优势：

  • 自动任务分解
  • 智能 Agent 调度
  • 质量门禁保障
  • 完整交付报告

方式 3：部门协作

bash 复制代码 
# 激活整个部门的 Agent 协作
/openclaw skill use agency-agents --department engineering "开发一个完整的 Web 应用"
/openclaw skill use agency-agents --department marketing "策划并执行一次营销活动"

配置选项

bash 复制代码 
# 设置默认部门
AGENCY_AGENTS_DEFAULT_DEPARTMENT=engineering

# 设置质量检查严格度（1-5）
AGENCY_AGENTS_QA_LEVEL=3

# 设置最大重试次数
AGENCY_AGENTS_MAX_RETRIES=3

# 启用详细日志
AGENCY_AGENTS_VERBOSE=true

技术实现

Agent 定义结构

每个 Agent 由以下文件定义：

复制代码 
agents/
├── engineering/
│   ├── frontend-developer.md
│   └── backend-architect.md
├── design/
├── marketing/
└── ...

Frontend Developer 示例

核心职责
markdown 复制代码 
### 编辑器集成工程
- 构建带导航命令的编辑器扩展
- 实现 WebSocket/RPC 桥接
- 处理编辑器协议 URIs

### 创建现代 Web 应用
- 使用 React/Vue/Angular/Svelte
- 响应式、高性能 Web 应用
- 组件库和设计系统

### 优化性能和用户体验
- Core Web Vitals 优化
- PWA 离线能力
- 代码分割和懒加载

### 维护代码质量
- 单元测试和集成测试
- TypeScript 类型安全
- CI/CD 集成
交付物模板
markdown 复制代码 
# [项目名称] 前端实现

## 🎯 项目概述
## 🛠️ 技术栈
## 📁 项目结构
## 🎨 组件清单
## ⚡ 性能优化
## ♿ 无障碍检查
## 🧪 测试覆盖
## 📦 构建和部署
## 🚀 部署指南
## 💡 后续优化建议

Backend Architect 示例

核心职责
markdown 复制代码 
### API 设计与开发
- RESTful/GraphQL/gRPC API
- JWT/OAuth2/Session 认证
- OpenAPI/Swagger 文档
- 速率限制和配额管理

### 数据库架构
- 关系型/NoSQL 数据库
- 索引和查询优化
- 数据迁移策略
- 备份和恢复计划

### 微服务架构
- 领域驱动设计
- 服务间通信
- 服务发现和注册
- 分布式追踪

### 云基础设施
- AWS/GCP/Azure/阿里云
- Docker/Kubernetes
- Terraform/CloudFormation
- CI/CD 流水线
交付物模板
markdown 复制代码 
# [项目名称] - 后端架构文档

## 🎯 系统概述
## 🏗️ 架构决策
## 📊 数据模型
## 🔌 API 设计
## 🔐 安全策略
## ⚡ 性能优化
## 📈 监控和告警
## 🚀 部署指南
## 📝 运维手册

Orchestrator 编排器

核心工作流
复制代码 
阶段 1: 项目分析与规划
    ↓
阶段 2: 技术架构设计
    ↓
阶段 3: 开发-QA 持续循环（每个任务）
    ├─ 开发实现
    ├─ 质量验证
    └─ 循环决策（PASS→下一任务，FAIL→重试≤3）
    ↓
阶段 4: 最终集成与验证
质量门禁机制
markdown 复制代码 
### 任务级验证
- 每个实现任务必须通过 QA 才能继续
- 自动重试逻辑：失败任务带具体反馈返回开发
- 质量门禁：不达到质量标准不推进
- 失败处理：最大重试次数限制，超限升级

### 重试逻辑
1. 第一次 QA FAIL → 带反馈返回开发
2. 第二次 QA FAIL → 再次带反馈返回开发
3. 第三次 QA FAIL → 生成详细失败报告并升级
决策逻辑
markdown 复制代码 
### 当前任务验证流程

步骤 1: 开发实现
- 根据任务类型选择合适的开发 Agent
- 提供完整上下文和具体指令
- 等待开发完成
- 验证实现完整性

步骤 2: 质量验证
- 选择合适的测试 Agent 进行任务专属测试
- 需要截图证据用于验证
- 获取清晰的 PASS/FAIL 决定和反馈

步骤 3: 循环决策
**如果 QA 结果 = PASS:**
- 标记当前任务为已验证
- 推进到任务列表中的下一任务
- 重置重试计数器

**如果 QA 结果 = FAIL:**
- 增加重试计数器
- 如果重试 < 3: 带 QA 反馈返回开发 Agent
- 如果重试 >= 3: 生成详细失败报告并升级
- 保持当前任务焦点

使用案例

案例 1：创业公司 MVP 开发

场景

用户需要快速开发一个 SaaS 产品 MVP，包括：

  • 前端：React + Tailwind CSS
  • 后端：Node.js + Express
  • 数据库：PostgreSQL
  • 功能：用户注册登录、核心业务功能、支付集成
使用编排器
bash 复制代码 
/openclaw skill use agency-agents --agent orchestrator "帮我开发一个 SaaS 产品 MVP，
包括：
- 前端：React + Tailwind CSS，需要用户登录、仪表盘、核心功能页面
- 后端：Node.js + Express，RESTful API
- 数据库：PostgreSQL，用户、订单、产品表
- 支付：Stripe 集成
- 部署：Vercel + Railway"
预期流程
  1. 项目规划 - Senior PM 分解任务（约 15-20 个）
  2. 架构设计 - Backend Architect 设计 API 和数据库
  3. 开发循环 - Frontend Developer + Backend Architect + QA
    • 用户认证模块 → QA 验证 → PASS
    • 仪表盘模块 → QA 验证 → PASS
    • 核心功能模块 → QA 验证 → PASS
    • 支付集成 → QA 验证 → PASS
  4. 最终集成 - 系统测试、性能测试、安全测试
  5. 交付报告 - 完整交付清单和质量报告
交付成果
  • ✅ 可运行的完整应用
  • ✅ 源代码和部署脚本
  • ✅ API 文档（OpenAPI）
  • ✅ 数据库迁移脚本
  • ✅ 测试报告
  • ✅ 部署指南

案例 2：营销活动执行

场景

用户需要为新产品发布策划和执行一次营销活动，包括：

  • 社交媒体内容
  • Twitter/Instagram/TikTok 策略
  • 内容营销
  • 社群运营
使用编排器
bash 复制代码 
/openclaw skill use agency-agents --agent orchestrator "为我的新 SaaS 产品发布
策划和执行一次营销活动，包括：
- Twitter 策略和互动计划
- Instagram 视觉内容
- TikTok 病毒内容
- 博客文章和教程
- Reddit 社群运营
- 邮件营销"
预期流程
  1. 策略规划 - Growth Hacker 制定整体策略
  2. 内容创作 - Content Creator 创建内容日历
  3. 平台执行
    • Twitter Engager → 制定互动计划
    • Instagram Curator → 视觉内容规划
    • TikTok Strategist → 病毒内容策略
    • Reddit Community Builder → 社群运营计划
  4. 质量验证 - Reality Checker 审核内容质量
  5. 交付报告 - 完整营销计划和执行指南
交付成果
  • ✅ 营销策略文档
  • ✅ 内容日历（30 天）
  • ✅ 各平台具体执行方案
  • ✅ 视觉内容创意
  • ✅ 社群运营指南
  • ✅ KPI 追踪模板

案例 3：企业级功能开发

场景

用户需要在现有企业应用中添加复杂功能模块，包括：

  • 新的管理后台
  • 数据报表功能
  • 权限管理系统
  • 审计日志
使用编排器
bash 复制代码 
/openclaw skill use agency-agents --agent orchestrator "在现有企业应用中添加
新的管理后台模块，包括：
- 用户管理界面
- 权限配置系统
- 数据报表功能
- 审计日志查看
- 需要符合企业安全标准"
预期流程
  1. 范围规划 - Senior PM 分解任务
  2. 架构设计 - Backend Architect 设计权限和数据模型
  3. UI 设计 - UI Designer 设计管理界面
  4. 开发循环
    • 用户管理模块 → QA 验证
    • 权限系统 → QA 验证
    • 报表功能 → QA 验证
    • 审计日志 → QA 验证
  5. 安全测试 - 安全合规检查
  6. 交付报告 - 企业级交付文档
交付成果
  • ✅ 完整的管理后台代码
  • ✅ 权限配置系统
  • ✅ 数据报表功能
  • ✅ 审计日志模块
  • ✅ 安全合规报告
  • ✅ 企业级文档

最佳实践

1. 选择合适的 Agent

明确任务类型
复制代码 
简单任务 → 单个专业 Agent
复杂项目 → 编排器
多领域需求 → 部门协作
示例对比
任务类型 推荐方式 原因
创建单个 React 组件 Frontend Developer 专注、专业
完整电商网站 Orchestrator 自动调度、质量保证
全栈应用开发 Engineering Department 多 Agent 协作

2. 提供清晰的任务描述

❌ 模糊描述
bash 复制代码 
"帮我做个网站"
"策划一次营销"
"开发个功能"
✅ 清晰描述
bash 复制代码 
"帮我创建一个电商网站的前端，使用 React + Tailwind CSS，
需要包含首页、商品列表、购物车、结账页面，
要求响应式设计，支持移动端"

"为我的 SaaS 产品策划一次产品发布营销活动，
包括 Twitter、Instagram、TikTok 内容，
预算 $5000，目标获取 1000 个新用户"

3. 迭代优化

第一次输出后提供反馈
markdown 复制代码 
很好！但需要调整：
- 颜色方案改为蓝色系
- 增加暗黑模式支持
- 优化移动端布局
让 Agent 调整和改进
bash 复制代码 
"根据反馈调整：
1. 修改颜色方案为蓝色系
2. 添加暗黑模式
3. 优化移动端布局"
必要时切换 Agent 获取不同视角
bash 复制代码 
"让我听听不同视角..."
/openclaw skill use agency-agents --agent ui-designer "审查我的设计并提供改进建议"

4. 质量保证

使用测试部 Agent 进行验证
bash 复制代码 
/openclaw skill use agency-agents --agent reality-checker "作为现实检查员，
审查这个功能是否达到上线标准"
关键项目使用现实检查员最终审核
bash 复制代码 
/openclaw skill use agency-agents --agent reality-checker "在上线前进行最终质量认证"
重要决策使用多个 Agent 交叉验证
bash 复制代码 
# 方案 A
/openclaw skill use agency-agents --agent backend-architect "设计 API 架构方案 A"

# 方案 B
/openclaw skill use agency-agents --agent backend-architect "设计 API 架构方案 B"

# 对比分析
/openclaw skill use agency-agents --agent senior-developer "对比方案 A 和 B，给出建议"

故障排除

常见问题

Q1: Agent 输出不符合预期？

原因：任务描述不够详细

解决方案：

bash 复制代码 
# 提供更详细的任务描述
- 具体要求
- 技术栈
- 示例参考
- 约束条件
Q2: 多 Agent 协作效率低？

原因：缺乏协调

解决方案：

bash 复制代码 
# 使用编排器自动调度
/openclaw skill use agency-agents --agent orchestrator "复杂项目"

# 或手动指定 Agent 顺序
Q3: 需要特定领域专业知识？

原因：通用 Agent 知识深度不足

解决方案：

bash 复制代码 
# 选择对应部门的 Agent
/openclaw skill use agency-agents --agent [专业 Agent] "特定领域任务"

# 或联系支持获取定制建议
Q4: 流水线卡住了？

原因：QA 未通过或阻塞

解决方案：

bash 复制代码 
# 检查当前任务的 QA 反馈
# 可能需要人工干预或调整需求

# 询问进度
"当前进度如何？"
Q5: Agent 输出不一致？

原因：上下文传递不完整

解决方案：

bash 复制代码 
# 提供更清晰的上下文和指令
# 或手动指定 Agent

调试技巧

启用详细日志
bash 复制代码 
AGENCY_AGENTS_VERBOSE=true
查看进度
bash 复制代码 
"当前进度如何？"
获取状态报告
bash 复制代码 
"给我一份项目进度报告"

附录

A. 完整 Agent 列表

详见 SKILL.md

B. 技术文档

C. 使用指南

D. 许可证

MIT License - 基于 agency-agents 项目改造

文档版本：1.0.0

最后更新：2026-04-26

作者：Jerry

相关推荐
Rubin智造社2 小时前
Claude Opus 4.8值不值得用？同样的价格，比4.7到底强在哪？
anthropic·claude code·openclaw·claude opus 4.8·ai工具评测·claude vs gpt·ai新手入门
七夜zippoe2 小时前
OpenClaw Canvas 导航：URL 加载与控制
canvas·url·导航·openclaw·加载与控制
不脱发的程序猿2 小时前
如何创建一个标准Skill，让嵌入式经验真正复用起来
人工智能·单片机·嵌入式硬件·嵌入式·skill
无心水5 小时前
【Harness：设计规范】15、Harness 成熟度模型（H0-H3）：你的 AI 智能体在第几层
人工智能·设计规范·openclaw·养龙虾·harness·hermes·honcho
Rubin智造社18 小时前
OpenClaw 实操指南 35｜自动排版与草稿箱：发布前最后一公里自动化
openclaw·自动排版，内容运营，工作流自动化
beyond阿亮1 天前
PicoClaw皮皮虾: 端侧设备能跑AI智能体 超轻量AI智能体 极低成本硬件跑AI Agent，内存小于10MB
人工智能·ai·openclaw·picoclaw
Trouvaille ~1 天前
【OpenClaw篇】OpenClaw 实战入门：在 VMware 虚拟机里部署第一个本地 AI Agent
人工智能·大模型·agent·vmware·虚拟机·tools·openclaw
AC赳赳老秦1 天前
OpenClaw多Agent分工协作：按工作模块拆分Agent，实现全流程自动化闭环
java·大数据·数据库·python·自动化·php·openclaw
纸枫林1 天前
Notebooklm的cli来了
ai编程·skill
热门推荐
01GitHub 镜像站点02DeepSeek V4 + Claude Code thinking mode 400 错误修复方案03【AI】2026 年具身智能模型和世界模型总结04Codex 接入 DeepSeek API 完整配置文档05【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法06裂开！ChatGPT 居然开始要手机号验证，附详细解决方法07CC-Switch & Claude 基于 Linux 服务器安装使用指南08CC-Switch 全平台下载、安装与使用全指南（Windows/macOS/Linux）09几个好用的ip纯净度检测网站10API Key 登录 Codex 也能用插件了，还支持会话删除和导出