2.8 KiB
2.8 KiB
title, type, tags, date
| title | type | tags | date | ||||
|---|---|---|---|---|---|---|---|
| Contributing to The Agency | source |
|
2026-04-21 |
Source File
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（贡献者认可机制）章节，中文翻译版侧重核心贡献流程和设计规范