ce-compound-refresh

用途

ce-compound-refresh 用于长期维护 docs/solutions/ 目录下文档的质量。它审查现有的学习文档（learning docs）与当前代码库是否一致，然后刷新依赖这些学习的派生模式文档（pattern docs）。

主要能力

• 模式检测：检查参数中是否包含 mode:headless。若存在，则剥离该标记，将剩余部分作为范围提示，并以无头模式运行。
• 维护分类：对每个候选文档归类为五种结果之一：
  • Keep：仍然准确且有用，默认不编辑文件，仅报告已审查且可信。
  • Update：核心解决方案仍正确，但引用发生漂移，应用有证据支持的原地编辑。
  • Consolidate：两个或多个文档高度重叠但都正确，将独有内容合并到规范文档，删除被吸收的文档。
  • Replace：旧文档已具误导性，但存在已知的更好替代，创建可信的继任文档后删除旧文档。
  • Delete：不再有用、适用或独特，删除文件（git 历史会保留）。
• 刷新顺序：先审查相关的单个学习文档，记录哪些学习保持有效、被更新、被合并、被替换或被删除；然后审查依赖这些学习的模式文档。
• 范围选择：发现 docs/solutions/ 下的学习与模式文档，排除 README.md 和 docs/solutions/_archived/。若提供参数，按目录匹配、frontmatter 匹配、文件名匹配、内容搜索的顺序缩小范围。
• 按范围路由：Focused（1-2 个文件）、Batch（最多约 8 个独立文档）、Broad（9 个以上文档或仓库级扫描）。Broad 范围先做轻量分诊，按影响聚类并抽查漂移。
• 调查维度：对每个学习文档检查引用、推荐解决方案、代码示例、相关文档、自动记忆（仅 Claude Code）、重叠、词汇等维度。
• 漂移分类：区分 Update（引用移动但解决方案相同）与 Replace（解决方案本身已改变）。
• CONCEPTS.md 引导：若被专门调用来创建或引导 CONCEPTS.md，会先消歧义，提供两个选项：创建 CONCEPTS.md（构建概念图）或运行刷新周期。
• 报告生成：无头模式下始终生成报告，包含 Applied（成功写入的操作）与 Recommended（无法写入的操作及完整理由）两部分。

使用方式

• 交互模式（默认）：用户在场并可回答问题，就模糊情况询问决策并确认操作。交互原则包括：一次问一个问题，优先使用平台阻塞式提问工具（Claude Code 的 AskUserQuestion、Codex 的 request_user_input、Gemini 的 ask_user、Pi 的 ask_user），仅在无阻塞工具或调用出错时回退到纯文本编号选项；自然存在选项时优先多选；先问范围与意图，再按需收窄；不要在获得证据前让用户做决定；先给出建议并简要解释。
• 无头模式：参数中包含 mode:headless 时启用。跳过所有用户问题，从不暂停等待输入；处理范围内所有文档；尝试所有安全操作；不确定时标记为 stale；使用保守置信度；始终生成报告。

适用场景

• 需要定期维护 docs/solutions/ 下学习文档与模式文档准确性的项目。
• 代码库发生重构、文件重命名、类移动后，需要同步更新相关文档。
• 存在多个高度重叠文档，需要合并为规范文档。
• 需要以无头方式在 CI 或自动化流程中批量审查文档漂移。

限制

• 该技能的工作是文档准确性，而非代码审查；不询问用户代码更改是否“有意”或“是回归”。
• 避免低价值改动：不为了修复拼写错误、润色措辞或做表面更改而编辑文档。
• 仅在存在真实替代时才使用 Replace。
• 删除前需检查入站链接；自动删除的条件是代码缺失、无匹配继任文档、引用缺失或仅为装饰性引用。
• 不设 _archived/ 目录，删除即删除，git 历史即归档。
• 无头模式下若提供了范围提示但未匹配到任何内容，会在摘要中报告未命中并退出，不会静默回退到处理全部文档。
• 若未找到候选文档，会报告：No candidate docs found in docs/solutions/. Run ce-compound after solving problems to start building your knowledge base.
• 关于收费、价格、平台支持等具体信息，资料中暂未提供。