skills-link
管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
- License 许可
- MIT
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- skills-link
- description
- 管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
03 SKILL.md 正文
skills-link:安装策略与 link.sh 用法
/var/minis/shared/repos/skills(muscaestar/skills)按来源分三层:
| 层 | 内容 | 优先级 |
|---|---|---|
matt-mod/ |
手工改编的 matt skill,改动用 〖...〗 框出 |
最高 |
matt/ |
mattpocock/skills 中文镜像(自动同步,勿手改) | 中 |
own/ |
原创 skill | 低 |
同名冲突时高层胜出。链接的 source 解析与**装到哪(全局/项目)**是两件事,互不影响:项目里 add tdd,即使 tdd 已全局装着,项目内也优先指向项目链接——如果 tdd 有 matt-mod 版,项目链接就直接指到 mod。
安装策略:两个范围
设计动机(writing-for-agents 的 context load 原则):skill 列表是每个会话都要付的成本。被依赖的词汇层必须无处不在(否则上层流程调到它就断),其余只在干这类活的项目里需要。
全局(~/.claude/skills + ~/.agents/skills,19 个,见 global.txt):
- 原语层(被其他 skill 依赖):grilling、domain-modeling、codebase-design
- 主链路内嵌节点:tdd、code-review、diagnosing-bugs、prototype、pr(model-invoked,写 PR 时自动拿起)
- 救火工具(触发条件窄,全局装着无害):research、wizard
- 写作参考:writing-for-agents
- 主链路四站(人工触发):grill-with-docs、to-spec、to-tickets、implement
- 通用会话工具(人工触发):grill-me、handoff、wait-what
项目级(./.claude/skills + ./.agents/skills,从项目根目录 add):其余全部——写作族(writing-fragments/-shape/-beats)、工程专项(triage、wayfinder、improve-codebase-architecture、claude-handoff、implement-spec、retro、chief-of-staff)、工作区绑定(teach、loop-me、to-questionnaire)、setup 工具(setup-pre-commit、setup-ts-deep-modules、migrate-to-shoehorn、scaffold-exercises、git-guardrails-claude-code)。
历史注记:resolving-merge-conflicts 曾在全局集里,上游 matt 已删除该 skill("No longer needed"),本仓库跟随移除;它的纪律(逐 hunk 按意图解决)可由通用能力覆盖。
注意 matt 仓库把人工触发 skill 标了 disable-model-invocation: true(agent 不会自己跳进去),所以全局装它们几乎零噪音,只在你点名时生效。
link.sh 命令矩阵
./link.sh # 装全局集(global.txt 里的 18 个)
./link.sh add triage # 往当前项目装(在 ./.claude/skills 建 symlink)
./link.sh add triage wayfinder # 一次装多个
./link.sh add --all # 当前项目装全部非全局 skill
./link.sh add teach --global # 顺便把 teach 也补成全局(一次性,不写进 global.txt)
./link.sh remove triage # 从当前项目摘掉
./link.sh list # 全局集/全局实际链接/本项目链接/仓库可装清单
行为细节:
- 重跑
./link.sh会把不再在 global.txt 里的旧全局链接清掉(只清指回本仓库的 symlink,不动别的东西)。 add/remove只对指回本仓库的 symlink操作;项目里如果有个同名的真实目录,remove 会跳过并提示。add --global是一次性操作:想让某个 skill 永久全局,编辑global.txt再重跑./link.sh才是正路。
场景 cookbook
新项目开工(工程类,用 issue 跟踪器):
cd ~/code/myproject && /var/minis/shared/repos/skills/link.sh add triage
主链路已在全局,只补 triage(外部 issue 入口)。超大工程再加 wayfinder。
写博客的工作区:
cd <vault 目录> && /var/minis/shared/repos/skills/link.sh add writing-fragments writing-shape writing-beats
想学东西的专题工作区:add teach(teach 定义就绑工作区:MISSION.md/课程/学习记录都落在里面)。
改完 matt-mod 后:不用重跑——symlink 直指仓库,git pull 或改文件立即生效。只有新增/删除/改名 skill 或改 global.txt 才需要重跑。
sync 上游后:./scripts/sync-from-tracking.sh 会自动跑 ./link.sh(全局集),项目级链接不受影响。
调整安装策略本身
- 想让某 skill 永久全局/移出全局:编辑仓库根的
global.txt(一行一个名字),重跑./link.sh。 - 分错了类想全局讨论:分类依据是"被依赖层必须全局 + 人工触发层全局无害 + setup/工作区绑定的留项目级",改动前先想它属于哪类。
04 同仓库更多 Skills
writing-shape
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
writing-fragments
写作之 explore:开采原始碎片,还没有结构。
writing-for-agents
为 agents 编写文档。在创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
writing-beats
写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
wizard
生成一个交互式 bash 向导,引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘,或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。
wayfinder
把一大块工作(超过一个 agent 会话能装下的)规划为 issue 跟踪器上一张由决策 ticket 构成的共享地图,然后一次解决一个,直到通往目的地的路清晰可见。