← 中文 AI Skills 库INSTALL NOTE · skills CLI 1.5.22
CODEX · CLAUDE CODE · CURSOR

装上 Skill，
然后证明它会用。

这不是“复制一条命令就结束”的教程。我们把列出、安装、文件位置、自动触发和任务完成分开核对。

01 · DISCOVERCLI 能列出来
02 · INSTALL文件确实落盘
03 · ACTIVATEAI 主动读取
04 · DELIVER真实任务完成

安装前，先审计第三方 Skill

先读 SKILL.md 和 scripts/。也可以运行本站的只读本地审计器，定位脚本、联网、凭据词、文件写删和高风险命令；它不执行目标，规则零命中也不等于安全。

打开安装前只读审计指南 →

四步安装与核对

以下命令使用本站仓库作例子。一次只处理当前需要的 Skill，保留 CLI 版本与本机观察结果。

STEP 01

先列出，不要盲装全部

npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --list

确认目标名称，也能及早发现仓库结构不被 CLI 识别。

STEP 02

一次只装一个

npx skills add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill chinese-typography -g

Skill 越多，客户端用于发现描述的上下文预算越紧。本次 Codex 实测出现过 description 被缩短的警告。

STEP 03

核对实际文件

ls -la ~/.agents/skills/chinese-typography ls -la ~/.claude/skills/chinese-typography

本机实测文件位于 ~/.agents/skills/；Claude 目录可见符号链接。版本变化后请以本机结果为准。

STEP 04

测试自动触发

请审查这个中文网页的字体、行高、断行、标点和中英混排问题。

不要在任务里说出 Skill 名称。观察 AI 是否主动读取正确说明，再检查输出是否真正完成任务。

跨系统留证：只记录安装，不猜客户端行为

Windows、WSL 和 Linux 仍缺本仓库真实复测。若你有其中任一环境，可先运行以下最小步骤；把用户名改成 <user-home>，不需要运行 Skill 附带脚本或 Demo。

WINDOWS · PowerShell

列出、安装、检查类型

npx --yes skills@1.5.22 add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --list npx --yes skills@1.5.22 add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill chinese-typography Get-Item "$HOME/.agents/skills/chinese-typography" | Format-List FullName,Attributes,LinkType,Target

如存在客户端入口，也分别用 Get-Item 记录；不要把“能看到文件”写成“自动触发”。

WSL / LINUX · shell

列出、安装、检查类型

npx --yes skills@1.5.22 add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --list npx --yes skills@1.5.22 add https://github.com/sanhuang520-ship-it/awesome-chinese-ai-tools --skill chinese-typography ls -ld "$HOME/.agents/skills/chinese-typography" "$HOME/.claude/skills/chinese-typography"

第二个路径不存在也很有价值：如实记录“未找到”，不要为了通过步骤创建链接。

提交前请脱敏：保留系统、终端、Node、skills CLI 版本、命令、路径类型和边界；删除用户名、Token、邮箱和私人路径。可用 安装环境表单，或复制 机器可读示例 后运行 python3 scripts/check_install_environment_report.py <report>.json。

哪些结论已经实测

格式相似不等于跨客户端兼容。没有运行过，就写“待测”。

客户端当前证据不能外推的部分
Codex13/13 自动触发过一次
10 项当次任务完成；1 项等待必要输入；2 项缩小复测通过		不代表所有提示词、版本或大型任务都通过
Claude Code待真实客户端测试只看到符号链接不能证明自动触发与完成
Cursor待真实客户端测试安装入口、发现和触发需要分别验证
常见误判：命令显示成功，不代表 Skill 被客户端读到；客户端读到了，也不代表任务能在输出预算内完成。

安装后不会自动跟随仓库更新

2026-08-13 隔离复测中，固定版本 skills@1.5.22 安装的 13 项与当前仓库逐字一致；但 8 月 8 日留下的全局副本已经是 0/13 一致，因为仓库后来补充了元数据并修订内容。

npx --yes skills@1.5.22 update -p -y

项目级受控复测中，13 个历史夹具文件夹更新后 13/13 与当前仓库完整一致，全局文件哈希未变。这个命令只适用于有 skills-lock.json 的项目级安装；本轮没有验证全局 update -g。

先确认版本与来源：未固定版本的 npx skills --version 可能命中本机缓存。复现问题时记录实际版本，必要时固定已知版本；确认上游可信后，再使用 CLI 的更新或重新安装流程。

按锁文件、版本、范围和完整文件夹逐步核对更新 →

没有触发时，按这个顺序查

① CLI 的 --list 是否能看到目标名称
② 安装目标目录下的 .agents/skills/<name>/SKILL.md 是否存在（默认是当前目录；用了 -g 则在 ~/ 下）
③ 客户端入口是否能看到同一个 Skill
④ 重启客户端后，用不点名名称的自然任务复测
⑤ 减少同时安装的 Skill，避免描述预算拥挤
⑥ 记录客户端版本、任务原文和错误，不只写“不能用”

需要逐层定位？ 查看 Codex Skill 安装后不自动触发的 5 步诊断树，区分发现失败、安装失败、未触发、未完成和环境阻断。

复现一次，提交成功或失败。

Claude Code 和 Cursor 的真实结果尤其需要。

提交实测 →