SuperAPI AI 工具集

ce-compound-refresh

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:维护 docs/solutions/ 中经验(learnings)与模式(pattern)文档的准确性,防止文档随代码演进而过时、漂移或重复。先审查相关单篇经验文档,再刷新依赖它们的模式文档,避免过时经验让模式显得仍有效。

模式:默认交互模式,适合有用户在旁回答问题的场景,对模糊情形提问并确认操作;参数含 mode:autofix 时进入自动修复模式,先剥离该参数,其余作为范围提示,全程不提问、处理范围内全部文档,能安全写入的就应用(保留、更新引用、合并、满足无歧义条件时自动删除、证据充分时替换),写入失败则记入报告继续,无法确定则在前置元数据标记 stale、stale_reason、stale_date,最后始终生成含已应用与建议两部分的主报告。

维护判定:分为 Keep(仍准确,默认不改)、Update(核心方案有效但路径、模块名、链接、元数据、代码片段等引用漂移,做证据支撑的就地修改)、Consolidate(多篇高度重叠且都正确,合并唯一内容到规范文档并删除被吸收文档)、Replace(旧文档已误导且有已知更好替代,先写可信后继再删旧文)、Delete(代码已不存在且无后继,直接删除,git 历史即存档)。仅做有意义的漂移修正,不为留痕或拼写美化而改动。

使用方式:扫描 docs/solutions/ 下所有 .md 文件,排除 README.md 与 _archived/(后者若存在应在报告中标注为需清理的遗留物);可用参数按目录、前置元数据、文件名、内容依次匹配缩小范围,无匹配则报告并请用户澄清,自动修复模式下直接报告停止。按范围选择聚焦、批量或广域路径,广域时先做清单、影响聚类与漂移抽查,再按影响顺序处理。

限制:替换判断需真实替代证据(已解决并验证的修复、用户提供足够上下文、代码库调查或更新的文档与 PR/issue),边界在于一旦要重写方案章节即属替换而非更新;记忆来源的漂移仅作辅助信号,无代码库佐证时自动修复模式只标记 stale;年龄本身不是过时依据;不设 _archived/ 目录。资料未提供安装命令、收费、平台与具体效果信息。