Update nexus wiki content

wiki/sources/contributing.md

@@ -1,47 +1,47 @@
 ---
 title: "Contributing to The Agency"
 type: source
-tags: [multi-agent, openclaw, contribution, the-agency]
-date: 2026-04-21
+tags: []
+sources: []
+last_updated: 2026-04-29
 ---
 
 ## Source File
-- [[raw/Agent/agency-agents/CONTRIBUTING.md]]
+- [[Agent/agency-agents/CONTRIBUTING.md]]
 
 ## Summary（用中文描述）
-- 核心主题：The Agency（agency-agents）多智能体框架的贡献者指南英文原版
-- 问题域：如何规范地向 The Agency 项目贡献高质量 AI 智能体，以及社区协作标准
-- 方法/机制：通过智能体设计模板、五大设计原则、PR 流程规范和代码风格指南确保贡献质量
-- 结论/价值：为 OpenClaw 多智能体生态提供标准化的智能体创建框架和质量门槛
+- 核心主题：The Agency 开源 AI Agent 项目的贡献指南，定义如何创建、改进和提交新的 Agent
+- 问题域：开源社区协作、AI Agent 开发规范、贡献流程标准化
+- 方法/机制：通过结构化的 Agent 文件模板、设计原则、PR 流程和样式指南来规范贡献行为
+- 结论/价值：降低了贡献门槛，明确了"好 Agent"的标准，使社区能够持续产出高质量的 AI Agent
 
 ## Key Claims（用中文描述）
-- The Agency 通过**五大设计原则**确保智能体质量：鲜明性格、明确交付物、可量化指标、经过验证的工作流、学习记忆
-- PR 最佳实践：**单文件优先**（一个 `.md` 就是一个 PR），复杂变更（工具链/架构）需先开 Discussion 对齐
-- 外部服务依赖须在 frontmatter 的 `services` 字段声明，且智能体应**脱离 API 后仍有独立价值**
-- 提交前必须完成：真实场景测试、遵循模板、至少 2-3 个代码/模板示例、可量化成功指标
+- 贡献一个 Agent 的最简路径是一个 Markdown 文件（新 Agent 或改进现有 Agent）
+- 优秀的 Agent 必须具备：窄而深的专长、鲜明的个性声音、具体的代码/模板示例、可量化的成功指标、逐步验证的工作流
+- Agent 文件采用双语义分组（Persona + Operations），以支持 OpenClaw 格式自动转换
+- 外部服务依赖应在 frontmatter 中声明，但 Agent 本身必须独立成立
+- 批量修改现有 Agent 必须先开 Discussion 讨论
 
 ## 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." — 外部服务评判标准
+> "The fastest path to a merged PR is **one markdown file** — a new or improved agent." — 强调最小化 PR 的核心理念
+> "Great agents have: ✅ Narrow, deep specialization / ✅ Distinct personality and voice / ✅ Concrete code/template examples / ✅ Measurable success metrics / ✅ Step-by-step workflows / ✅ Real-world testing and iteration" — 好 Agent 的六项标准
 
 ## Key Concepts
-- [[Agent-Design-Principles]]：五大设计原则——鲜明性格/明确交付物/可量化指标/验证工作流/学习记忆
-- [[Agent-Template]]：YAML frontmatter + 结构化文档模板规范
-- [[Multi-Agent-Team]]：The Agency 框架下多智能体协作模式
-- [[Multi-Agent-System-Reliability]]：多智能体系统可靠性架构模式
+- [[AgentDesignPrinciples]]：Agent 设计五原则——强个性、清晰交付物、成功指标、经过验证的工作流、学习与记忆
+- [[PersonaVsOperations]]：Agent 文件的 Persona（身份/沟通/规则）与 Operations（使命/交付物/流程/指标）双分组结构
+- [[ExternalServicesDeclaration]]：Agent 可声明外部服务依赖，但必须独立于服务存在，测试标准是"去掉 API 调用后 Agent 仍有价值"
+- [[OpenClawFormat]]：OpenClaw 工作区格式，支持通过 convert.sh 自动将 Agent 文件转换为工具特定格式
 
 ## Key Entities
-- [[The Agency]]：msitarzewski 主导的多智能体开源项目（147 个专业化智能体，覆盖 12 个业务领域）
-- [[OpenClaw]]：The Agency 智能体运行的基础平台
-- [[msitarzewski]]（mar.mod）：The Agency 项目维护者
+- [[TheAgency]]：The Agency 是一个开源 AI Agent 集合项目，托管于 GitHub (msitarzewski/agency-agents)
+- [[MarekSitarzewski]]：The Agency 项目作者（GitHub: msitarzewski）
+- [[OpenClaw]]：Agent 工作区格式规范，定义了 Agent 文件的结构和 convert.sh 转换脚本
 
 ## Connections
-- [[contributing_zh-cn]] ← 同一文档的中文翻译版本，包含中文社区协作规范
-- [[Agent-Design-Principles]] ← 来源一致，均引用本文档定义五大设计原则
-- [[Agent-Template]] ← 来源一致，均引用本文档定义智能体文件结构
-- [[multi-agent-system-reliability]] ← 智能体设计规范层补充运行时可靠性模式
-- [[multi-agent-team]] ← The Agency 框架的多智能体协作模式
+- [[TheAgency]] ← authored_by ← [[MarekSitarzewski]]
+- [[AgentDesignPrinciples]] ← implements ← [[PersonaVsOperations]]
+- [[ExternalServicesDeclaration]] ← part_of ← [[AgentDesignPrinciples]]
+- [[OpenClaw]] ← converts ← [[AgentDesignPrinciples]]
 
 ## Contradictions
-- 无与其他 Wiki 页面的实质性内容冲突
-- 与 [[contributing_zh-cn]] 的差异：英文原版包含 Code of Conduct（行为准则）和 Recognition（贡献者认可机制）章节，中文翻译版侧重核心贡献流程和设计规范
+- 与 [[contributing_zh-cn]] 无冲突（中文版为本文档的翻译）