2.8 KiB
2.8 KiB
title, type, tags, sources, last_updated
| title | type | tags | sources | last_updated |
|---|---|---|---|---|
| Contributing to The Agency | source | 2026-04-29 |
Source File
Summary（用中文描述）
- 核心主题：The Agency 开源 AI Agent 项目的贡献指南，定义如何创建、改进和提交新的 Agent
- 问题域：开源社区协作、AI Agent 开发规范、贡献流程标准化
- 方法/机制：通过结构化的 Agent 文件模板、设计原则、PR 流程和样式指南来规范贡献行为
- 结论/价值：降低了贡献门槛，明确了"好 Agent"的标准，使社区能够持续产出高质量的 AI Agent
Key Claims（用中文描述）
- 贡献一个 Agent 的最简路径是一个 Markdown 文件（新 Agent 或改进现有 Agent）
- 优秀的 Agent 必须具备：窄而深的专长、鲜明的个性声音、具体的代码/模板示例、可量化的成功指标、逐步验证的工作流
- Agent 文件采用双语义分组（Persona + Operations），以支持 OpenClaw 格式自动转换
- 外部服务依赖应在 frontmatter 中声明，但 Agent 本身必须独立成立
- 批量修改现有 Agent 必须先开 Discussion 讨论
Key Quotes
"The fastest path to a merged PR is one markdown file — a new or improved agent." — 强调最小化 PR 的核心理念 "Great agents have: ✅ Narrow, deep specialization / ✅ Distinct personality and voice / ✅ Concrete code/template examples / ✅ Measurable success metrics / ✅ Step-by-step workflows / ✅ Real-world testing and iteration" — 好 Agent 的六项标准
Key Concepts
- AgentDesignPrinciples：Agent 设计五原则——强个性、清晰交付物、成功指标、经过验证的工作流、学习与记忆
- PersonaVsOperations：Agent 文件的 Persona（身份/沟通/规则）与 Operations（使命/交付物/流程/指标）双分组结构
- ExternalServicesDeclaration：Agent 可声明外部服务依赖，但必须独立于服务存在，测试标准是"去掉 API 调用后 Agent 仍有价值"
- OpenClawFormat：OpenClaw 工作区格式，支持通过 convert.sh 自动将 Agent 文件转换为工具特定格式
Key Entities
- TheAgency：The Agency 是一个开源 AI Agent 集合项目，托管于 GitHub (msitarzewski/agency-agents)
- MarekSitarzewski：The Agency 项目作者（GitHub: msitarzewski）
- OpenClaw：Agent 工作区格式规范，定义了 Agent 文件的结构和 convert.sh 转换脚本
Connections
- TheAgency ← authored_by ← MarekSitarzewski
- AgentDesignPrinciples ← implements ← PersonaVsOperations
- ExternalServicesDeclaration ← part_of ← AgentDesignPrinciples
- OpenClaw ← converts ← AgentDesignPrinciples
Contradictions
- 与 contributing_zh-cn 无冲突（中文版为本文档的翻译）