compound-refresh 用于长期维护 docs/solutions/ 中学习文档的质量。它会将已有学习内容与当前代码库对照，再刷新依赖这些学习的派生模式文档。
主要能力：支持交互与自主两种模式。交互模式在用户在场时逐项询问模糊决策；自主模式通过参数 mode:autonomous 启用，不进行用户交互，对无歧义情况执行保留、更新、自动归档或替换，对模糊情况标记为 stale，并生成报告。
维护模型：每个候选文档归为四类结果——Keep（仍准确，默认不改文件）、Update（核心方案仍正确但引用漂移，做有证据的就地编辑）、Replace（旧文档已误导且有已知更好替代，创建后继文档并归档旧文档）、Archive（不再有用，移入 docs/solutions/_archived/）。
使用方式：先发现 docs/solutions/ 下的 .md 文件，排除 README.md 与 _archived/。可用 $ARGUMENTS 缩小范围，依次尝试目录匹配、frontmatter 匹配、文件名匹配、内容搜索。范围分为聚焦、批量、广泛三类；广泛范围先做轻量分诊，按影响聚类并抽查引用文件是否仍存在。刷新顺序为先审查单个学习文档，再审查依赖它们的模式文档。
限制与注意：年龄本身不是过时信号；矛盾是强替换信号；归档前先查找后继文档。自主模式下仅凭记忆信号而无代码库佐证时应标记 stale。若未找到候选文档，会提示运行 superpowers-ruby:compound 开始积累知识库。具体安装命令、收费与平台信息暂未提供。