用途:防止语义重复与代码膨胀。它针对的问题不是复制粘贴,而是 AI 反复重新实现相同用途的功能。核心原则是先查后写:在编写任何新函数前,先查 CODE_INDEX.md、搜索代码库类似功能,能扩展就扩展,确认没有合适实现才新建;写完后立即更新索引,并定期审计重复。
主要能力:在项目根目录维护 CODE_INDEX.md,按能力而非文件位置组织,含快速参考表、各分类函数表(函数名、位置、作用、参数)。提供文件头与函数注释模板,便于索引生成。提供检查决策树(精确匹配则直接使用、类似则可扩展、无则新建并更新索引)。归纳常见重复模式,如工具函数重复实现、版本略有差异的多个函数、应抽取的内联逻辑。提供定期审计清单与输出格式,分高、中、低优先级标注合并建议。对大型代码库可选接入向量库(ChromaDB 或 LanceDB)做语义检索,并按规模给出建议:少于 50 个文件用 Markdown 索引即可,50-200 个文件加定期审计,200 个以上加向量库,500 个以上为必需。
使用方式:按索引结构模板维护 CODE_INDEX.md,运行 /update-code-index 更新索引、/audit-duplicates 审计重复;Claude 在会话开始读取索引,写代码前检索并确认,新文件加文件头、函数加单行说明,改完同步提交索引。命令与模板原文照用。
适用场景:需要在 AI 辅助开发中控制重复实现与代码膨胀、统一工具函数与校验逻辑、维护项目能力清单的团队或项目。
限制:资料未提供具体安装命令、依赖版本、收费与价格信息;向量库集成为可选,具体效果未提供;索引与审计需人工维护并保持一致,否则易失效。