Auto-sync: 2026-04-20 07:08

wiki/sources/the-agency-contributing.md

@@ -0,0 +1,45 @@
+---
+title: "Contributing to The Agency"
+type: source
+tags: [contributing, open-source, ai-agents]
+date: 2026-04-20
+source_file: raw/Agent/agency-agents/CONTRIBUTING.md
+---
+
+## Summary
+- 核心主题：AI 智能体集合项目 The Agency 的贡献指南
+- 问题域：开源 AI 智能体设计规范、Pull Request 流程、代码风格
+- 方法/机制：Agent 文件结构、Persona vs Operations 分离原则、外部服务依赖声明
+- 结论/价值：提供系统化的 AI 智能体贡献框架，降低协作门槛
+
+## Key Claims
+- The Agency 欢迎贡献者通过创建新智能体、改进现有智能体、分享成功案例、报告问题四种方式参与贡献
+- Agent 文件遵循 Persona（身份、沟通风格、规则）与 Operations（使命、交付物、工作流、指标）语义分离结构
+- 优秀的智能体具备六大特征：鲜明性格、明确交付物、成功指标、经过验证的工作流、学习记忆、真实场景测试
+- Pull Request 最快路径是提交单个 markdown 文件（一个智能体定义）
+- Agent 应优先依赖具有免费层级的外部服务，且服务仅作为增强而非必要条件
+
+## Key Quotes
+> "Great agents have: Narrow, deep specialization, Distinct personality and voice, Concrete code/template examples, Measurable success metrics" — Agent 设计原则
+
+> "The test: is this agent for the user, or for the vendor?" — 外部服务依赖判断标准
+
+> "What's the sweet spot? One markdown file — a new or improved agent." — PR 最佳实践
+
+## Key Concepts
+- [[AgentDesignPrinciples]]：智能体设计六大原则（Strong Personality、Clear Deliverables、Success Metrics、Proven Workflows、Learning Memory、Real-world Testing）
+- [[AgentFileStructure]]：Persona 与 Operations 语义分离的文件结构
+- [[ExternalServicesDeclaration]]：外部服务声明规范，通过 frontmatter 的 services 字段声明依赖
+- [[PersonaOperationsSplit]]：将智能体区分为身份相关（Persona）与操作相关（Operations）的组织方式
+
+## Key Entities
+- [[TheAgency]]：开源 AI 智能体集合项目，汇集各类专业化 AI Agent
+- [[MSitarzewski]]：The Agency 项目维护者
+
+## Connections
+- [[TheAgency]] ← has_contribution_guide ← [[TheAgencyContributing]]
+- [[AgentDesignPrinciples]] ← defines ← [[TheAgencyContributing]]
+- [[AgentFileStructure]] ← documented_in ← [[TheAgencyContributing]]
+
+## Contradictions
+- 无显著冲突