用途:docs-cleaner 用于整合冗余文档,在减少篇幅的同时保留全部有价值内容。核心原则是先评估再删除,绝不盲目删除,逐节分析其独特价值后再提出移除建议,目标是减量而不丢失信息。
主要能力与工作流:
- 发现阶段:找出覆盖同一主题的所有文档文件,统计各文件总行数,梳理文档之间的内容重叠。
- 价值分析阶段:为每份文档建立逐节分析表,包含章节、行数、价值、理由;价值类别分为保留(独特、必要、常被引用)、精简(有价值但冗长)、删除(重复、一次性、显而易见、过时)。详细标准见 references/value_analysis_template.md。
- 整合计划阶段:提出目标结构,并给出前后对比指标,例如从 726 行(3 个文件、高度冗余)缩减到约 100 行(1 个文件加 CLAUDE.md 中的引用),缩减 86%,价值保留 100%。
- 执行阶段:创建包含全部有价值内容的整合文档,删除冗余源文件,更新引用(CLAUDE.md、README、imports),并验证没有失效链接。
价值保留清单:定稿前需确认保留必要流程(安装、配置)、关键约束与注意事项、故障排查指南、技术债与路线图条目、外部链接与参考、调试技巧与代码片段。
反模式:盲目删除会丢失有价值信息,应先做逐节分析;全部保留则无法实现缩减,应严格执行价值标准;多个事实来源会导致未来分歧,应保留单一权威位置;孤立引用会造成链接失效,整合后需更新所有引用。
输出产物:整合后的文档(单一事实来源)、价值分析(逐节理由)、前后指标(减少行数、保留价值)、更新后的引用(CLAUDE.md 或 README 指向新位置)。
限制:资料未提供具体安装命令、支持的平台、收费方式或价格信息,暂未提供。