Sync: add agent design notes

wiki/sources/contributing.md

@@ -0,0 +1,47 @@
+---
+title: "Contributing to The Agency"
+type: source
+tags: [multi-agent, openclaw, contribution, the-agency]
+date: 2026-04-21
+---
+
+## Source File
+- [[Agent/agency-agents/CONTRIBUTING.md]]
+
+## Summary（用中文描述）
+- 核心主题：The Agency（agency-agents）多智能体框架的贡献者指南英文原版
+- 问题域：如何规范地向 The Agency 项目贡献高质量 AI 智能体，以及社区协作标准
+- 方法/机制：通过智能体设计模板、五大设计原则、PR 流程规范和代码风格指南确保贡献质量
+- 结论/价值：为 OpenClaw 多智能体生态提供标准化的智能体创建框架和质量门槛
+
+## Key Claims（用中文描述）
+- The Agency 通过**五大设计原则**确保智能体质量：鲜明性格、明确交付物、可量化指标、经过验证的工作流、学习记忆
+- PR 最佳实践：**单文件优先**（一个 `.md` 就是一个 PR），复杂变更（工具链/架构）需先开 Discussion 对齐
+- 外部服务依赖须在 frontmatter 的 `services` 字段声明，且智能体应**脱离 API 后仍有独立价值**
+- 提交前必须完成：真实场景测试、遵循模板、至少 2-3 个代码/模板示例、可量化成功指标
+
+## Key Quotes
+> "The fastest path to a merged PR is **one markdown file** — a new or improved agent. That's the sweet spot." — PR 流程说明
+> "An agent that solves the user's problem using a service belongs here. A service's quickstart guide wearing an agent costume does not." — 外部服务评判标准
+
+## Key Concepts
+- [[Agent-Design-Principles]]：五大设计原则——鲜明性格/明确交付物/可量化指标/验证工作流/学习记忆
+- [[Agent-Template]]：YAML frontmatter + 结构化文档模板规范
+- [[Multi-Agent-Team]]：The Agency 框架下多智能体协作模式
+- [[Multi-Agent-System-Reliability]]：多智能体系统可靠性架构模式
+
+## Key Entities
+- [[The Agency]]：msitarzewski 主导的多智能体开源项目（147 个专业化智能体，覆盖 12 个业务领域）
+- [[OpenClaw]]：The Agency 智能体运行的基础平台
+- [[msitarzewski]]（mar.mod）：The Agency 项目维护者
+
+## Connections
+- [[contributing_zh-cn]] ← 同一文档的中文翻译版本，包含中文社区协作规范
+- [[Agent-Design-Principles]] ← 来源一致，均引用本文档定义五大设计原则
+- [[Agent-Template]] ← 来源一致，均引用本文档定义智能体文件结构
+- [[multi-agent-system-reliability]] ← 智能体设计规范层补充运行时可靠性模式
+- [[multi-agent-team]] ← The Agency 框架的多智能体协作模式
+
+## Contradictions
+- 无与其他 Wiki 页面的实质性内容冲突
+- 与 [[contributing_zh-cn]] 的差异：英文原版包含 Code of Conduct（行为准则）和 Recognition（贡献者认可机制）章节，中文翻译版侧重核心贡献流程和设计规范

wiki/sources/contributing_zh-cn.md

@@ -0,0 +1,44 @@
+---
+title: "为 The Agency 贡献代码"
+type: source
+tags: []
+date: 2026-04-24
+---
+
+## Source File
+- [[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
+- 无已知冲突内容