---
title: "为 The Agency 贡献代码"
type: source
tags: []
date: 2026-04-27
---

## Source File
- [[Agent/agency-agents/CONTRIBUTING_zh-CN.md]]

## Summary（用中文描述）
- 核心主题：The Agency 智能体（Agent）项目的开源贡献指南——涵盖行为准则、贡献方式、智能体设计规范、PR 提交流程和风格指南
- 问题域：如何为 AI 智能体集合项目贡献新的或改进的专家智能体，包括设计原则、结构模板、质量标准
- 方法/机制：通过 YAML frontmatter 定义智能体元数据，通过分章节结构（身份/使命/规则/交付物/工作流/学习/指标）规范智能体设计，通过 PR 模板确保贡献质量
- 结论/价值：提供了一套完整的智能体贡献生态——从创意生成到真实场景测试再到社区评审，标准化了 AI 专家智能体的创建流程

## Key Claims（用中文描述）
- 贡献智能体需满足：鲜明性格 + 明确交付物 + 可量化成功指标 + 分步工作流 + 真实场景测试
- 避免通用型"有用助手"人设，智能体应专精、独特、可落地
- PR 提交前必须在真实场景中测试，并包含 2-3 个代码/模板示例
- 智能体需定义具体、可量化的成功指标，而非模糊描述

## Key Quotes
> "赋予智能体独特语气与人设，避免'我是一个有用的助手'，要具体、让人印象深刻" — 智能体性格塑造原则
> "提供可落地的代码示例，包含模板与框架，展示真实输出，而非模糊描述" — 交付物标准
> "包含具体、可量化的指标，例如'3G 网络下页面加载时间低于 3 秒'" — 成功指标定义
> "分步流程清晰，经过真实场景验证，拒绝纯理论、纸上谈兵" — 工作流要求

## Key Concepts
- [[Agent-Design-Patterns]]：智能体设计应遵循的五大原则——鲜明性格、明确交付物、成功指标、经过验证的工作流、学习记忆机制
- [[YAML-Configuration]]：每个智能体文件以 YAML frontmatter 定义 name/description/color 元数据
- [[Pull-Request-Workflow]]：Fork → 分支 → 开发 → 测试 → PR → 社区评审 → 合并的完整贡献流程
- [[Markdown-Documentation]]：使用 Markdown 统一格式，表情符号导航，代码块语法高亮，表格对比选项
- [[Multi-Agent-System]]：The Agency 智能体集合涵盖 engineering/design/marketing/product 等多领域专业分工

## Key Entities
- [[The-Agency]]：AI 智能体开源项目，汇集多领域专家智能体，支持 9 大分类贡献
- [[SRE]]：Site Reliability Engineering，贡献分类之一，对应 testing/ 分类专家

## Connections
- [[Agentic-Identity-And-Trust]] ← extends ← [[The-Agency]]（The Agency 提供智能体贡献框架，Agentic Identity & Trust 定义身份与信任机制）
- [[Agents-Orchestrator]] ← depends_on ← [[Multi-Agent-System]]（编排依赖多智能体系统的存在）
- [[Multi-Agent-System-Reliability]] ← extends ← [[Multi-Agent-System]]（可靠性研究扩展多智能体系统）

## Contradictions
- 无冲突：本指南为贡献流程文档，不与其他来源产生直接矛盾