huashu-skill-updater

1# huashu-skill-updater — 花叔系 Skill 更新检查
2 
3花叔的 skill 都在持续迭代（修 bug、补方法论、加能力）。这个 skill 负责让用户装过的版本不掉队。
4 
5## 全量检查（首选）
6 
7```bash
8python3 ~/.claude/skills/huashu-skill-updater/scripts/check_updates.py
9```
10 
11脚本会扫描 skills 目录下所有花叔系 skill（识别标准：目录带 `.git` 且 origin 指向 alchaincyf，或存在 `.huashu-skill-meta.json`），输出「已最新 / 有更新 / 无法判断」三态报告。有更新时 exit code 为 1，方便接 cron。
12 
13怎么算「有新版本」：git 安装的 skill，比较 SKILL.md 开头 `metadata.version` 和远程仓库最大的 `vX.Y.Z` 标签。作者只在实质更新（新能力、行为变化、修 bug）时打标签，改错字、改 README 不打，所以不会因为小改动反复提醒。检查只读取远程标签，不下载文件、不上传数据。复制安装的 skill 没有版本号，仍按来源仓库的 commit 比较。
14 
15加 `--mark-checked` 会在联网成功后刷新各 skill 的检查日期（联网失败不刷新）：
16 
17```bash
18python3 ~/.claude/skills/huashu-skill-updater/scripts/check_updates.py --mark-checked
19```
20 
21## 执行更新
22 
23- git 安装的 skill（独立仓库）：`git -C ~/.claude/skills/<名字> pull --ff-only`
24- 复制安装的 skill（huashu-skills 内置，或 dukou）：重新 clone 来源仓库到临时目录，把对应子目录覆盖复制回去，然后更新 `.huashu-skill-meta.json` 里的 `commit` 和 `installed_at`：
25 
26```bash
27git clone --depth 1 https://github.com/alchaincyf/huashu-skills.git /tmp/huashu-skills-update
28rm -rf ~/.claude/skills/<名字> && cp -r /tmp/huashu-skills-update/<名字> ~/.claude/skills/
29```
30 
31更新前如果用户对该 skill 做过本地改动（`git status` 有未提交修改，或复制安装的目录 mtime 晚于 installed_at），先提醒用户会被覆盖，让用户确认。
32 
33## 元数据约定
34 
35复制安装的 skill 必须在其目录里带一个 `.huashu-skill-meta.json`（安装它的 agent 负责写入）：
36 
37```json
38{
39  "name": "huashu-slides",
40  "repo": "alchaincyf/huashu-skills",
41  "subdir": "huashu-slides",
42  "commit": "安装时来源仓库的 HEAD sha（git rev-parse HEAD）",
43  "installed_at": "YYYY-MM-DD",
44  "last_checked": "YYYY-MM-DD"
45}
46…