skills-main 本机技能清单：38 个 Agent Skills 的用途与迁移办法

这篇文章记录本机 Downloads/skills-main 目录中一份 Agent Skills 快照，方便换电脑时知道自己用过哪些能力、哪些适合优先恢复。它不是上游仓库的镜像，也不包含任何 SKILL.md 正文；技能会持续更新，安装前要回到来源确认当前说明。

盘点范围与快照边界

盘点日期：2026-10-18。依据本机快照中的根 README、package.json、分类 README 和技能文件名统计，未逐个运行技能，也没有读取 Git 凭据或提交记录。

项目	本机快照观察
上游仓库	mattpocock/skills；package metadata 自报版本 `1.2.3`、MIT
技能文件	38 个 `SKILL.md`，分为 18 个 engineering、7 个 productivity、4 个 misc、9 个 in-progress
Deprecated	分类 README 表示当前为空；这不代表以后不会新增或删除技能
版本依据	没有记录这份本机副本的 Git commit；版本与数量只描述盘点时看到的本地状态

上游 README 把技能区分为需要用户显式调用的流程和模型可按任务匹配的能力。相似名字不一定重复：例如 grill-me 面向通用澄清，grilling 是可由模型主动选择的访谈能力，grill-with-docs 还会围绕项目术语和决策文档展开。

工程技能

名称	用途概览
`ask-matt`	根据当前问题帮忙选择合适的技能或工作流
`code-review`	从编码规范和需求符合度两个方向检查改动
`codebase-design`	以小接口、深模块和可测试边界组织设计讨论
`diagnosing-bugs`	对疑难缺陷建立反馈、缩小复现、验证假设并回归
`domain-modeling`	澄清领域术语、关系和边界，并沉淀共享模型
`grill-with-docs`	通过问题梳理需求，同时整理项目术语与决策文档
`implement`	按已确认的规格或票据实施，并在约定边界执行测试与审查
`improve-codebase-architecture`	找出可以改善模块边界和可维护性的候选点
`prototype`	用可丢弃原型快速回答交互或方案问题
`research`	围绕高可信资料调查问题并输出带来源的记录
`resolving-merge-conflicts`	根据双方意图逐块处理正在进行的合并或变基冲突
`setup-matt-pocock-skills`	为该技能集合配置 issue tracker、标签和文档目录
`tdd`	采用 red-green-refactor 建立小步测试反馈循环
`to-spec`	将讨论结果整理成可评审、可验收的规格
`to-tickets`	将计划拆成有依赖关系的可追踪工作票据
`triage`	按流程状态整理和分派待处理问题
`wayfinder`	把跨多次会话的大目标整理成持续推进的路线图
`wizard`	生成由人完成基础设施、凭据或控制台步骤的交互式向导

效率技能

名称	用途概览
`grill-me`	在方案定稿前连续澄清目标、约束和分支选择
`grilling`	将含糊问题拆成逐步回答的访谈过程
`handoff`	把当前工作压缩成下一位协作者可接手的上下文
`teach`	用多次练习逐步教授新概念，并保留学习进度
`to-questionnaire`	把需要他人决策的问题整理成可异步填写的问卷
`wait-what`	发现沟通没对齐时，换成更直白的解释重新确认
`writing-for-agents`	编写面向 AI Agent 的技能、项目指引和提示文档

杂项技能

名称	用途概览
`git-guardrails-claude-code`	为 Claude Code 配置危险 Git 操作的拦截钩子
`migrate-to-shoehorn`	将测试中的类型断言迁移到专用类型测试辅助工具
`scaffold-exercises`	创建包含题目、答案和讲解的练习目录结构
`setup-pre-commit`	配置提交前格式化、静态检查和测试流程

进行中的技能

上游把这一组标为 beta，并说明它们不随稳定插件一起发布，可能变化或移除。把它们作为实验候选，不要和稳定技能混为一谈；其中 retro 在本机分类说明中标为设计草稿。

名称	用途概览
`claude-handoff`	把 Claude Code 当前任务交接给新的后台会话
`implement-spec`	按规格和依赖图并行推进多张实现票据
`loop-me`	通过多轮自我澄清把想法变成可执行规格
`pr`	组织 PR 摘要、证据、明确不做的范围和风险判断
`retro`	回顾并提出 Agent 环境改进；当前快照注明是设计草稿
`setup-ts-deep-modules`	为 TypeScript 项目建立深模块边界和依赖检查
`writing-beats`	先设计文章的叙事节拍，再逐段完成内容
`writing-fragments`	通过访谈收集素材片段，积累成后续写作原料
`writing-shape`	将原始材料逐段整理成有结构的文章

按实际工作挑选

不建议把 38 个技能全部塞进每个项目。可以先从一个小组合试起：

日常修复：diagnosing-bugs、tdd、code-review。
阅读陌生项目：research、codebase-design、domain-modeling。
需求不清晰：grill-me 或 grill-with-docs，选一个适合当前问题的流程。
长任务交接：handoff；跨多轮的大目标再考虑 wayfinder。
自动化环境配置：wizard，但涉及凭据、生产控制台或基础设施时，人仍要逐项确认。
试验性流程：从 in-progress 单独挑选，在无敏感数据的测试仓库里评估。

技能名称只是入口，不代表它已适配你的仓库。先看触发条件、工具要求、是否会读取文件或调用外部服务，再决定是否安装。

安装、更新与换机恢复

本机快照的 README 给 Codex 和其他 Agent 的安装方式是 Skills CLI。Skills 官方文档当前也使用 npx skills add <owner>/<repo> 形式：

npx skills add mattpocock/skills

交互安装时选择目标 Agent 和需要的技能；想先试一个技能，可以按仓库 README 的单技能参数安装，例如 --skill=tdd。安装前确认 CLI 最终写入的是用户级目录还是当前项目目录，避免把个人技能和项目约定混在一起。上游还提供 Claude Code 托管插件路线；同一个 Agent 不要同时用插件和可编辑文件安装相同技能，否则会出现重复版本。

Skills CLI 官方文档说明安装统计会使用匿名遥测记录技能名、技能文件和时间戳，并提供 DISABLE_TELEMETRY=1 退出方式。不同 CLI 版本的选项可能变化，运行前先看当前命令参考。

换机时建议保存自己的清单，而不是备份或公开所有 Agent 指令：

记录仓库地址、盘点日期、上游版本或 commit、安装的技能名和目标 Agent。
如果编辑过技能，单独备份自己的修改，并记录它相对于上游的差异；不要把带有项目机密的上下文文件一并发布。
新机器安装前重新检查技能内容、依赖工具和权限，特别是能执行命令、修改 Git、联网或接触 issue tracker 的流程。
更新后查看差异再采用。可编辑文件的更新会改变本地 Agent 指令；不要把自动更新当成无影响的资源同步。

Skills CLI 的来源页也明确提醒：目录收录不等于安全背书，用户仍需审查技能内容。技能本质上是交给 Agent 的操作说明；遇到会读取密钥、上传项目文件、执行破坏性命令或扩大权限的内容，先拒绝或改写成最小权限版本。

来源与边界

本文只整理技能名称、分类和用途，不转载第三方 SKILL.md 的逐字正文，也没有执行本机快照里的安装脚本。上游可能重命名、移动或移除技能；这份清单应被当作有日期的个人换机参考，不是上游实时目录。