讨论 — 文档体系体检诊断¶
原文 / 原始内容¶
分析已有的文档结构，能实现快速检索和不断迭代改进吗？知识不断沉淀？可持续维护？
我的诊断（数据驱动）¶
跑了几个脚本扫描 docs/，找到：
严重问题¶
- raw INDEX 漏 50%（列 2 条，实际 4 条）
- issues INDEX「按类别」只覆盖前 5 个（0006-0021 共 16 个没归类）
- issues 头部状态信息双重维护（frontmatter
status: fixed+ 引用块> 状态：✅ 已修复） - 9 个 wikilink 断链（含 SPEC-001 / github-推送 的真断链）
- 同一主题散在 10 个文件（watchdog 没主题入口）
中等问题¶
- 25 个文件缺 frontmatter description
- 没有 _overview.md 让 AI 一页纸建立上下文
- 没有自动化校验（INDEX / 断链 / frontmatter 全靠手工）
评分¶
- 快速检索 🟡 6/10
- 沉淀迭代 🟢 8/10
- 可持续维护 🔴 4/10 ← 核心症结：无 enforcement
根本原因¶
文档体系本身设计 OK，但全靠人/AI 自觉遵守模板和约定。违反约定不会报错，错误持续累积。
处理方向¶
- 归入 spec → SPEC-003-文档治理自动化