48 lines
2.8 KiB
Markdown
48 lines
2.8 KiB
Markdown
---
|
||
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]] 无冲突（中文版为本文档的翻译）
|