# 本站内容库的可选命令

仅在用户当前工作区已经采用本站技能内容库时使用。普通技能文件夹无需以下工具。

约定：content/skills/catalog.json 登记标识、版本、状态、依赖、验证范围及文件哈希；content/skills/published 保存整理后的正本。原始私有稿留在本机，不提交或部署。scripts/skills.cjs 需要该工作区锁定的 Node 依赖。

```bash
node scripts/skills.cjs list
node scripts/skills.cjs check
node scripts/skills.cjs refresh <skill-id>
node scripts/skills.cjs install <skill-id> --target <技能根目录>
```

refresh 只重建文件哈希和模式，不改变版本、状态或复核日期。check 默认检查随仓库交付的版本；--include-drafts 用于本机原稿全量检查，不执行技能脚本。

install 默认只读报告差异，显式 --apply 才替换副本；旧版保存在目标根目录的 .skill-backups，失败恢复旧版。本站管理员应把旧版备份转存到技能加载目录外。草稿和归档不能安装；公开或已复核的自用包可以安装。

先增加变化内容的版本号，再刷新清单和执行相应验证。公開范围与安装范围分别按当前用户要求决定。