---
title: "Contributing to The Agency"
type: source
tags: [multi-agent, openclaw, contribution, the-agency]
date: 2026-04-21
---

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

## Summary（用中文描述）
- 核心主题：The Agency（agency-agents）多智能体框架的贡献者指南英文原版
- 问题域：如何规范地向 The Agency 项目贡献高质量 AI 智能体，以及社区协作标准
- 方法/机制：通过智能体设计模板、五大设计原则、PR 流程规范和代码风格指南确保贡献质量
- 结论/价值：为 OpenClaw 多智能体生态提供标准化的智能体创建框架和质量门槛

## Key Claims（用中文描述）
- The Agency 通过**五大设计原则**确保智能体质量：鲜明性格、明确交付物、可量化指标、经过验证的工作流、学习记忆
- PR 最佳实践：**单文件优先**（一个 `.md` 就是一个 PR），复杂变更（工具链/架构）需先开 Discussion 对齐
- 外部服务依赖须在 frontmatter 的 `services` 字段声明，且智能体应**脱离 API 后仍有独立价值**
- 提交前必须完成：真实场景测试、遵循模板、至少 2-3 个代码/模板示例、可量化成功指标

## Key Quotes
> "The fastest path to a merged PR is **one markdown file** — a new or improved agent. That's the sweet spot." — PR 流程说明
> "An agent that solves the user's problem using a service belongs here. A service's quickstart guide wearing an agent costume does not." — 外部服务评判标准

## Key Concepts
- [[Agent-Design-Principles]]：五大设计原则——鲜明性格/明确交付物/可量化指标/验证工作流/学习记忆
- [[Agent-Template]]：YAML frontmatter + 结构化文档模板规范
- [[Multi-Agent-Team]]：The Agency 框架下多智能体协作模式
- [[Multi-Agent-System-Reliability]]：多智能体系统可靠性架构模式

## Key Entities
- [[The Agency]]：msitarzewski 主导的多智能体开源项目（147 个专业化智能体，覆盖 12 个业务领域）
- [[OpenClaw]]：The Agency 智能体运行的基础平台
- [[msitarzewski]]（mar.mod）：The Agency 项目维护者

## Connections
- [[contributing_zh-cn]] ← 同一文档的中文翻译版本，包含中文社区协作规范
- [[Agent-Design-Principles]] ← 来源一致，均引用本文档定义五大设计原则
- [[Agent-Template]] ← 来源一致，均引用本文档定义智能体文件结构
- [[multi-agent-system-reliability]] ← 智能体设计规范层补充运行时可靠性模式
- [[multi-agent-team]] ← The Agency 框架的多智能体协作模式

## Contradictions
- 无与其他 Wiki 页面的实质性内容冲突
- 与 [[contributing_zh-cn]] 的差异：英文原版包含 Code of Conduct（行为准则）和 Recognition（贡献者认可机制）章节，中文翻译版侧重核心贡献流程和设计规范