Wiki 未分类

lint-report-2026-07-02

Created: 2026-07-02

Lint Report — 2026-07-02 wiki 整理与过时性审查

结论

本次检查只做本地结构审计,不联网判断事实真伪。wiki 主体结构没塌:28 个内容页 frontmatter 齐全,内容页都有 raw 来源引用,没有未来日期;但有三类明确漂移,得处理,不然下次 agent 进来还是会被旧索引带偏。

检查范围

  • 根规则:CLAUDE.mdAGENTS.md
  • 启动上下文:wiki/SOUL.mdwiki/CRITICAL_FACTS.mdwiki/hot.mdwiki/index.mdwiki/overview.md
  • 内容目录:wiki/concepts/wiki/entities/wiki/syntheses/wiki/references/
  • 结果目录:outputs/reports/outputs/slides/outputs/figures/
  • 校验命令:bash scripts/raw-integrity.sh verify

已修复

  • wiki/index.md 缺少 [[wiki/concepts/Loop Engineering]],已补入 Agent 编程主线。
  • wiki/concepts/_context.md 仍写 11 页 / Agent 编程主线 9 页,已更新为 12 页 / 10 页。
  • wiki/hot.mdwiki/CRITICAL_FACTS.md 的规模快照仍停在 6 月 23 日,已更新为 2026-07-02 的扫描状态。
  • wiki/concepts/Obsidian、LLM Wiki 与个人知识管理.md 有 2 处来源链接未带 raw/ 前缀,已改为 raw/2026-04-06/技术爬爬虾/换了N个笔记工具,最终我还是选择了 Obsidian.md

高优先级问题

P1 — raw 完整性校验过期

bash scripts/raw-integrity.sh verify 未通过:

  • .checksums 记录:719 条 raw Markdown
  • 当前扫描:865 个 raw Markdown
  • 差异:146 新增、1 修改、0 缺失

这说明 raw 层已经新增了一批来源,但还没有完成 checksum 快照刷新。按仓库规则,raw/ 不可变,所以本次没有直接运行 generate 覆盖 raw/.checksums。正确处理方式是先确认这 146 个新增源和 1 个修改源都是预期摄入,再运行完整 ingest/校验流程。

P1 — 新 raw 尚未反向编译到 wiki

新增 raw 集中在 2026-06-21 到 2026-07-02,主题明显覆盖 Loop Engineering、Harness Engineering、Skills、Agent 记忆、WorkBuddy、多 Agent、Nacos/ES 等。当前 wiki 只有 wiki/concepts/Loop Engineering.md 明确承接了一部分 6 月下旬材料,其他大页如 Skills、Agents 与工具设计上下文管理与 Harness EngineeringAgent 原理、记忆与上下文工程 很可能需要二次 ingest。

P2 — source_count 口径漂移

按唯一 raw/ 路径重算,18 个内容页的 frontmatter source_count 和实际唯一来源数不一致。典型例子:

  • wiki/concepts/Loop Engineering.md:frontmatter 25,唯一 raw 链接 13
  • wiki/references/raw-主题索引.md:frontmatter 394,唯一 raw 链接 456
  • wiki/concepts/上下文管理与 Harness Engineering.md:frontmatter 85,唯一 raw 链接 94
  • wiki/entities/Claude Code.md:frontmatter 64,唯一 raw 链接 76

这不是简单数字替换能解决的破事,因为当前页面可能把 source_count 当作“独立源文件数”,但有些页面更像在记“摄入源数量”或“主题索引规模”。建议先统一口径:以后 source_count 只数唯一 raw 文件;引用次数另建字段或不记录。

疑似过时内容

以下页面 last_updated 明显早于 2026-06-21,且后续 raw 已新增大量相关材料:

  • wiki/syntheses/微信同步选题流.md:2026-05-01,仍停在早期同步助手材料,应决定是否继续维护;如果不维护,建议 lifecycle 改为 stale
  • wiki/references/raw-主题索引.md:2026-05-31,当前 raw 已增到 865 个 Markdown,主题索引肯定落后。
  • wiki/concepts/Obsidian、LLM Wiki 与个人知识管理.md:2026-06-16,后续已有 LLM Wiki / 第二大脑 / WorkBuddy+Obsidian 相关来源,建议复核补充。

结果目录

outputs/ 当前只有空目录:

  • outputs/reports/
  • outputs/slides/
  • outputs/figures/

没有发现可晋升结果文件。换句话说,本轮没法做 outputs -> wiki 晋升,别硬编。

其他漂移

  • CLAUDE.md 提到 .codex/rules/skill-throttling.md.codex/rules/nowledge-mem-guidance.md,但当前 checkout 里不存在这两个文件。需要确认是规则文件漏提交、路径迁移,还是 AGENTS 注入层的陈旧指针。
  • graphify-out/graph.json 存在,graphify query 可运行;但本次是 wiki 内容审计,不需要读 469KB 的 GRAPH_REPORT.md

建议动作

  1. 先确认 raw 新增和 1 个修改是否符合预期,再刷新 raw/.checksums
  2. 以 2026-06-21 到 2026-07-02 的新增 raw 为输入,跑一次 /kb-ingest,重点更新 Loop / Harness / Skills / Agent memory 相关页。
  3. 重建 wiki/references/raw-主题索引.md,否则它会继续给出过期的 raw 覆盖图。
  4. 统一 source_count 口径后再批量修 frontmatter;不要现在拍脑袋改数。
  5. 如果 微信同步选题流 不再维护,明确标 stale;如果还要维护,就补最近同步源。

输入关键词开始搜索