Update nexus: fix conflicts and sync local changes

wiki/sources/readme.md

@@ -1,52 +1,40 @@
----
-title: "Examples - Agency Multi-Agent Collaboration Showcase"
-type: source
-tags: []
-date: 2026-04-25
----
-
-## Source File
-- [[Agent/agency-agents/examples/README.md]]
-
-## Summary（用中文描述）
-- 核心主题：展示 agency-agents 中多个专业 Agent 如何协作完成真实任务的案例目录
-- 问题域：Agent 协作的实践价值证明——仅靠 Agent 定义无法展示多 Agent 联合部署的效果
-- 方法/机制：通过具体案例回答"当全体 Agent 同时部署在同一任务上时会发生什么"这一问题
-- 结论/价值：8 个 Agent 并行运行，产出一致、相互引用的完整计划，无需协调开销
-
-## Key Claims（用中文描述）
-- 8 个专业 Agent 并行运行，产出了连贯且相互引用的完整计划，无协调开销
-- 多 Agent 协作可从"发现机会"到"完整蓝图"在单次会话中完成
-- 好的案例应展示多个 Agent 协作、Agent 能力广度、真实世界适用性
-
-## Key Quotes
-> "What does it actually look like when the full agency collaborates?" — 核心问题
-> "All 8 agents ran in parallel and produced coherent, cross-referencing plans without coordination overhead." — 核心成果
-> "Multiple agents collaborating on a shared objective" — 好案例的三要素之首
-
-## Key Concepts
-- [[Multi-Agent-Collaboration]]：多个专业 Agent 在同一任务上并行协作，通过共享上下文相互引用，无需显式协调
-- [[Agents-Orchestrator]]：多 Agent 开发流水线编排器，与本示例的"并行部署"同属 Agent 协作机制，后者强调编排层，前者强调执行层
-
-## Key Entities
-- [[Product-Trend-Researcher]]：产品趋势研究员——市场验证与竞争格局分析（示例中参与协作的 8 个 Agent 之一）
-- [[Backend-Architect]]：后端架构师——系统架构、数据模型、API 设计（示例中参与协作的 8 个 Agent 之一）
-- [[Design-Brand-Guardian]]：品牌守护者——定位、视觉身份、品牌命名（示例中参与协作的 8 个 Agent 之一）
-- [[Growth-Hacker]]：增长黑客——GTM 战略、定价、发布计划（示例中参与协作的 8 个 Agent 之一）
-- [[Support-Responder]]：支持响应员——支持层级、入职、社区建设（示例中参与协作的 8 个 Agent 之一）
-- [[UX-Researcher]]：用户体验研究员——用户画像、旅程地图、设计原则（示例中参与协作的 8 个 Agent 之一）
-- [[Project-Management-Project-Shepherd]]：项目看护者——阶段计划、Sprint、风险登记（示例中参与协作的 8 个 Agent 之一）
-- [[XR-Interface-Architect]]：XR 界面架构师——空间 UI 规范（示例中参与协作的 8 个 Agent 之一）
-- [[Nexus-Spatial-Discovery]]：具体的 8 Agent 并行协作案例——市场验证到技术架构到品牌策略到 GTM 计划的完整产出
-
-## Connections
-- [[Nexus-Spatial-Discovery]] ← exemplifies ← [[Multi-Agent-Collaboration]]
-- [[Multi-Agent-Collaboration]] ← extends ← [[Agents-Orchestrator]]
-- [[Multi-Agent-System-Reliability]] ← provides framework ← [[Multi-Agent-Collaboration]]
-
-## Contradictions
-- 与 [[Multi-Agent-System-Reliability]] 中的"需显式协调机制确保一致性"：
-  - 冲突点：Multi-Agent-System-Reliability 强调需要结构化协调（主管→工作→验证链），但示例中 8 个 Agent 无需显式协调即产出连贯结果
-  - 当前观点：并行 Agent 通过共享上下文和独立产出实现自我协调
-  - 对方观点：幻觉和重复问题需通过架构约束（Consensus Voting / Adversarial Debate 等）强制解决
-  - 可能的调和：示例中"无需协调"可能是因为任务天然解耦；若 Agent 间存在依赖关系，仍需协调机制
+---
+title: "OpenCode Integration"
+type: source
+tags: []
+date: 2026-04-26
+---
+
+## Source File
+- [[Agent/agency-agents/integrations/opencode/README.md]]
+
+## Summary（用中文描述）
+- 核心主题：OpenCode 的子 Agent 集成机制——如何将 .md 文件格式的 Agent 转换为 OpenCode 可调用的子代理
+- 问题域：OpenCode IDE 中的多 Agent 协作与按需调用
+- 方法/机制：通过 YAML frontmatter 中的 `mode: subagent` 标记，将具名 Agent 从 Tab 循环列表中分离，改为按需 `@agent-name` 调用；颜色通过命名颜色到十六进制的自动映射实现
+- 结论/价值：提供了一种轻量级、无需修改主 Agent 系统的子 Agent 扩展方案，支持项目级和全局级两种安装范围
+
+## Key Claims（用中文描述）
+- OpenCode Agent 通过在 `.opencode/agents/` 目录存储 .md 文件（带 YAML frontmatter）实现——文件格式与 The Agency 的 Agent 定义格式兼容
+- `mode: subagent` 配置使 Agent 仅在 `@agent-name` 触发时出现，不会在 Tab 循环列表中占位——保持主 Agent 列表的简洁性
+- 命名颜色（如 `cyan`）在安装脚本中被自动转换为十六进制颜色代码——无需手动查表
+- Agent 支持两种安装范围：项目级（`.opencode/agents/`）和全局级（`~/.config/opencode/agents/`）——通过不同路径实现作用域隔离
+- 转换脚本 `./scripts/convert.sh --tool opencode` 负责将 The Agency 的标准 Agent 文件转换为 OpenCode 兼容格式
+
+## Key Quotes
+> "mode: subagent — agent is available on-demand, not shown in the primary Tab-cycle list"
+> — Agent YAML frontmatter 的核心语义，说明 subagent 模式与普通 agent 的本质区别
+
+## Key Concepts
+- [[Subagent]]：按需调用的辅助 Agent，通过 `@agent-name` 语法触发，不参与 Tab 循环
+- [[OpenCode]]：一个支持多 Agent 协作的 IDE/编辑器扩展平台
+
+## Key Entities
+- [[The Agency]]：OpenCode Agent 的来源框架，提供 147 个专业化 Agent 定义
+
+## Connections
+- [[contributing]] ← 贡献来源 ← [[Agent/agency-agents/integrations/opencode/README.md]]
+- [[The Agency]] ← Agent 定义来源 ← [[Agent/agency-agents/integrations/opencode/README.md]]
+
+## Contradictions
+- （未检测到与其他页面的明显冲突）