Compound Refresh — 学习笔记维护专家
自动审计并维护项目解决方案文档（solutions/），清除过时记录，确保知识库持续可信。
该技能包含一个内联的 bash 脚本，用于调用 contexts.mjs 脚本，该脚本会解释代理工具的使用并可能覆盖系统提示中的限制。它还指示代理以非交互模式静默执行文件写入、删除、重命名和合并，而无需用户确认。虽然错误场景以优雅降级处理，但缺少明确的用户确认步骤以及对内部脚本的信任不明，降低了信任评分。评估为12分，因主要风险可见但权限控制、确认流程和安全隔离不完整。
该技能通过上下文脚本和验证脚本实现了结构化的工作流程，包含错误处理与降级机制（如脚本缺失或执行失败时继续）。但静态审查无法验证脚本在真实环境中的可靠性，且未发现完整的测试套件。可靠性评为9分，因关键路径有防护但缺乏实际验证，失败反馈机制尚可但覆盖不足。
技能定义了清晰的适用场景、范围提示和非交互模式，提供了范围缩窄策略和明确的边界（如不处理未指定范围）。但对触发条件的描述可能过于具体，可能导致误触发或漏触发。环境适配性方面未明确提及对China网络可达性的依赖。评为10分，因场景明确但边界证据有限。
该技能结构良好，提供了详细的参考文件和脚本，包括schema、yaml验证和claims验证。包含MIT许可证、清晰的维护路径和版本控制。但缺少changelog和版本号信息，部分依赖外部未验证的脚本，降低评分。评为11分，因文档分层清晰、示例充分，但版本治理和历史记录不完整。
技能目标明确，旨在审计和刷新学习文档，并提供了详细的操作流程。但静态审查无法验证其实际效果，且输出格式（报告）需要用户解读，直接可用性有限。评为6分，因核心任务描述清晰但实际输出未经验证，边际价值证据不足。
静态审查无法执行脚本或验证其真实性。虽然提供了验证脚本（如validate-frontmatter.py和validate-doc-claims.py），但缺少独立的测试套件或第三方的执行证据。评为4分，因可审计的原始材料有限，且无法独立验证。
- 该技能在非交互模式下会自动执行写入、删除、重命名和合并操作，请确保运行环境已正确备份，避免意外数据丢失。
- 脚本 context.mjs 可能修改代理工具的授权行为，请在可信环境中使用，并审查其输出。
- 技能声称支持多种平台，但未验证在China大陆网络环境下的可用性，可能无法访问相关外部服务。
这个 Skill 能做什么，适合哪些场景？
该技能审计 <root>/solutions/ 下的学习笔记（.md 文件），与当前代码库交叉核对，执行维护操作：保留有效内容、更新过时引用、合并重复文档、替换错误指导或删除不再适用的内容。它生成完整报告并提交更改，必要时与用户交互确认。技能支持交互式与非交互式两种模式，可处理 9 个以上文档的批量扫描，并包含概念词汇表（CONCEPTS.md）的同步与可发现性检查。
扫描 <root>/solutions/ 下的 Markdown 文件（排除 README）；用代码库交叉验证文档内容；对每个文档执行 Keep/Update/Consolidate/Replace/Delete 分类；运行启动脚本获取上下文；调用子代理进行深入调查；在替换时重写文档；更新引用；管理 CONCEPTS.md 词汇表；生成详细报告；创建 Git 提交（交互模式下询问）。
- 刚完成一次功能开发，想确保之前的解决方案文档仍与最新代码一致。
- 代码库重构导致许多文档引用的路径已失效，需要批量更新。
- 两个文档内容高度重叠，希望合并为一个权威文档。
- 非交互式 CI 任务中自动清理过时的学习笔记，无需人工干预。
- 怀疑某份文档建议已不再适用，需要判断是更新还是替换。
这个 Skill 有哪些优点和局限？
- 自动化知识库维护，省时省力。
- 提供明确的操作分类（保留、更新、合并、替换、删除），减少主观判断。
- 支持非交互模式，适合 CI 集成。
- 保障文档与代码同步，防止信息过时。
- 需要代码库可访问，才能进行验证。
- 对无法验证的声明保留内容，但可能无法检测所有漂移。
- 复杂操作（如替换、拆分）需要人工确认。
- 测试用例或跨平台支持未在源中明确。
如何安装这个 Skill？
作为官方 Compound Engineering 插件的一部分，通过各平台的插件系统安装。例如 Claude Code：/plugin marketplace add EveryInc/compound-engineering-plugin 然后 /plugin install compound-engineering。Cursor 使用 /add-plugin compound-engineering，Codex CLI 使用 codex plugin marketplace add 和 codex plugin add。
如何使用这个 Skill？
在支持的编码代理中，直接以自然语言发起技能，例如：'运行 ce-compound-refresh'，或附带范围提示如 'ce-compound-refresh src/模块'。添加 mode:non-interactive 可启用无提示模式。技能会读取配置、扫描文档、执行维护并输出报告。