---
title: "Contributing to The Agency"
type: source
tags: []
sources: []
last_updated: 2026-04-29
---

## Source File
- [[Agent/agency-agents/CONTRIBUTING.md]]

## 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]] 无冲突（中文版为本文档的翻译）