关于 skill-prune
skill-prune 是用于维护 Agent 技能内容的技能,可识别孤立、过时或重复的材料。它依据明确的信号和安全规则评估候选项,并要求先批准删除计划,不会自动删除。
主要功能
- 01四项内容清理标准
- 02受保护文件的安全检查
- 03附理由的删除计划
- 04清理后的链接与重复检查
适用场景
- 01定期维护技能内容
- 02检查 Linter 报告的孤立项
- 03精简超出限制的技能文件
- 04移除已退役挑战的相关内容
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ transilienceai/ communitytools --skill skill-prune安装后在 Claude Code 中输入/skill-prune确认已加载。
详细介绍
Skill Prune
与 /skill-update 相反:删除内容而非添加内容。在季度维护期间、项目结束后,或 scripts/skill_linter.py 报告孤立项/重复项时运行。
何时调用
- 按季度执行。
scripts/skill_linter.py --check-orphans报告孤立的引用文件后。- SKILL.md 或引用文件超出上限,需要精简时。
- 完成专业化调整后,删除与已退役挑战相关的内容。
精简标准(四项信号——与 /skill-update 形式相同,但方向相反)
引用/场景/行满足以下任一条件,即为精简候选项:
- 孤立项——过去 60 天内,任何 SKILL.md 或其他引用文件都未链接到该项。
- 仅被失败的项目引用——出现在以
status=BLOCKED结束的运行的attack-chain.md中,从未出现在成功的链中。 - 与较新的内容矛盾——后续场景/模式已取代该项;旧条目不再反映当前技术。
- 与较新的内容重复——其他地方已更清晰地涵盖相同技术。
若删除内容不符合以上任何条件,则保留。
安全规则
- 绝不精简带有 `` 注解的文件。
- 绝不精简仍在进行的项目
OUTPUT_DIR/attack-chain.md中引用的内容。 - 绝不精简单一所有者规则的规范归属文件(brute-force、output-discipline、env-reader、skill-update)。
- 优先保留技术内容丰富的内容,而非操作经验。
流程
- 运行
scripts/skill_linter.py --check-orphans,找出孤立项。 - 对每个候选文件或内容块,评估四项信号。
- 制定删除计划——列出要删除的文件/行,并为每项提供一句理由。
- 仅在计划获批后执行删除(skill-prune 不会在调用期间自动删除内容)。
- 重新运行
scripts/skill_linter.py,确认更改未破坏其他链接,也未重新引入重复项。
输出
简洁的变更报告:
- 已移除。 文件或内容块 + 每项一句理由。
- 已保留(标记以便后续跟进)。 未满足四项信号中任何一项,但值得下季度重新审视的内容。
- 未精简。 若没有任何内容需要删除,请明确说明。
反模式
- 仅因内容较旧就精简——仅凭时间长短不是判断信号,相关性才是。
- 因父级 SKILL.md 臃肿而精简引用内容——应改为精简 SKILL.md。
- 删除单一所有者的规范归属文件(brute-force / output-discipline / env-reader)。
- 在可能仍会引用该内容的项目进行期间精简。
评论
支持 Markdown