--- title: "为 The Agency 贡献代码" type: source tags: [] date: 2026-04-24 --- ## Source File - [[raw/Agent/agency-agents/CONTRIBUTING_zh-CN.md]] ## Summary(用中文描述) - 核心主题:**The Agency**(agency-agents)项目的贡献者指南,定义智能体(Agent)设计规范、贡献流程和社区标准 - 问题域:AI 智能体系统的标准化设计、社区协作与质量保障 - 方法/机制:YAML frontmatter 元数据 + 分层结构化文档模板;通过 Pull Request 流程和 PR 模板实现质量把控;通过智能体设计原则(性格塑造、交付物定义、指标量化)确保智能体质量 - 结论/价值:提供可操作的智能体设计框架,降低社区贡献门槛,同时通过规范保证生态一致性 ## Key Claims(用中文描述) - 优秀智能体必须具备鲜明性格,拒绝"通用型有用助手"人设 - 智能体应提供可量化的成功指标,而非模糊描述 - 每个智能体必须经过真实场景测试和迭代优化 - 贡献者通过 PR 流程和社区评审确保智能体质量 ## Key Quotes > "赋予智能体独特语气与人设,避免'我是一个有用的助手',要具体、让人印象深刻" — 智能体性格设计原则 > "提供可落地的代码示例,包含模板与框架,展示真实输出,而非模糊描述" — 交付物标准 > "包含具体、可量化的指标" — 成功指标要求 ## Key Concepts - [[Agent-Design-Principles]]:The Agency 智能体设计五原则(鲜明性格、明确交付物、成功指标、经过验证的工作流、学习记忆) - [[Agent-Template]]:YAML frontmatter + 分层结构(身份/使命/规则/交付物/工作流/沟通/学习/指标) - [[Pull-Request-Template]]:标准化 PR 提交模板,包含智能体信息、创作动机、测试情况、检查清单 ## Key Entities - [[The-Agency]](agency-agents 项目):包含 147 个专业智能体,覆盖 12 个业务领域 - [[Agency-Engineering-Agent]]:前端开发者智能体示例,结构规范参考 - [[Agency-Marketing-reddit-Community-Builder]]:Reddit 社区运营者示例,性格塑造优秀参考 ## Connections - [[Multi-Agent-System-Reliability]] ← extends ← [[Agent-Design-Principles]] - [[OpenClaw]] ← related_to ← [[The-Agency]] - [[Multi-Agent-Team]] ← related_to ← [[Agent-Orchestration]] ## Contradictions - 无已知冲突内容