集成 agency-agents 专家角色

更新日期： 2026-04-14
前提条件： 需要克隆 agency-agents 仓库

---

什么是 agency-agents

GitHub： https://github.com/msitarzewski/agency-agents

简介： 一个包含 144+ AI 专家角色定义的开源项目，涵盖 12 个部门：

部门	角色数	代表角色
💻 Engineering	27	Frontend Developer, Backend Architect, DevOps
🎨 Design	8	UX Designer, UI Designer
📢 Marketing	28	Content Creator, SEO Specialist
🎬 Project Management	6	Senior PM, Studio Producer
🧪 Testing	8	QA Engineer, Test Automation
📱 Mobile	6	iOS Developer, Android Developer
其他	60+	各种专家角色

特点：

• 每个角色有完整的身份定义
• 明确的职责和成功指标
• 详细的沟通风格说明
• 技术交付物模板

---

前提条件

1. 克隆 agency-agents

cd /Users/wangyi/.openclaw/workspace
git clone https://github.com/msitarzewski/agency-agents.git

路径： /Users/wangyi/.openclaw/workspace/agency-agents/

2. 安装 claude-code-dispatch

clawdhub install claude-code-dispatch

说明： 用于派发任务给 Claude Code

---

使用流程

方法 1：新项目（推荐）

适用场景： 从零开始的新项目

1. 创建项目结构

mkdir -p [项目名]/.claude/{agents,memory-bank}

2. 复制角色文件

# Frontend Developer
cp agency-agents/engineering/engineering-frontend-developer.md \
   [项目名]/.claude/agents/frontend-developer.md

# Backend Architect
cp agency-agents/engineering/engineering-backend-architect.md \
   [项目名]/.claude/agents/backend-architect.md

# Project Manager
cp agency-agents/project-management/project-manager-senior.md \
   [项目名]/.claude/agents/project-manager.md

3. 编写 SPEC

cat > [项目名]/.claude/memory-bank/project-spec.md << 'EOF'
# [项目名]

## 背景
为什么做？解决什么问题？

## 用户
谁用？痛点是什么？

## 功能
1. [功能 1] - 验收标准
2. [功能 2] - 验收标准

## 技术栈
- 框架：...
- 部署：...
EOF

4. 派发任务 + PUA

nohup bash ~/.openclaw/workspace/skills/claude-code-dispatch/scripts/dispatch.sh \
  -p "你是 Frontend Developer 专家。
      
      请阅读：
      - .claude/agents/frontend-developer.md（你的角色定义）
      - .claude/memory-bank/project-spec.md（项目 SPEC）
      
      你的任务：[具体任务]
      
      成功标准：
      ✅ [标准 1]
      ✅ [标准 2]
      ✅ [标准 3]
      
      记住：你是前端专家，你的工作直接影响用户体验。
      我相信你能做到最好。" \
  -n "[任务名]" \
  --workdir /Users/wangyi/.openclaw/workspace/[项目名] \
  --permission-mode bypassPermissions \
  > /tmp/dispatch.log 2>&1 &

---

方法 2：现有项目

适用场景： 已有项目需要专家协助

1. 添加角色文件

mkdir -p [项目名]/.claude/agents
cp agency-agents/engineering/engineering-frontend-developer.md \
   [项目名]/.claude/agents/

2. 派发任务

dispatch.sh \
  -p "你是 Frontend Developer 专家。
      请阅读 .claude/agents/frontend-developer.md
      任务：修复深色模式问题
      ..." \
  --workdir [项目路径]

---

常用角色速查

需求	角色文件
前端开发	engineering/engineering-frontend-developer.md
后端架构	engineering/engineering-backend-architect.md
项目管理	project-management/project-manager-senior.md
UI/UX 设计	design/design-ux-researcher.md
测试 QA	testing/testing-qa-engineer.md
移动开发	engineering/engineering-mobile-app-builder.md
DevOps	engineering/engineering-devops-automator.md
安全	engineering/engineering-security-engineer.md

---

PUA 话术模板

你是 [角色名] 专家，你的职责是 [角色使命]。

请阅读以下文件：
- .claude/agents/[角色].md（你的身份定义）
- .claude/memory-bank/[项目]-spec.md（项目需求）

你的任务：[具体任务]

成功标准：
✅ [标准 1]
✅ [标准 2]
✅ [标准 3]

记住：你是 [角色] 专家，[角色特质]。
你的工作直接影响 [影响范围]。
我相信你能做到最好。

---

优势对比

传统方式	新方式（agency-agents）
❌ Prompt 塞满角色定义	✅ 角色文件独立
❌ SPEC 写在 prompt 里	✅ SPEC 文件化
❌ Claude 记不住上下文	✅ 自己读取文件
❌ 每次重写 prompt	✅ 文件可复用
❌ 角色定义简单	✅ 144+ 专家角色

---

实战案例

案例 1：番茄计时器深色模式修复

项目： pomodoro-timer
角色： Frontend Developer
任务： 修复深色模式不生效问题

派发：

dispatch.sh \
  -p "你是 Frontend Developer 专家。
      请阅读 .claude/agents/frontend-developer.md
      
      任务：修复深色模式问题
      - 点击🌙背景应该变深色（#111827）
      - 点击☀️背景应该变白色
      
      成功标准：
      ✅ 深色模式切换正常
      ✅ 文字颜色相应变化
      ✅ 部署后测试通过
      
      记住：你是前端专家，像素级精确是你的职责。
      我相信你能修复这个问题。" \
  --workdir /Users/wangyi/.openclaw/workspace/pomodoro-timer

结果： ✅ 修复成功

---

注意事项

1. 文件路径

确保角色文件和 SPEC 文件路径正确：

# 检查文件
ls -la [项目]/.claude/agents/
ls -la [项目]/.claude/memory-bank/

2. 权限模式

--permission-mode bypassPermissions 允许 Claude Code 直接修改文件：

# 安全说明
# - 只在可信项目使用
# - 确保 workdir 正确
# - 审查修改后再部署

3. 任务追踪

使用 task-tracker.sh 追踪任务状态：

task-tracker.sh list    # 查看进行中的任务
task-tracker.sh status  # 查看状态（含超时检查）

---

参考链接

• agency-agents GitHub
• PM Skill 文档
• Dispatch 修复说明

---

最后更新：2026-04-14