权威wiki是索引加精选知识

更新于 2026-09-22

**权威 Wiki 的作用不是「让文档更好看」，而是给人和 Agent 一个统一的 Project Truth（项目事实入口）：Linear 告诉 Agent「这次要做什么」，权威 Wiki 告诉 Agent「这个项目长期怎么运转、为什么这样设计、哪些边界不能碰」。**

它解决的五个问题

  1. 消除信息散落 —— 重要知识散在 PRD、架构文档、.trellis/spec/、AGENTS.md、Linear comment、lesson、历史会话、部署脚本与 .env、以及人脑里。没有统一入口时，新 agent 每次都要重新调查，甚至按残缺信息自行推测。
  2. 给多 agent 共同认知 —— 不同平台的 Codex / Claude / Qoder 不共享会话记忆，但都可以从同一 Wiki 开始：开始 issue → 读对应页面 → 加载相关 spec 与 lesson → 再形成实施计划。这就是跨 agent 的 Shared Context，减少「换一个 agent 就从头解释」。
  3. 解释「为什么」 —— 代码只能说「现在怎么写」，不能说明为什么区分 apps/agent 与 apps/ai-workflows、为什么测试与正式环境必须隔离、为什么服务器只 docker pull、为什么某种实现曾被否决。这些属于 Architecture / ADR（架构决策记录）/ Operations 页。
  4. 成为自动验收的依据 —— 主管 agent 据此判断是否违反模块边界、是否遗漏环境配置、是否该新增 ADR、实现是否重蹈已有 lesson。没有权威资料，主管 agent 的「验收」本质上只是凭模型常识猜测。
  5. 降低人的注意力开销 —— 已有事实查 Wiki、已有坑点查 Lesson、已有规范查 Spec，只有真正的新产品选择才来问你。

边界：Wiki ≠ 把所有东西复制进来

它是 Index + Curated Knowledge（索引 + 精选知识），不是文档垃圾场。它可以（也应该）引用其他事实源：具体规则留在 spec，具体 issue 进展留在 Linear，Wiki 只负责告诉读者「应该去哪里找到什么」。

⇒ 判据：这条内容是不是「长期有效、跨 issue 使用」的？ 是 → Wiki；只在某个 issue 内有效 → 任务目录 / Linear；只是过程记录 → journal。

相关