3.1 KiB
3.1 KiB
title, type, tags, date
| title | type | tags | date |
|---|---|---|---|
| 为 The Agency 贡献代码 | source | 2026-04-27 |
Source File
Summary（用中文描述）
- 核心主题：The Agency 智能体（Agent）项目的开源贡献指南——涵盖行为准则、贡献方式、智能体设计规范、PR 提交流程和风格指南
- 问题域：如何为 AI 智能体集合项目贡献新的或改进的专家智能体，包括设计原则、结构模板、质量标准
- 方法/机制：通过 YAML frontmatter 定义智能体元数据，通过分章节结构（身份/使命/规则/交付物/工作流/学习/指标）规范智能体设计，通过 PR 模板确保贡献质量
- 结论/价值：提供了一套完整的智能体贡献生态——从创意生成到真实场景测试再到社区评审，标准化了 AI 专家智能体的创建流程
Key Claims（用中文描述）
- 贡献智能体需满足：鲜明性格 + 明确交付物 + 可量化成功指标 + 分步工作流 + 真实场景测试
- 避免通用型"有用助手"人设，智能体应专精、独特、可落地
- PR 提交前必须在真实场景中测试，并包含 2-3 个代码/模板示例
- 智能体需定义具体、可量化的成功指标，而非模糊描述
Key Quotes
"赋予智能体独特语气与人设，避免'我是一个有用的助手'，要具体、让人印象深刻" — 智能体性格塑造原则 "提供可落地的代码示例，包含模板与框架，展示真实输出，而非模糊描述" — 交付物标准 "包含具体、可量化的指标，例如'3G 网络下页面加载时间低于 3 秒'" — 成功指标定义 "分步流程清晰，经过真实场景验证，拒绝纯理论、纸上谈兵" — 工作流要求
Key Concepts
- Agent-Design-Patterns：智能体设计应遵循的五大原则——鲜明性格、明确交付物、成功指标、经过验证的工作流、学习记忆机制
- YAML-Configuration：每个智能体文件以 YAML frontmatter 定义 name/description/color 元数据
- Pull-Request-Workflow：Fork → 分支 → 开发 → 测试 → PR → 社区评审 → 合并的完整贡献流程
- Markdown-Documentation：使用 Markdown 统一格式，表情符号导航，代码块语法高亮，表格对比选项
- Multi-Agent-System：The Agency 智能体集合涵盖 engineering/design/marketing/product 等多领域专业分工
Key Entities
- The-Agency：AI 智能体开源项目，汇集多领域专家智能体，支持 9 大分类贡献
- SRE：Site Reliability Engineering，贡献分类之一，对应 testing/ 分类专家
Connections
- Agentic-Identity-And-Trust ← extends ← The-Agency（The Agency 提供智能体贡献框架，Agentic Identity & Trust 定义身份与信任机制）
- Agents-Orchestrator ← depends_on ← Multi-Agent-System（编排依赖多智能体系统的存在）
- Multi-Agent-System-Reliability ← extends ← Multi-Agent-System（可靠性研究扩展多智能体系统）
Contradictions
- 无冲突：本指南为贡献流程文档，不与其他来源产生直接矛盾