# @adlc/skill-rot 中文文档

规范地址：https://npmcn.com/package/%40adlc/skill-rot/

版本：1\.12\.0
npm 元数据更新时间：2026-10-10T03:04:27.110Z
中文译文更新时间：2026-11-06T00:20:56.724Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40adlc/skill-rot
原文对照：https://npmcn.com/package/%40adlc/skill-rot/?lang=original
项目主页：https://github.com/voodootikigod/adlc/tree/main/packages/skill-rot#readme
源码仓库：https://github.com/voodootikigod/adlc

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：28.8 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：1 个
- 首次发布：2026-06-13T21:12:55.939Z
- 最新版本发布：2026-10-10T03:04:26.777Z
- 近 30 天下载量：8225（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

验证技能内部可核实的主张——技能腐烂的缓存无效(P7/C10).

## 安装

```sh
npm install @adlc/skill-rot
```

也可以使用：`pnpm add @adlc/skill-rot`、`yarn add @adlc/skill-rot`、`bun add @adlc/skill-rot`

## README

# 技能旋转

**ADLC 阶段: P7 – 缓存无效( C10)**

技能是缓存. `skill-rot` 证明每项索赔中可核实的索赔 `SKILL.md` 文件仍然按当前寄存器键。 施托尔技能 拥有缓存专家权威的错误信息——比没有技能 都说吧 每周在CI里运行 保持技能的诚实.

## 使用量

```
skill-rot [path ...] [--write] [--json]
```

默认搜索根( 仅在存在时搜索) :

-   `.claude/skills`
-   `.agents/skills`
-   `skills`

通过一个或多个明确的路径参数来覆盖默认值.

相通技能目录和相通 `SKILL.md` 文件被跟踪,循环检测可防止在递归相联图上无限地重复。 已命名目录 `node_modules` 或者说 `.git` 跳过搜索根以下。 默认发现时会跳过解为一的并联链接, 当您通过明确路径时是操作错误( exit 1); 命名目标路径以检查它 .

## 旗帜

| 旗帜 | 说明 |
| --- | --- |
| `--write` | 何时 **全部** 技能要求是好的,提高 `last-verified: <YYYY-MM-DD>` 进入技能的前题( 如果缺席则创建) 。 拥有呆滞索赔或零索赔要求的技能从不盖章. |
| `--json` | 为管弦乐手提供机器可读输出. 打印 JSON 对象 `skills[]` 财务报告和审定财务报表 `summary`。 。 。 . |

## 什么被验证

每笔 `SKILL.md` 找到递归文件( 抽取) `node_modules` 财务报告和审定财务报表 `.git`:

1.  **图标** ——回扣-闭塞的跨度和栅栏式码块线 第一个符号看起来像一个命令名称。 通过:
    
    -   `./node_modules/.bin/<cmd>` 存在,或
    -   `sh -c 'command -v <cmd>'`
    
    占位符符号跳过 : `<ANGLE_BRACKETS>` 财务报告和审定财务报表 `UPPERCASE_VARS` (3+字符,所有盖/下分数/位数)从不算作 stale.
    
2.  **文件路径** - 包含 `/` 和一个文件扩展名(例如:. `src/index.mjs`) (中文(简体) ). 检查通过 `existsSync` 从还原根和从 技能本身的目录.
    
3.  **脚本引用** —— 说 `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` | 门故障——至少有一种技能有呆滞的说法 |

## 实例

```bash
# 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`) (中文(简体) ).

## 常见问题

### @adlc/skill-rot 是什么？

验证技能内部可核实的主张——技能腐烂的缓存无效\(P7/C10\)\.

### 如何安装 @adlc/skill-rot？

在项目目录运行 npm install @adlc/skill-rot，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 skill-rot，可以用 npx skill-rot 直接运行。

### @adlc/skill-rot 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adlc\_\_skill-rot 是否存在。

### @adlc/skill-rot 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @adlc/skill-rot 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adlc/skill-rot 可以商用吗？

@adlc/skill-rot 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @adlc/skill-rot 的下载量有多少？

根据 npm 官方下载统计，@adlc/skill-rot 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,225 次，日均约 274 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @adlc/skill-rot 还在维护吗？

最新版本 1\.12\.0 发布于 2026/10/10（27 天前）；至今共发布 18 个版本，其中过去 12 个月发布了 18 个；首次发布于 2026/06/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。