🎭 agency-agents 深度学习笔记

Agency-Agents Deep Learning Notes

项目来源: msitarzewski/agency-agents
项目规模: 144个专业Agent，14个部门，80k+ Stars
学习日期: 2026-04-22

📋 项目概述 | Project Overview

什么是 agency-agents？

agency-agents 是一个精心设计的AI Agent人格集合，每个Agent都是拥有独特个性、专长和工作流程的专业AI专家。该项目源于Reddit讨论，经过数月迭代发展而来。

项目特点 | Key Characteristics

14个部门一览 | 14 Departments Overview

🏗️ Agent设计范式 | Agent Design Paradigm

标准文件格式 | Standard File Format

每个Agent文件遵循统一的YAML前置元数据格式：

---
name: Agent Name
description: 简短描述Agent专长
color: "#HEXCODE"        # 品牌颜色
emoji: 🔧                 # 视觉标识
vibe: 一句话描述Agent风格
---

核心结构要素 | Core Structure Elements

1. Identity & Memory（身份与记忆）

## 🧠 Your Identity & Memory
- **Role**: 具体角色定义
- **Personality**: 人格特征描述
- **Memory**: 记忆什么关键信息
- **Experience**: 经验背景

2. Core Mission（核心使命）

## 🎯 Your Core Mission

### 主要能力领域
- 能力1：具体描述
- 能力2：具体描述
- 能力3：具体描述

3. Critical Rules（关键规则）

## 🚨 Critical Rules You Must Follow

### 类别1
- 具体规则1
- 具体规则2

### 类别2
- 具体规则3

4. Technical Deliverables（技术交付物）

## 📋 Your Technical Deliverables

### 交付物类型1
```代码模板或格式说明

交付物类型2

#### 5. Workflow Process（工作流程）

```markdown
## 🔄 Your Workflow Process

### Step 1: 阶段名称
1. 具体步骤1
2. 具体步骤2

### Step 2: 阶段名称
1. 具体步骤1

6. Communication Style（沟通风格）

## 💬 Your Communication Style
- **特征1**: 具体示例
- **特征2**: 具体示例

7. Success Metrics（成功指标）

## 🎯 Your Success Metrics
- 指标1: 具体目标值
- 指标2: 具体目标值

🎯 人格驱动+交付导向 | Personality-Driven & Deliverable-Focused

设计哲学 | Design Philosophy

agency-agents的核心理念是人格驱动+交付导向：

Agent人格模板对比

传统方式:

"You are a helpful assistant that can help with coding tasks."

agency-agents方式:

You are **Frontend Developer**, an expert frontend developer who specializes in modern web technologies, UI frameworks, and performance optimization...

- **Role**: Modern web application and UI implementation specialist
- **Personality**: Detail-oriented, performance-focused, user-centric, technically precise
- **Memory**: You remember successful UI patterns, performance optimization techniques...
- **Experience**: You've seen applications succeed through great UX and fail through poor implementation

🇨🇳 中国平台专项研究 | China Platform Deep Dive

平台矩阵 | Platform Matrix

小红书专家深度解读

人格特征: - 精通平台算法和趋势文化 - 具备敏锐的生活美学感知 - 深度理解Z世代和千禧一代偏好

核心指标: - 互动率目标: 5%+（高于Instagram） - 评论转化: 30%+ - 分享率: 2%+ - 收藏率: 8%+

内容策略: - 70%生活方式内容 - 20%趋势参与 - 10%品牌直接推广

抖音专家深度解读

算法优先思维:

完成率 > 点赞率 > 评论率 > 分享率

3秒黄金钩子: - 冲突型: "买XXX之前必看这个" - 价值型: "花了XX元解决了困扰我3年的问题" - 悬念型: "发现了XX行业不想让你知道的秘密" - 共鸣型: "有没有人和我一样每次都XXX"

直播电商选品结构: | 类型 | 占比 | 利润率 | 目的 | |------|------|--------|------| | 引流款 | 20% | 0-10% | 建人气 | | 主推款 | 50% | 40-60% | 核心利润 | | 高端款 | 15% | 60%+ | 品牌调性 | | 秒杀款 | 15% | 亏本 | 促活留存 |

B站专家深度解读

内容矩阵: - 深度内容(40%): 10-20分钟，高制作价值 - 热点内容(30%): 梗整合、热点评论 - 社区内容(20%): Q&A、粉丝互动 - 实验内容(10%): 新格式、合作

弹幕互动设计: | 时间戳 | 内容节点 | 预期弹幕反应 | |--------|----------|-------------| | 0:03 | 标志性开场白 | 社区口号呼应 | | 2:15 | 惊人事实揭示 | "???"震惊反应 | | 5:30 | 互动提问 | 弹幕回答 | | END | 结束仪式 | "下次一定" |

快手 vs 抖音：关键差异

中国市场综合策略

四步心智模型: 1. 见微知著: 从低排名话题中发现弱信号 2. 交叉验证: 热搜数据 vs 专家信号交叉验证 3. 反直觉思考: 识别共识错误中的机会 4. MECE结构: 确保分析相互独立、完全穷尽

平台漏斗映射:

认知(微博/抖音) → 考虑(知乎/B站) → 转化(小红书/微信/电商) → 留存(私域/企微)

🔧 Agent编排与系统设计 | Agent Orchestration & System Design

Orchestrator Agent

核心职责: - 管理完整开发流程: PM → 架构 → [开发↔QA循环] → 集成 - 确保每阶段完成后再推进 - 协调Agent交接与上下文传递

质量门禁: - 无捷径: 每任务必须通过QA验证 - 证据要求: 所有决策基于实际输出 - 重试限制: 每任务最多3次尝试 - 清晰交接: 每个Agent获得完整上下文

MCP Builder Agent

设计原则: 1. 描述性工具名称: search_users 而非 query1 2. 类型化参数: 使用Zod/Pydantic验证 3. 结构化输出: JSON用于数据，Markdown用于可读内容 4. 优雅失败: 返回isError: true而非崩溃 5. 无状态工具: 每次调用独立 6. 环境密钥: API密钥来自环境变量

Workflow Architect Agent

工作流注册表四视图: 1. 按工作流: 完整工作流清单及状态 2. 按组件: 代码到工作流的映射 3. 按用户旅程: 用户体验到工作流的映射 4. 按状态: 实体状态及可触发的工作流

💡 与现有项目整合思路 | Integration with Existing Projects

colleague-skill项目对比

整合机会 | Integration Opportunities

1. Agent模板库构建

将agency-agents的设计范式应用于colleague-skill：

---
name: [名人名称] Expert
description: [名人专长描述]
color: "#HEXCODE"
emoji: 🎯
vibe: [一句话风格描述]
---

## Identity & Memory
- **Role**: [角色定义]
- **Personality**: [人格特征，与名人风格匹配]
- **Memory**: [记忆特点，与名人背景相关]
- **Experience**: [经验背景]

2. 能力矩阵扩展

3. 工作流程复用

可复用的设计模式: - 分阶段交付流程 - 质量门禁检查表 - 成功指标量化体系 - 沟通风格指南

📊 核心Agent解读 | Core Agent Analysis

Frontend Developer

核心能力: - 现代Web技术栈（React/Vue/Angular） - 像素级设计实现 - Core Web Vitals优化 - 无障碍访问合规（WCAG 2.1 AA）

交付物模板:

// 现代React组件示例
interface DataTableProps {
  data: Array<Record<string, any>>;
  columns: Column[];
  onRowClick?: (row: any) => void;
}

export const DataTable = memo<DataTableProps>(({ data, columns, onRowClick }) => {
  // 虚拟化列表实现
  // 无障碍支持
  // 性能优化
});

Product Manager

核心理念:

"Think in outcomes, not outputs. A feature shipped that nobody uses is not a win — it's waste with a deploy timestamp."

关键原则: 1. 先问题后方案 2. 先写PR后写PRD 3. 无指标不排期 4. 清晰说"不" 5. 验证后再开发 6. 一致性≠共识

Feishu Integration Developer

技术栈: - 飞书机器人开发（Webhook/App Bot） - 消息卡片与交互 - 审批流程集成 - 多维表格(Bitable) - SSO与身份认证

最佳实践: - 区分tenant_access_token vs user_access_token - 实现API重试机制 - 验证事件订阅签名 - 使用官方SDK

🎓 学习要点总结 | Key Learning Points

1. Agent设计核心要素

2. 中国平台运营关键

3. 可复用的设计模式

1. YAML前置元数据: name + description + color + emoji + vibe
2. 分层结构: Identity → Mission → Rules → Deliverables → Workflow → Metrics
3. 模板化交付: 代码模板、文档模板、检查表
4. 质量门禁: 验证点、重试机制、升级流程
5. 指标驱动: 可量化的成功标准

🚀 行动建议 | Action Items

短期（1-2周）

• [ ] 分析colleague-skill现有12个Skill的结构
• [ ] 对照agency-agents范式识别差距
• [ ] 创建统一的Skill模板

中期（1个月）

• [ ] 为每个名人Skill添加完整的Critical Rules
• [ ] 补充Technical Deliverables模板
• [ ] 完善Workflow Process分阶段设计
• [ ] 添加Success Metrics量化指标

长期（季度）

• [ ] 扩展到更多专业领域Agent
• [ ] 构建Agent编排系统
• [ ] 实现跨Agent协作流程

📚 参考资源 | References

• 项目地址: https://github.com/msitarzewski/agency-agents
• Stars: 80k+
• Agent总数: 144+
• 部门数量: 14

重点学习文件

1. ./agency-agents/marketing/marketing-xiaohongshu-specialist.md
2. ./agency-agents/marketing/marketing-douyin-strategist.md
3. ./agency-agents/marketing/marketing-bilibili-content-strategist.md
4. ./agency-agents/marketing/marketing-china-market-localization-strategist.md
5. ./agency-agents/engineering/engineering-frontend-developer.md
6. ./agency-agents/specialized/agents-orchestrator.md
7. ./agency-agents/specialized/specialized-mcp-builder.md
8. ./agency-agents/product/product-manager.md
9. ./agency-agents/engineering/engineering-feishu-integration-developer.md

学习笔记由 Knowledge Researcher Agent 生成
Generated by Knowledge Researcher Agent