---
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
- 无显著冲突