关于 sync-skills
sync-skills 是面向 hal-9000 项目的维护技能,用于发现技能并同步列表、权限和链接,最后运行项目同步命令。
主要功能
- 01发现技能及其元数据
- 02更新 README 技能列表
- 03同步可由用户调用的技能权限
- 04同步技能目录链接
- 05运行 `./bin/hal sync`
适用场景
- 01技能变更后刷新 README
- 02根据 frontmatter 对齐允许的技能
- 03更新新增或删除技能的链接
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ vinta/ hal-9000 --skill sync-skills安装后在 Claude Code 中输入/sync-skills确认已加载。
详细介绍
说明
重要:仅在 /usr/local/hal-9000 中使用此技能。否则,请中止。
-
发现技能
- 仅在
/usr/local/hal-9000中对skills/*/SKILL.md执行 Glob - 从每个 YAML frontmatter 中提取
name - 将每个
description改写为一句简短描述(最多约 10 个词),说明其功能——不要使用“使用时机”触发语,也不要照抄 frontmatter
- 仅在
-
更新
README.md(### Agent Skills部分)- 格式:
- [name](skills/name): description - 使用步骤 1 中改写后的描述
- 添加新技能,删除已移除的技能,更新描述有变化的技能
- 保留现有条目的顺序;将新条目追加到末尾
- 格式:
-
更新
dotfiles/.claude/settings.json(permissions.allow数组)- 同步
Skill(...)条目,使其与发现的可由用户调用的技能一致 - 仅包含 frontmatter 中
user-invocable: true的技能 - 格式:
"Skill(<name>)" - 添加新技能,删除对应技能已不存在的条目
- 保留现有条目的顺序;将新条目追加到末尾
- 将条目保留在相同的位置区块中(位于其他工具条目之间)
- 同步
-
更新
dotfiles/hal_dotfiles.json(links数组)- 格式:
{"dest": "{{HOME}}/.claude/skills/<name>/", "src": "{{REPO_ROOT}}/skills/<name>/"} - 添加新技能目录;删除
"src"与{{REPO_ROOT}}/skills/*匹配但没有对应技能的条目 - 保留现有条目的顺序;将新条目追加到末尾
- 保持非技能条目和
copies数组不变
- 格式:
-
运行
./bin/hal sync,然后报告变更内容。
评论
支持 Markdown