用途:该技能在代码变更后,更新对应组件或抽象文件夹中的 README.md,让文档与代码保持同步。文档原则是就近放置、精简、准确、紧凑,并只针对变更做增量更新。
主要能力:按变更类型执行相应动作,包括新增文件时在文件列表添加一行描述;删除文件时移除条目;重命名时更新条目;引入新模式时更新 Pattern 段;架构变化时更新 Architecture 段;文件数量变化时更新概览行计数;新增 block、menu、popup 类型时加入对应类型列表。README 约定结构包含标题与一句话说明、文件数、Architecture、Components/Modules/Types、Pattern 等段,仅在有需要时包含。
使用方式:在用户明确要求更新文档后,或在新增、删除、大幅修改某文件夹文件的任务完成后启用。流程为:确定受影响文件夹;读取现有 README;判断与现状的差异;只做最小改动;核对文件名、数量与描述是否准确。若文件夹尚无 README 且变更为新增子文件夹或抽象层,则按约定创建;若仅为拼写修正或小逻辑调整则跳过。该技能不更新 CLAUDE.md。
限制:不记录从代码即可看出的实现细节、函数级 API 文档、变更历史、TODO 或未来计划,也不写超过一句的文件描述或与 CLAUDE.md 重复的信息。只更新代码确实变更的文件夹。