docs-toc-shards-style

不要将冗长的 SPEC.md、README.md 或 PLAN.md 等根目录文档全部塞进一个文件，而应像精心撰写的文章一样将其拆分为较小的单元（每个分片控制在 2–5KB），根目录文档仅保留简明的目录（TOC）+ 1~2 行摘要 + 链接。触发条件包括：用户提及“SPEC 太长了”、“做个目录吧”、“拆细点管理”、“让 LLM 能快速定位”、“注意力机制只看开头和结尾”、“像结构清晰的书籍那样组织内容”等表述，或当 SPEC/README/PLAN/ARCHITECTURE 等根文档超过 200 行 / 15KB 并频繁进入 LLM 上下文时。核心原则是：根文档作为索引，具体内容下沉至分片（shard），各分片之间通过 [[wiki-link]] 实现相互引用，并反向利用注意力机制的局限性（主要关注首尾部分），使每个分片本身保持简短且自包含。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本