agency-agents 原理与规则提取(10万星 AI 角色库深度解析)
agency-agents 原理与规则提取(10万星 AI 角色库深度解析)
来源:GitHub(用户分享)
整理时间:2026-05-20
标签:#agency-agents #AI角色 #提示词工程 #多Agent #专家系统 #提示词模板
一、项目概览
| 项目 | 信息 |
|---|---|
| 名称 | agency-agents(The Agency) |
| GitHub | github.com/msitarzewski/agency-agents |
| Star | 10万+ |
| 协议 | MIT |
| 定位 | 140+ 专家级 AI Agent 角色库 |
| 语言 | Shell + Markdown |
核心理念: 把 AI 变成各领域的专家”员工”,组成一支永不疲倦的虚拟团队。
二、架构设计原理
2.1 角色文件结构(核心模板)
每个角色文件包含 6 个核心模块:
---
name: 角色名称
description: 一句话定位
color: 颜色代码
emoji: 表情符号
vibe: 一句话描述角色风格
---
# 角色名 Agent
## 1. Identity(身份定义)
- Role: 具体职责
- Personality: 性格特点
- Memory: 记忆机制
- Experience: 经验背景
## 2. Core Philosophy(核心原则)
- 该角色的方法论框架
- 处理问题的基本思路
## 3. Critical Rules(必须遵守的规则)
- 行为底线
- 禁止事项
## 4. Process/Workflow(工作流程)
- 任务分析 → 规划 → 执行 → 验证
## 5. Success Criteria(成功标准)
- 可量化的交付标准
- 质量指标
## 6. Communication Style(沟通风格)
- 表达方式
- 文档习惯
2.2 角色分类体系
| 部门 | 角色数量 | 示例 |
|---|---|---|
| 工程部 | 27 | 前端、后端、AI工程师、DevOps、安全 |
| 设计部 | 8 | UI设计师、UX研究员、品牌守护者 |
| 营销部 | 30+ | 增长黑客、内容创作者、各平台运营 |
| 销售部 | 10+ | 外展策略师、发现教练、成交策略师 |
| 产品部 | 10+ | Sprint优先级、趋势研究员 |
| 付费媒体部 | 7+ | PPC策略师、搜索分析师、追踪专家 |
三、核心规则提取
3.1 身份定义规则
## Identity 模板
- **Role**: 具体职责描述
- **Personality**: 性格关键词(如:创意驱动、细节导向、性能优先)
- **Memory**: 记忆机制说明
- **Experience**: 经验背景
关键原则:
1. 专业深度:不是泛泛的角色描述,而是有具体技术栈
2. 人格一致性:性格特点贯穿整个交互
3. 记忆延续:记住之前的模式和反馈
3.2 行为准则规则
规则类型一:必须遵守(Critical Rules)
## 🚨 Critical Rules You Must Follow
- 每条规则明确说"必须"或"禁止"
- 规则要具体可执行,不是模糊原则
示例:
## 🚨 Critical Rules
- All FluxUI components are available - use official docs
- Alpine.js comes bundled with Livewire (don't install separately)
- MANDATORY: Implement light/dark/system theme toggle on every site
规则类型二:流程约束
## Process/Workflow
1. Task Analysis & Planning
2. Premium Implementation
3. Quality Assurance
规则类型三:成功标准量化
## Success Criteria
- Load times under 1.5 seconds
- 60fps animations
- Perfect responsive design
3.3 沟通风格规则
| 风格要素 | 写法示例 |
|---|---|
| 文档化增强 | “Enhanced with glass morphism…” |
| 技术具体性 | “Implemented using Three.js…” |
| 性能标注 | “Optimized for 60fps…” |
| 模式引用 | “Applied premium typography scale…” |
四、商业类角色的方法论
4.1 信号式销售框架(Outbound Strategist)
## The Signal-Based Selling Framework
核心:信号触发的外展比无差别外展转化率高 4-8 倍
### 信号分层(按意图强度)
**Tier 1 — 主动购买信号(最高优先级)**
- G2/review 网站访问
- 定价页面访问
- 竞品对比搜索
**Tier 2 — 组织变化信号**
- 领导层变更
- 融资事件
- 招聘激增
**Tier 3 — 技术图谱和行为信号**
- 技术栈变化
- 会议出席
- 内容参与度
4.2 ICP 定义框架
## ICP Definition
一个可用的 ICP 必须是可证伪的。如果它不能排除任何公司,那就不是 ICP。
### 必须包含:
FIRMOGRAPHIC FILTERS
- 行业垂直(2-4个具体行业)
- 收入范围或员工数量
- 地理范围
- 技术栈要求
BEHAVIORAL QUALIFIERS
- 什么业务事件使他们成为买家?
- 你的产品解决的痛点是什么?
DISQUALIFIERS(同样重要)
- 什么公司看起来好但永远不会成交?
4.3 账户分层模型
| 层级 | 数量 | 策略 |
|---|---|---|
| Tier 1 | 50-100 | 深度、多线程、高度个性化 |
| Tier 2 | 200-500 | 半个性化序列 |
| Tier 3 | 剩余 | 自动化 + 轻度个性化 |
五、提示词工程的核心模式
5.1 角色注入模式
# 基础格式
You are [Role Name], [一句话定位]
## Your Identity
- **Role**: [具体职责]
- **Personality**: [性格特点]
- **Memory**: [记忆机制]
- **Experience**: [经验背景]
5.2 任务执行模式
## Your Process
### 1. Task Analysis
- 理解需求
- 识别约束
- 规划实现
### 2. Implementation
- 按规范执行
- 记录决策
### 3. Quality Check
- 验证输出
- 测量指标
5.3 交付标准模式
## Success Criteria
### Implementation Excellence
- Every task marked `[x]` with enhancement notes
- Code is clean, performant, and maintainable
### Quality Standards
- Load times under X seconds
- X% animation smoothness
六、可提取复用的规则
6.1 通用角色模板
---
name: [角色名]
description: [一句话描述]
color: [颜色]
emoji: [表情]
vibe: [风格描述]
---
# [角色名] Agent
## Your Identity
- **Role**: [职责]
- **Personality**: [性格]
- **Memory**: [记忆机制]
- **Experience**: [背景]
## Your Core Philosophy
[角色方法论]
## 🚨 Critical Rules
- [规则1]
- [规则2]
- [规则3]
## Your Process
1. [步骤1]
2. [步骤2]
3. [步骤3]
## Success Criteria
- [标准1]
- [标准2]
## Communication Style
[沟通方式]
6.2 关键设计原则
| 原则 | 说明 |
|---|---|
| 专业深度 | 具体技术栈,不是泛泛的”你是律师” |
| 规则明确 | 明确说”必须”和”禁止” |
| 流程结构化 | 分析→规划→执行→验证 |
| 标准可量化 | 有具体的数字指标 |
| 风格一致 | 沟通风格与角色定位匹配 |
6.3 禁止事项清单
## 🚨 禁止事项
- 不要添加未请求的功能
- 不要重构没坏的部分
- 不要改变相邻代码的格式
- 不要猜测需求,不确定就问
七、与自己的项目结合
7.1 提取适用的规则
适用于任何 AI 编程项目:
- 先思考后编码
```markdown - 明确声明假设
- 不确定就问
-
识别更简单的方案
``` -
极简实现优先
```markdown - 不写超出需求的功能
- 不搞投机性抽象
-
200行能解决就不要写50行
``` -
手术式精准修改
```markdown - 只改必须改的
- 不”优化”相邻代码
-
匹配现有风格
``` -
目标驱动执行
```markdown - 定义可验证的成功标准
- 循环直到验证通过
- 代码能跑≠任务完成
```
7.2 创建自己的角色库
# 目录结构建议
~/agents/
├── engineering/
│ ├── frontend-developer.md
│ ├── backend-developer.md
│ └── ai-engineer.md
├── product/
│ └── product-manager.md
├── sales/
│ └── outbound-strategist.md
└── README.md
7.3 关键参数配置
| 参数 | 建议值 |
|---|---|
| color | 角色主题色,用于 UI 区分 |
| emoji | 角色标识,便于快速识别 |
| vibe | 一句话风格描述 |
八、总结
agency-agents 的本质:把专家的思维模式和行为准则结构化编码进提示词。
核心提取
| 维度 | 关键点 |
|---|---|
| 角色定义 | 专业深度 + 性格一致 + 记忆机制 |
| 行为准则 | 明确必须/禁止 + 可执行 |
| 工作流程 | 分析→规划→执行→验证 |
| 成功标准 | 可量化 + 可测量 |
| 沟通风格 | 与角色定位匹配 |
可直接复用的模式
- 角色文件模板:完整的 YAML + Markdown 结构
- 规则编写模式:Critical Rules 的写法
- 流程标准化:三段式工作流
- 标准量化:具体的数字指标
九、资源链接
| 资源 | 链接 |
|---|---|
| GitHub | github.com/msitarzewski/agency-agents |
| 协议 | MIT |
本文由 AI 辅助整理,供技术学习参考。