Skip to content

Wiki Lint Report

Scope

本轮 lint 针对 E:\Ai+人协作系统\wiki\ 做了结构和链接检查。

已发现并修复的问题

1. 根目录与 wiki/ 重复维护 canonical 页

问题:

  • 根目录与 wiki/ 曾同时存在一套知识页

处理:

  • 删除根目录重复 canonical 页
  • 保留根目录 欢迎.md 作为 portal

2. source 与专题目录重复

问题:

  • raw/ 和旧专题目录同时保存原稿副本

处理:

  • 删除旧专题目录中的重复原稿
  • 保留 raw/ 作为唯一 source 层

问题:

  • 存在 <span class="wikilink-dead" title="未找到: ../..." style="color:#c33;border-bottom:1px dashed #c33">../...</span> 相对链接和普通链接混用

处理:

  • 统一改为指向 canonical 路径的显式 wikilink

4. 缺失完整 llm-wiki-agent 目录层

问题:

  • 早期版本缺 overview / sources / entities / concepts / syntheses / graph

处理:

  • 已全部补齐

当前结构状态

当前仓库已经具备:

  • raw/
  • wiki/
    • schema.md
    • index.md
    • log.md
    • overview.md
    • sources/
    • entities/
    • concepts/
    • syntheses/
  • graph/

当前剩余问题

1. 仍缺自动 graph 推断边

当前 graph/graph.jsongraph.html 已经可以基于显式 wikilinks 工作,但还没有实现:

  • implicit relationships
  • inferred edges
  • confidence scoring

2. synthesis 规模还小

当前只有第一批与第二批 synthesis 页面,后续应继续扩大:

  • runtime ownership
  • memory / wiki 边界
  • collaboration workflow
  • sequencing logic

3. entities / concepts 仍可继续扩展

当前第二轮补完后,核心对象页已经覆盖:

  • Runtime
  • Issue
  • Chat
  • Comment
  • User ID
  • Agent ID
  • Memory Item

后续仍可继续补更细的制度型概念页。

4. 页面职责边界需要长期保持

当前已经开始收敛:

  • 概念词典 只做术语导航
  • concepts/entities/ 负责定义权
  • syntheses/ 负责综合判断
  • system/ 负责运行机制

后续新增页面必须遵循这个边界,否则知识库会重新出现解释权分散问题。

5. 操作页与制度页需要继续分层

当前已经开始补:

  • 操作模板页
  • 操作手册页
  • 制度规则页
  • 运行机制页

后续应继续保持:

  • 模板页不解释制度合理性
  • 制度页不承载具体模板
  • 综合页不抢定义权

6. 剩余高价值页主权声明已补齐

本轮已继续收敛:

  • How to Implement Review Flow in Multica
  • Review Issue Template
  • 企业版Source进入规则
  • Wiki-first vs RAG-first Retrieval Strategy
  • Feishu as Publishing Layer

这批页面现在都明确了“自己负责什么、不负责什么”。

建议下一步

  1. 继续补充 syntheses/
  2. 增加更多 entities/concepts/
  3. 如果要完全贴近 llm-wiki-agent,再补 inferred graph workflow

结论

本轮 lint 后,这个仓库已经进入“结构完整、去重完成、开始持续编译”的状态。

TeamOS · docs as code · canon=权威知识,drafts=候选区