open-skill-sunset Skill 技能

技能简介

Skill Sunset 是一款本地化、只读的 Agent 技能退休审计工具，专门用于定期检查 AGENTS.md、CLAUDE.md 和通用 SKILL.md 指令文件的健康状况。随着项目演进，这类指令文件往往只增不减，过时规则会挤占宝贵的上下文空间，同时增加模型的理解负担。该工具在不删除任何内容的前提下，帮你识别哪些规则可能已经失效、重复或需要降级。

核心能力

• 引用完整性检查：自动发现断裂的本地引用、过期的绝对路径、格式错误的 Skill frontmatter
• 体积分析：标记出体积过大且每次任务都会加载的文件，帮助你判断是否应该降级或拆分
• 重复检测：识别同名 Skills，验证完整包后再建议可回收的退休方案
• 保守评估原则：将模型时代补偿规则（如"新模型已内置该能力"）标记为 TEST 而非直接删除，避免误删重要规则
• 敏感信息扫描：检测可能的明文凭证，避免安全风险
• 多格式报告输出：生成双语 HTML、Markdown、JSON、Codex/Claude 交接提示词、实验模板和回滚清单

安装配置

前提条件

• Node.js 20 / 22 / 24
• 支持的系统：Ubuntu、macOS、Windows（均已在 GitHub Actions 中验证）

安装步骤

方式一（推荐）：直接运行

npx skill-sunset@latest audit

无需全局安装，无需修改源码，无 AI API 调用，无模型配额消耗。

方式二：Codex 环境审计

npx skill-sunset@latest audit --codex

方式三：自动打开 HTML 报告

npx skill-sunset@latest audit --codex --open

使用步骤

1. 确定审计范围：默认扫描 ~/.codex 和 ~/.claude 目录下的指令文件
2. 运行审计命令：根据目标选择上述三种命令之一
3. 阅读报告：工具会输出结构化报告，标注每条规则的健康状态（UPDATE / DEMOTE / TEST / RETIRE 等）
4. 人工复核：所有标记为 TEST 的规则都需要你主动评估，不能仅凭工具结论直接删除
5. 应用更改：根据报告建议手动更新、降级或重组指令文件

适用场景

• 日常维护：每隔一段时间对项目指令文件进行例行审计，保持知识库精简高效
• 项目交接：团队成员变更时，快速梳理指令文件结构和潜在问题
• 新人上手：新加入的开发者通过审计报告快速理解项目规范和历史成因
• 多 Agent 环境：同时使用 Codex、Claude Code 等多个 AI 编程工具时，统一管理指令文件

适用人群

• 使用 Claude Code、Codex 等 AI 编程工具的开发团队
• 维护大型 AGENTS.md / CLAUDE.md 文件的个人开发者
• 需要规范化管理多 Agent 协作规范的技术负责人
• 关注 AI 工具效率优化和知识管理的工程师

工作原理

Skill Sunset 在本地运行，执行确定性检查和保守假设分析：

1. 扫描目标目录下的指令文件，解析 frontmatter 和文件结构
2. 比对规则名称、引用路径和文件大小，识别异常项
3. 将不确定的结论标记为 TEST，保留人工复核空间
4. 生成多格式报告，默认排除安全规则、授权门禁和项目不变量
5. 不修改任何源文件，所有操作均为只读

官方链接

• GitHub 仓库：https://github.com/ooocooc/open-skill-sunset
• npm 包：https://www.npmjs.com/package/skill-sunset
• 案例文档：https://github.com/ooocooc/open-skill-sunset/blob/main/docs/cases.md