45 lines
2.4 KiB
Markdown
45 lines
2.4 KiB
Markdown
---
|
||
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
|
||
- 无显著冲突 |