用途:把混乱的大型文档项目重构为渐进式披露(Progressive Disclosure)结构,让文档可导航、更省 token。适合 300+ 文档无清晰结构、需降低上下文占用、生成导航索引、按用途重排文件、统一命名规范的场景。
主要能力:采用 3-4 层分类(顶层按用途、子层按功能、再下为文档);坚持按用途而非格式组织目录;统一命名(目录用小写复数加连字符,如 knowledges/、for-* 前缀;技术文档用 [number]-[topic]-[subtitle].md,业务文档用 [topic]-[category].md);要求每个主要目录写 README.md 索引;在项目根维护 CLAUDE.md 主索引。宣称通过三层结构(主索引→分类索引→文档索引)把 token 占用从约 20MB 级降到约 50KB,节省 95% 以上。
使用方式:分五步。1)分析现状:tree -L 3、find . -name "*.md" | wc -l、find . -type d -maxdepth 2。2)分析现有模式(格式型/用途型/混合)。3)给出方案:方案 A 按用途重组,方案 B 原地加结构,需用户确认后执行。4)重组文件:mkdir -p 建目录、mv 或 git mv 移动改名。5)建索引:各目录 README.md、根目录 CLAUDE.md。还提供 tree -L 2 --du --dirsfirst、tree -I "node_modules|.git|pycache"、tree -L 3 > tree.md 等可视化命令。
适用场景:大型项目文档、客户/合作伙伴材料、技术设计、合规资料、知识库等需要按角色导航的文档集合。
限制:需用户先确认重组方案;移动文件应优先用 git mv 保留历史;层级控制在 3-4 层;避免按格式分目录和驼峰/下划线混用命名。资料未提供安装命令、收费与平台支持信息。