首先，感谢您考虑为 The Agency 做贡献！正是像您这样的人让这个 AI 代理集合变得更好，造福所有人。
本项目及其所有参与者均受我们的行为准则约束。参与本项目即表示您同意遵守以下准则：
- 尊重他人：以尊重对待每个人。鼓励健康的辩论，但不容忍人身攻击。
- 包容多样：欢迎和支持各种背景和身份的人。
- 协作共赢：我们一起创造的东西比单独创造更好。
- 保持专业：保持讨论专注于改进代理和社区。
有专业代理的想法？太好了！以下是添加方法：
-
Fork 本仓库
-
选择适当的类别（或提议新类别）：
engineering/- 软件开发专家design/- UX/UI 和创意专家marketing/- 增长和营销专家product/- 产品管理专家project-management/- 项目管理和协调专家testing/- QA 和测试专家support/- 运营和支持专家spatial-computing/- AR/VR/XR 专家specialized/- 无法归类的独特专家
-
按照下方模板创建您的代理文件
-
在真实场景中测试您的代理
-
提交包含您代理的 Pull Request
找到改进代理的方法？欢迎贡献：
- 添加真实世界示例和用例
- 用现代设计模式增强代码示例
- 基于新最佳实践更新工作流程
- 添加成功指标和基准
- 修正拼写错误、提高清晰度、增强文档
成功使用了这些代理？分享您的故事：
- 在 GitHub Discussions 发帖
- 向 README 添加案例研究
- 写一篇博客文章并链接
- 创建视频教程
发现问题？请告知我们：
- 检查问题是否已存在
- 提供清晰的复现步骤
- 包含您的使用场景背景
- 如果有想法，建议潜在的解决方案
每个代理应遵循此结构：
---
name: 代理名称
description: 一行描述代理的专业领域和重点
color: 颜色名称或 "#十六进制代码"
---
# 代理名称
## 🧠 你的身份与记忆
- **角色**：清晰的角色描述
- **个性**：个性特征和沟通风格
- **记忆**：代理记住和学习的内容
- **经验**：领域专业知识和视角
## 🎯 你的核心使命
- 带有清晰交付成果的主要职责 1
- 带有清晰交付成果的主要职责 2
- 带有清晰交付成果的主要职责 3
- **默认要求**：始终开启的最佳实践
## 🚨 你必须遵循的关键规则
定义代理方法的核心领域特定规则和约束
## 📋 你的技术交付成果
代理产出的具体示例：
- 代码示例
- 模板
- 框架
- 文档
## 🔄 你的工作流程
代理遵循的分步流程：
1. 阶段一：发现和研究
2. 阶段二：规划和策略
3. 阶段三：执行和实施
4. 阶段四：审查和优化
## 💭 你的沟通风格
- 代理如何沟通
- 示例短语和模式
- 语调和方式
## 🔄 学习与记忆
代理从以下内容学习：
- 成功的模式
- 失败的方法
- 用户反馈
- 领域演变
## 🎯 你的成功指标
可衡量的结果：
- 定量指标（带数字）
- 定性指标
- 性能基准
## 🚀 高级能力
代理掌握的高级技术和方法-
🎭 强烈个性
- 给代理独特的声音和性格
- 不是"我是一个有帮助的助手" —— 要具体且令人难忘
- 示例："我默认会找出 3-5 个问题并要求视觉证明"（证据收集师）
-
📋 清晰交付成果
- 提供具体的代码示例
- 包含模板和框架
- 展示真实输出，而非模糊描述
-
✅ 成功指标
- 包含具体、可衡量的指标
- 示例："3G 网络下页面加载时间低于 3 秒"
- 示例："各账号累计 10,000+ karma"
-
🔄 经过验证的工作流程
- 分步流程
- 经过真实世界测试的方法
- 不是理论上的 —— 而是经过实战检验的
-
💡 学习记忆
- 代理识别什么模式
- 如何随时间改进
- 会话之间记住什么
优秀的代理具有：
- ✅ 窄而深的专业化
- ✅ 独特的个性和声音
- ✅ 具体的代码/模板示例
- ✅ 可衡量的成功指标
- ✅ 分步工作流程
- ✅ 真实世界测试和迭代
应避免：
- ❌ 通用"有帮助的助手"个性
- ❌ 模糊的"我会帮你……"描述
- ❌ 没有代码示例或交付成果
- ❌ 范围过宽（样样通，样样松）
- ❌ 未经测试的理论方法
- 测试您的代理：在真实场景中使用，根据反馈迭代
- 遵循模板：匹配现有代理的结构
- 添加示例：包含至少 2-3 个代码/模板示例
- 定义指标：包含具体、可衡量的成功标准
- 校对：检查拼写错误、格式问题、清晰度
- Fork 本仓库
- 创建分支：
git checkout -b add-agent-name - 进行更改：添加您的代理文件
- 提交：
git commit -m "Add [Agent Name] specialist" - 推送：
git push origin add-agent-name - 打开 Pull Request，包含：
- 清晰的标题："Add [Agent Name] - [Category]"
- 描述代理的功能
- 为什么需要这个代理（使用场景）
- 您做过的任何测试
- 社区审查：其他贡献者可能会提供反馈
- 迭代：处理反馈并做出改进
- 批准：维护者会在准备好时批准
- 合并：您的贡献成为 The Agency 的一部分！
## 代理信息
**代理名称**：[名称]
**类别**：[engineering/design/marketing/etc.]
**专业领域**：[一行描述]
## 动机
[为什么需要这个代理？填补什么空白？]
## 测试
[您如何测试这个代理？真实世界用例？]
## 检查清单
- [ ] 遵循代理模板结构
- [ ] 包含个性和声音
- [ ] 有具体的代码/模板示例
- [ ] 定义了成功指标
- [ ] 包含分步工作流程
- [ ] 已校对并正确格式化
- [ ] 在真实场景中测试过- 具体明确："将页面加载时间减少 60%" 而非 "让它更快"
- 具体可感："用 TypeScript 创建 React 组件" 而非 "构建 UI"
- 令人难忘：给代理个性，而非通用企业话术
- 实用为主：包含真实代码，而非伪代码
- 一致使用 Markdown 格式
- 为章节标题包含 emoji（便于扫描）
- 为所有代码示例使用 代码块，并正确语法高亮
- 使用 表格 比较选项或展示指标
- 使用 粗体 表示强调，
代码表示技术术语
## 示例代码块
\`\`\`typescript
// 始终包含：
// 1. 语言规范用于语法高亮
// 2. 解释关键概念的注释
// 3. 真实、可运行的代码（非伪代码）
// 4. 现代最佳实践
interface AgentExample {
name: string;
specialty: string;
deliverables: string[];
}
\`\`\`- 专业但亲切：不过于正式或随意
- 自信但不傲慢："这是最佳方法" 而非 "也许你可以试试……"
- 有帮助但不手把手教：假设能力，提供深度
- 个性驱动：每个代理应有独特的声音
做出重大贡献的贡献者将：
- 列入 README 致谢章节
- 在发布说明中突出显示
- 在"每周代理"展示中亮相（如适用）
- 在代理文件本身中获得署名
- 一般问题：GitHub Discussions
- Bug 报告：GitHub Issues
- 功能请求：GitHub Issues
- 社区聊天：加入我们的讨论
- README.md - 概述和代理目录
- 示例：前端开发工程师 - 结构良好的代理示例
- 示例：Reddit 社区建设者 - 优秀个性示例
- 示例：趣味注入师 - 创意专家示例
- 阅读现有代理获取灵感
- 研究行之有效的模式
- 在真实场景中测试您的代理
- 根据反馈迭代
您的贡献让 The Agency 对每个人都更好。无论您是：
- 添加新代理
- 改进文档
- 修复 Bug
- 分享成功故事
- 帮助其他贡献者
您正在产生影响。感谢您！