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 编程项目:

  1. 先思考后编码
    ```markdown
  2. 明确声明假设
  3. 不确定就问
  4. 识别更简单的方案
    ```

  5. 极简实现优先
    ```markdown

  6. 不写超出需求的功能
  7. 不搞投机性抽象
  8. 200行能解决就不要写50行
    ```

  9. 手术式精准修改
    ```markdown

  10. 只改必须改的
  11. 不”优化”相邻代码
  12. 匹配现有风格
    ```

  13. 目标驱动执行
    ```markdown

  14. 定义可验证的成功标准
  15. 循环直到验证通过
  16. 代码能跑≠任务完成
    ```

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 的本质:把专家的思维模式和行为准则结构化编码进提示词。

核心提取

维度 关键点
角色定义 专业深度 + 性格一致 + 记忆机制
行为准则 明确必须/禁止 + 可执行
工作流程 分析→规划→执行→验证
成功标准 可量化 + 可测量
沟通风格 与角色定位匹配

可直接复用的模式

  1. 角色文件模板:完整的 YAML + Markdown 结构
  2. 规则编写模式:Critical Rules 的写法
  3. 流程标准化:三段式工作流
  4. 标准量化:具体的数字指标

九、资源链接

资源 链接
GitHub github.com/msitarzewski/agency-agents
协议 MIT

本文由 AI 辅助整理,供技术学习参考。