48 lines
2.8 KiB
Markdown
48 lines
2.8 KiB
Markdown
---
|
||
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（贡献者认可机制）章节，中文翻译版侧重核心贡献流程和设计规范
|