alchaincyf/huashu-skills / huashu-skill-updater
huashu-skill-updater
Verified检查并更新花叔系 skills。用户说「检查skill更新」「更新花叔的skill」「skill是不是最新的」时触发。按各仓库的版本标签判断有没有新版本,只提示,是否更新由用户决定。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.9 KB |
| scripts/check_updates.py | script | 6.3 KB |
SKILL.md
View on GitHub---
name: huashu-skill-updater
description: 检查并更新花叔系 skills。用户说「检查skill更新」「更新花叔的skill」「skill是不是最新的」时触发。按各仓库的版本标签判断有没有新版本,只提示,是否更新由用户决定。
---
# huashu-skill-updater — 花叔系 Skill 更新检查
花叔的 skill 都在持续迭代(修 bug、补方法论、加能力)。这个 skill 负责让用户装过的版本不掉队。
## 全量检查(首选)
```bash
python3 ~/.claude/skills/huashu-skill-updater/scripts/check_updates.py
```
脚本会扫描 skills 目录下所有花叔系 skill(识别标准:目录带 `.git` 且 origin 指向 alchaincyf,或存在 `.huashu-skill-meta.json`),输出「已最新 / 有更新 / 无法判断」三态报告。有更新时 exit code 为 1,方便接 cron。
怎么算「有新版本」:git 安装的 skill,比较 SKILL.md 开头 `metadata.version` 和远程仓库最大的 `vX.Y.Z` 标签。作者只在实质更新(新能力、行为变化、修 bug)时打标签,改错字、改 README 不打,所以不会因为小改动反复提醒。检查只读取远程标签,不下载文件、不上传数据。复制安装的 skill 没有版本号,仍按来源仓库的 commit 比较。
加 `--mark-checked` 会在联网成功后刷新各 skill 的检查日期(联网失败不刷新):
```bash
python3 ~/.claude/skills/huashu-skill-updater/scripts/check_updates.py --mark-checked
```
## 执行更新
- git 安装的 skill(独立仓库):`git -C ~/.claude/skills/<名字> pull --ff-only`
- 复制安装的 skill(huashu-skills 内置,或 dukou):重新 clone 来源仓库到临时目录,把对应子目录覆盖复制回去,然后更新 `.huashu-skill-meta.json` 里的 `commit` 和 `installed_at`:
```bash
git clone --depth 1 https://github.com/alchaincyf/huashu-skills.git /tmp/huashu-skills-update
rm -rf ~/.claude/skills/<名字> && cp -r /tmp/huashu-skills-update/<名字> ~/.claude/skills/
```
更新前如果用户对该 skill 做过本地改动(`git status` 有未提交修改,或复制安装的目录 mtime 晚于 installed_at),先提醒用户会被覆盖,让用户确认。
## 元数据约定
复制安装的 skill 必须在其目录里带一个 `.huashu-skill-meta.json`(安装它的 agent 负责写入):
```json
{
"name": "huashu-slides",
"repo": "alchaincyf/huashu-skills",
"subdir": "huashu-slides",
"commit": "安装时来源仓库的 HEAD sha(git rev-parse HEAD)",
"installed_at": "YYYY-MM-DD",
"last_checked": "YYYY-MM-DD"
}
```
git clone 安装的 skill 不需要这个文件,`.git` 本身就是元数据。另外每个独立仓库 skill 的 SKILL.md 末尾自带「版本检查」段:agent 使用该 skill 时读目录里的 `.last-update-check`(一行日期加结果,如 `2026-10-13 ok`),上次成功不足 30 天、上次失败不足 7 天就跳过,到期才读一次远程版本标签;用户把内容改成 `off` 就永久不检查。`check_updates.py --mark-checked` 联网成功后会同时刷新这个文件,避免刚全量检查完又被单个 skill 重复提醒。
## 每月定期检查
推荐用户任选其一:
- 每月对 agent 说一句「检查花叔skill更新」
- 挂 cron,每月 1 号早上跑一次:
```
0 9 1 * * python3 ~/.claude/skills/huashu-skill-updater/scripts/check_updates.py --mark-checked
```
## 给 agent 的行为规则
1. 触发本 skill 后先跑 `check_updates.py`,把报告翻译成人话给用户:哪些最新、哪些落后几个 commit、更新命令是什么。
2. 不要不问就更新——列出有更新的 skill,让用户决定更新哪些(用户明确说「全部更新」除外)。
3. 单个 skill 的到期检查由它自己的「版本检查」段负责,本 skill 不重复提醒。
4. skills 目录不在 `~/.claude/skills/` 时(项目级安装、其他 agent),用 `--skills-dir` 指定。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |