开发与工程

Compound Refresh — 学习笔记维护专家

自动审计并维护项目解决方案文档(solutions/),清除过时记录,确保知识库持续可信。

52/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 25k
最近更新
3 天前
License
MIT
knowledge-managementdocumentation-maintenancelearning-refreshstale-detection
+1coding-agents

这个 Skill 能做什么,适合哪些场景?

该技能审计 <root>/solutions/ 下的学习笔记(.md 文件),与当前代码库交叉核对,执行维护操作:保留有效内容、更新过时引用、合并重复文档、替换错误指导或删除不再适用的内容。它生成完整报告并提交更改,必要时与用户交互确认。技能支持交互式与非交互式两种模式,可处理 9 个以上文档的批量扫描,并包含概念词汇表(CONCEPTS.md)的同步与可发现性检查。

扫描 <root>/solutions/ 下的 Markdown 文件(排除 README);用代码库交叉验证文档内容;对每个文档执行 Keep/Update/Consolidate/Replace/Delete 分类;运行启动脚本获取上下文;调用子代理进行深入调查;在替换时重写文档;更新引用;管理 CONCEPTS.md 词汇表;生成详细报告;创建 Git 提交(交互模式下询问)。

适合
  • 刚完成一次功能开发,想确保之前的解决方案文档仍与最新代码一致。
  • 代码库重构导致许多文档引用的路径已失效,需要批量更新。
  • 两个文档内容高度重叠,希望合并为一个权威文档。
  • 非交互式 CI 任务中自动清理过时的学习笔记,无需人工干预。
  • 怀疑某份文档建议已不再适用,需要判断是更新还是替换。

如何安装这个 Skill?

使用前请注意
  • 该技能在非交互模式下会自动执行写入、删除、重命名和合并操作,请确保运行环境已正确备份,避免意外数据丢失。
  • 脚本 context.mjs 可能修改代理工具的授权行为,请在可信环境中使用,并审查其输出。
  • 技能声称支持多种平台,但未验证在China大陆网络环境下的可用性,可能无法访问相关外部服务。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 本地文件系统
需要预先安装
  • Node.js (optional)

作为官方 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。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/EveryInc/compound-engineering-plugin.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/ce-compound-refresh" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 运行 ce-compound-refresh
  • ce-compound-refresh src/模块

在支持的编码代理中,直接以自然语言发起技能,例如:'运行 ce-compound-refresh',或附带范围提示如 'ce-compound-refresh src/模块'。添加 mode:non-interactive 可启用无提示模式。技能会读取配置、扫描文档、执行维护并输出报告。

这个 Skill 有哪些优点和局限?

优点
  • 自动化知识库维护,省时省力。
  • 提供明确的操作分类(保留、更新、合并、替换、删除),减少主观判断。
  • 支持非交互模式,适合 CI 集成。
  • 保障文档与代码同步,防止信息过时。
局限
  • 需要代码库可访问,才能进行验证。
  • 对无法验证的声明保留内容,但可能无法检测所有漂移。
  • 复杂操作(如替换、拆分)需要人工确认。
  • 测试用例或跨平台支持未在源中明确。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Compound Refresh — 学习笔记维护专家 本页 52 · 谨慎使用 ★ 25k 3 天前 MIT
复合学习捕获 53 · 谨慎使用 ★ 25k 3 天前 MIT
Azure 技能创建指南 ✓ Microsoft · 官方 48 · 谨慎使用 ★ 2.7k 3 个月前 MIT
cmux 核心控制技能 47 · 谨慎使用 ★ 28k 1 天前 NOASSERTION
Supermemory 保存技能 34 · 不推荐 ★ 2.8k 4 天前 —

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
52/ 100 五分制 2.6 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全12 / 25 · 2.4/5

该技能包含一个内联的 bash 脚本,用于调用 contexts.mjs 脚本,该脚本会解释代理工具的使用并可能覆盖系统提示中的限制。它还指示代理以非交互模式静默执行文件写入、删除、重命名和合并,而无需用户确认。虽然错误场景以优雅降级处理,但缺少明确的用户确认步骤以及对内部脚本的信任不明,降低了信任评分。评估为12分,因主要风险可见但权限控制、确认流程和安全隔离不完整。

2可靠稳定9 / 20 · 2.3/5

该技能通过上下文脚本和验证脚本实现了结构化的工作流程,包含错误处理与降级机制(如脚本缺失或执行失败时继续)。但静态审查无法验证脚本在真实环境中的可靠性,且未发现完整的测试套件。可靠性评为9分,因关键路径有防护但缺乏实际验证,失败反馈机制尚可但覆盖不足。

3适用触发10 / 15 · 3.3/5

技能定义了清晰的适用场景、范围提示和非交互模式,提供了范围缩窄策略和明确的边界(如不处理未指定范围)。但对触发条件的描述可能过于具体,可能导致误触发或漏触发。环境适配性方面未明确提及对China网络可达性的依赖。评为10分,因场景明确但边界证据有限。

4规范维护11 / 15 · 3.7/5

该技能结构良好,提供了详细的参考文件和脚本,包括schema、yaml验证和claims验证。包含MIT许可证、清晰的维护路径和版本控制。但缺少changelog和版本号信息,部分依赖外部未验证的脚本,降低评分。评为11分,因文档分层清晰、示例充分,但版本治理和历史记录不完整。

5有效结果6 / 15 · 2.0/5

技能目标明确,旨在审计和刷新学习文档,并提供了详细的操作流程。但静态审查无法验证其实际效果,且输出格式(报告)需要用户解读,直接可用性有限。评为6分,因核心任务描述清晰但实际输出未经验证,边际价值证据不足。

6证据核验4 / 10 · 2.0/5

静态审查无法执行脚本或验证其真实性。虽然提供了验证脚本(如validate-frontmatter.py和validate-doc-claims.py),但缺少独立的测试套件或第三方的执行证据。评为4分,因可审计的原始材料有限,且无法独立验证。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年8月7日 审查版本 0a2957852e20 评估证据[1][2][3][4][5][6][7][8][9][10]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

该技能需要网络连接吗?
不需要。技能完全本地运行,仅访问文件系统和代码库。
需要哪些系统权限?
需要读写项目文件的权限,并可能需要执行 shell 命令(如 git、node)。
是否支持非交互模式?
支持,通过添加 mode:non-interactive 参数启用,技能将自动应用安全操作并将不确定项标记为过时。
如何处理无法验证的文档?
将保留内容,并在报告中注明验证差距,不会因无法验证而删除。

同仓库的其他 Skills

均来自 EveryInc/compound-engineering-plugin

相关 Skills