技能旋转
ADLC 阶段: P7 – 缓存无效( C10)
技能是缓存. skill-rot 证明每项索赔中可核实的索赔
SKILL.md 文件仍然按当前寄存器键。 施托尔技能
拥有缓存专家权威的错误信息——比没有技能
都说吧 每周在CI里运行 保持技能的诚实.
使用量
skill-rot [path ...] [--write] [--json]
默认搜索根( 仅在存在时搜索) :
.claude/skills.agents/skillsskills
通过一个或多个明确的路径参数来覆盖默认值.
相通技能目录和相通 SKILL.md 文件被跟踪,循环检测可防止在递归相联图上无限地重复。 已命名目录 node_modules 或者说 .git 跳过搜索根以下。 默认发现时会跳过解为一的并联链接, 当您通过明确路径时是操作错误( exit 1); 命名目标路径以检查它 .
旗帜
| 旗帜 | 说明 |
|---|---|
--write | 何时 全部 技能要求是好的,提高 last-verified: <YYYY-MM-DD> 进入技能的前题( 如果缺席则创建) 。 拥有呆滞索赔或零索赔要求的技能从不盖章. |
--json | 为管弦乐手提供机器可读输出. 打印 JSON 对象 skills[] 财务报告和审定财务报表 summary。 。 。 . |
什么被验证
每笔 SKILL.md 找到递归文件( 抽取) node_modules 财务报告和审定财务报表 .git:
-
图标 ——回扣-闭塞的跨度和栅栏式码块线 第一个符号看起来像一个命令名称。 通过:
./node_modules/.bin/<cmd>存在,或sh -c 'command -v <cmd>'
占位符符号跳过 :
<ANGLE_BRACKETS>财务报告和审定财务报表UPPERCASE_VARS(3+字符,所有盖/下分数/位数)从不算作 stale. -
文件路径 - 包含
/和一个文件扩展名(例如:.src/index.mjs) (中文(简体) ). 检查通过existsSync从还原根和从 技能本身的目录. -
脚本引用 —— 说
npm run X, (中文(简体) ),npx X, (中文(简体) ),pnpm X, (中文(简体) ),yarn X模式. 密钥X被检查scripts定义package.json。如果没有package.json,该请求是unverifiable。 。 。 .
索赔情况:
ok——可核查和通过stale——可核查但失效(计入门故障)unverifiable- 无法确定真相(URLs,没有)package.json,含糊不清)
无法核实的索赔从未被算作停滞。 零可核查申请技能报告为: [NO-CLAIMS] 永远不会被盖上 --write。一个其主张都无法核实的技能报告为 [UNVERIFIED],不计为干净的,也永远不会被盖章.
退出代码
| 代码 | 含义 |
|---|---|
0 | 出入口——没有技能可言 |
1 | 操作错误——无 SKILL.md 找到文件, 输入错误, 或无法完全检查的明确路径 |
2 | 门故障——至少有一种技能有呆滞的说法 |
实例
# Check defaults (.claude/skills, .agents/skills, skills)
skill-rot
# Check specific directories
skill-rot .claude/skills .agents/skills
# Stamp clean skills with today's date
skill-rot --write
# JSON output for CI integrations
skill-rot --json
与兄弟姐妹工具的关系
- 经验教训(C9) 培养技能;
skill-rot验证它们保持新鲜 - 审查-校准(C8) 校准审查质量;
skill-rot防止过时的引导损坏校正循环 - 显示门(C11) - 可以消费
skill-rot退出代码作为出处信号
核心差距
无。 该工具只使用节点18+内置和 @adlc/core cLI 课程
水电费(parseArgs, (中文(简体) ), pass, (中文(简体) ), gateFail, (中文(简体) ), opError, (中文(简体) ), printJson) (中文(简体) ).