用途
skill-inventory 是 armory 技能库中名为 skill-inventory 的工具的安装入口。该工具本身是一个离线 Python 实用程序,以 armory 工具包形式发布,Skills CLI 与 Claude Code 插件市场不会直接安装它;本技能负责把该工具提供给当前智能体,并交由工具自带的文档进行后续操作。
适用场景包括:审计已安装技能的描述、观察到的读取记录或未被使用的受管技能;在工具尚未安装或不知道其位置时完成安装;设置并运行技能清单工具。触发语句如"audit my skill inventory""find unused skills""which skills were read?""how much do skill descriptions cost?""set up skill-inventory"等。诊断当前上下文窗口占用情况应改用 usage-audit,搜索或安装 armory 包应改用 skill-library,按质量评分标准评估包应改用 package-evaluator。
主要能力
- 定位已有安装:运行技能目录下的 scripts/ensure-utility.sh,检查 ~/.claude/utilities/skill-inventory 与 ${XDG_DATA_HOME:-~/.local/share}/armory/utilities/skill-inventory。退出码 0 会输出 UTILITY_ROOT= 与 VERSION=,退出码 3 表示未安装。
- 安装:在获得所有者批准后运行 scripts/ensure-utility.sh --install,或使用 --install DEST 指定其他位置(须位于所有 Git 仓库之外;相对路径按当前目录解析)。安装过程下载 armory 滚动最新发布版,并对归档做 SHA-256 校验。
- 引导使用:导出打印出的 UTILITY_ROOT,首次用 uv run --no-project --script "$UTILITY_ROOT/scripts/skill_inventory.py" --help 初始化固定依赖,然后阅读工具的 UTILITY.md 及其 references 目录下的 operator-guide.md 并按其执行。
使用方式
示例脚本:
SKILL_DIR="$HOME/.claude/skills/skill-inventory" # where this skill was installed
"$SKILL_DIR/scripts/ensure-utility.sh" # exit 3: not installed
# Owner approves the download.
"$SKILL_DIR/scripts/ensure-utility.sh" --install
# UTILITY_ROOT=$HOME/.local/share/armory/utilities/skill-inventory (expanded)
# VERSION=1.0.0
export UTILITY_ROOT="$HOME/.local/share/armory/utilities/skill-inventory"
uv run --no-project --script "$UTILITY_ROOT/scripts/skill_inventory.py" --help
# Next: follow $UTILITY_ROOT/references/operator-guide.md for the measure run.
安装脚本的行为:从 armory 最新发布版下载 checksums.txt,找到唯一的 skill-inventory-X.Y.Z.utility 条目;下载对应归档并比对 SHA-256;解压到目标旁的隐藏临时目录,检查包含 UTILITY.md 与 scripts/skill_inventory.py;仅当目标位置不存在任何内容时重命名为目标目录,因此中断安装不会留下部分副本。校验和仅防止下载损坏或截断,来自同一发布版,不证明发布者身份。脚本不会升级或覆盖已有安装;升级需由所有者比较已安装 VERSION 与发布版,移开旧目录后重新安装。
输出与限制
应报告工具根目录与版本、是否执行了安装,然后按工具指南呈现其自身输出。工具的标准输出为匿名聚合 JSON;退出码 2 表示结果不完整或被拒绝,而非空结果。故障排查:退出码 3 表示未安装,需征求所有者同意后加 --install 重跑;下载失败多为网络或 GitHub 问题,未安装任何内容,可稍后重试;校验和不匹配应停止,不要盲目重试或绕过检查,应报告所有者;目标位置存在其他内容时不得删除,应与所有者检查;缺少 uv 或 Python 3.12 时需安装 uv,uv run 会在首次使用时提供固定版本的 PyYAML;工具退出码 2 时应查阅工具 measurement.md 的诊断码表,不得修改日志或放宽检查。
起始步骤为指南所述的只读 measure --aggregate-only 运行;recommend 仅写入私有建议;archive 与 restore --apply 会移动文件,需所有者单独明确授权。