用途:在完成一次功能开发、Bug 修复或重构后,检查本次对话中的代码改动是否值得记录到项目 CLAUDE.md,帮助沉淀项目约定与决策。
主要能力:回顾对话历史,识别本次修改或创建的文件,并按新功能、Bug 修复、重构、配置变更、依赖更新分类;分析是否存在值得记录的项目约定与模式、技术决策、开发流程、避坑指南;读取项目根目录现有 CLAUDE.md,避免重复;生成更新建议,包含改动摘要、需新增内容、需修改内容,以及不需要更新的原因。
使用方式:调用 /check-claude-md,通常在完成 feature 或 fix 后手动执行,也可在 commit 前调用。流程为收集改动、分析可记录内容、读取现有 CLAUDE.md、生成建议、展示建议并询问确认,用户确认后使用 Edit 工具更新 CLAUDE.md。
适用场景:需要把不明显但重要的约定、架构决策、踩坑经验、项目特有模式沉淀到 CLAUDE.md 时。
限制:CLAUDE.md 应保持精简,不记录显而易见代码、一次性修复、通用最佳实践和具体业务逻辑细节;不记录临时代码与具体实现;更新前必须获得用户确认,不得未经确认修改。若项目根目录不存在 CLAUDE.md,会提示是否需要创建。