AGENT SKILL

skills-link

管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。

License 许可
MIT
所属仓库
muscaestar/skills
最近更新
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