2.4 KiB
2.4 KiB
title, type, tags, date, source_file
| title | type | tags | date | source_file | |||
|---|---|---|---|---|---|---|---|
| Contributing to The Agency | source |
|
2026-04-20 | 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
- 无显著冲突