让 AI 帮忙,先学会这样开口:27 个 Skills 卡通入门教程
打开一份 Skills 清单,满眼都是英文:grill-with-docs、to-spec、implement……还没开始用,就像先领了一张要背的单词表。
可以换个读法:把它们看成一群各有所长的小帮手。有的负责问清需求,有的动手做功能,有的专门找 Bug。你说清楚正在遇到什么问题,再请合适的那一位出场。
这篇教程由澜序 AI 整理,作者学长刚蝈。内容依据中文使用手册和卡通 PDF 整理,对应 Matt Pocock Skills 1.3.1 的 27 个正式技能。中文昵称是为了方便记忆,调用时仍使用英文名称。
Skill 是什么?
Skill 可以理解为给 AI 的“做事说明卡”。卡片里写着适用场景、处理步骤,以及怎样检查结果;有些还附带脚本或参考文件。
比如你说“帮我修一下”,AI 得先猜哪里坏了。指定 diagnosing-bugs 并补充现象后,它就有了一套排查方法:先找到能复现问题的办法,再定位原因、修复和验证。
这套 Skills 主要服务于软件项目,也有学习、调研、问卷和解释工具。没有编程基础也能读懂它们的分工;真正改代码时,仍需要项目文件、相应工具和明确的完成要求。
学长刚蝈的建议是:先学会 ask-matt 和与你眼前任务有关的技能。小改动往往只需要一个入口,把 27 个全部跑一遍只会增加步骤。
第一次用:安装、打开项目,再发一句话
还没安装,就把这段话交给 Codex
已经安装过这套技能,可以直接看下一步。尚未安装时,在 Codex 聊天框发送:
请帮我安装 https://github.com/mattpocock/skills 中正式发布的 Skills。先检查当前 Codex 支持的安装方式,以及有没有已经安装的同名技能。避免重复安装或覆盖我修改过的技能。完成后列出安装结果和调用方法。安装方式可能随版本变化,具体步骤以项目 README 的安装说明为准。作者区分了插件安装与可编辑文件安装;同一个工具选一种即可,避免重复。本次原手册使用的是文件安装,需要手动更新。
装好后,先确认 Codex 能识别技能。如果当前聊天找不到它,重新打开一个项目聊天,再明确说“请使用 ask-matt 技能”。安装成功与完成项目配置是两件事。
约定项目资料放在哪里
在 Codex 中打开你要处理的项目目录。第一次在这个项目里使用这套工程流程时,可以发送:
$setup-matt-pocock-skills 为当前项目初始化,任务使用本地 Markdown 管理。先说明将创建或修改哪些配置,沿用已有项目约定。它会帮助约定任务、术语表和设计决策文档放在哪里。个人项目没有远程任务系统时,本地 Markdown 就够用。Markdown 是普通文本格式,可以用来写标题、列表和说明。
初始化可能修改 AGENTS.md 或 CLAUDE.md,并创建配置文档;如果使用远程任务系统,还可能创建缺失的标签。不同项目需要分别配置。
发出你的第一条调用
下面这句发在 Codex 聊天框里:
$ask-matt 我想给现有网站增加会员功能,目前只有展示页面。请推荐最短的完整流程,先讨论方案,暂不修改代码。这里的 $ask-matt 是技能名称,后面是目标、现状和操作范围。它不需要作为终端命令执行。也可以直接说:“请使用 ask-matt 技能,帮我选择合适的流程。”
收到追问就回答;拿到建议后,再决定下一步。需要你点名的技能不会因为安装完成就自动执行,允许按需选用的技能也只应在任务匹配时使用。具体以当前工具和技能说明为准。

不想翻全篇,就从这几个入口选
| 你现在遇到的情况 | 先找谁 |
|---|---|
| 不知道怎么开始 | ask-matt |
| 有想法,还没想清具体规则 | grill-with-docs |
| 需求明确,准备动手做 | implement |
| 网站报错、偶尔失灵或变慢 | diagnosing-bugs |
| 想检查已经改好的代码 | code-review |
| AI 的解释没听懂 | wait-what |
下面是 27 位小帮手的完整介绍。每段的示例都可以复制到聊天框,再换成你自己的项目和目标。
01 · 出发前,找对帮手
刚装好技能,可以先从这三个入口开始。
项目整理员 · setup-matt-pocock-skills
第一次在项目里使用这套流程时,先让它约定任务、说明和记录放在哪里。
$setup-matt-pocock-skills 为当前项目初始化,任务使用本地 Markdown 管理。一个项目配置一次;可能创建或修改项目说明。
技能导购员 · ask-matt
有目标却不知道该找谁,就把现状告诉它。它会推荐适合的技能和做事顺序。
$ask-matt 我想给网站增加会员功能,应该从哪开始?不用背下 27 个英文名,先问它就好。
大白话翻译员 · wait-what
AI 说了一大段还是没听懂?让它补上背景,把上一段重新讲清楚。
$wait-what 用中文重新解释,给一个例子,少用术语。原始说明偏向英语;加上“用中文”更明确。
02 · 把想法聊明白
先知道自己要什么,后面才不容易返工。
会记笔记的提问员 · grill-with-docs
要改现有项目,但规则还没想全时,它会边问边记下业务用词和重要决定。
$grill-with-docs 我想增加优惠券,帮我问清使用和退款规则。会维护术语和决策文档,方便以后接着做。
想法陪练员 · grill-me
课程计划或产品点子都可以交给它推敲。它会通过追问,帮你发现遗漏和不合理的假设。
$grill-me 帮我推敲这个课程计划,看看哪里还没想清楚。本身不负责维护项目术语和决策文档。
追问方法小助手 · grilling
这是分轮追问的方法:每轮提出问题和建议,等你回答再往下走。
$grilling 帮我找出这个方案里还没做出的决定。前两个技能都会用到它,日常不用单独记。
03 · 把大目标拆成小步
需求说明记录做什么,任务清单安排怎样分步完成。
需求记录员 · to-spec
讨论有了结果,就让它整理成开发说明,写清范围和验收方法。
$to-spec 把刚才确定的优惠券方案整理成开发需求。会写入项目配置的任务系统,也可能确认测试范围。
任务拆分员 · to-tickets
事情太多时,用它拆出能逐项完成的小功能,并注明先后关系。
$to-tickets 把这份需求拆成任务,注明先后关系和验收标准。每个小任务最好都能单独演示或验证。
大项目探路员 · wayfinder
目标很大、关键问题还没理清时,它会先列出需要决定的事,再逐项推进。
$wayfinder 我想做多商户系统,先梳理必须做出的决定。默认先做规划和决策,适合跨多次对话的大事。
04 · 开始动手,把东西做出来
明确的小功能用 implement;还在试方向,可以先做原型。
功能施工员 · implement
需求明确后,让它按要求改代码、做检查,并审查完成的改动。
$implement 按确定的规则实现优惠券,完成测试,暂不提交 Git。原始流程会保存 Git 提交;不需要时请说明。
整套工程领队 · implement-spec
有完整需求和一组互相依赖的任务时,它会安排多个 AI 助手分工,最后汇总到一个分支。
$implement-spec 按这份需求和任务清单完成开发,汇总到一个分支。会创建工作分支并汇总改动,某些配置下会创建 PR。
试做样品师 · prototype
界面和逻辑还没定下来,可以先让它做一个能点、能试的样品,看看实际效果。
$prototype 做三个订单管理页方案,让我切换比较。样品用于探索,正式上线前还要完善和验证。
05 · 看看对不对,找出哪里坏了
这三个技能分别侧重开发时的测试、故障排查和改动审查。
先出题的检查员 · tdd
规则清楚时,可以先写出会失败的测试,再实现功能,让测试通过。
$tdd 实现优惠券到期校验,检查有效、过期和临界时间。开始前会对齐要检查哪些行为。
故障侦探 · diagnosing-bugs
网站报错、偶尔没反应或突然变慢时,找它先复现问题,再排查原因,修复后重新验证。
$diagnosing-bugs 点击保存偶尔没有反应,帮我复现并定位原因。尽量说清你做了什么、看到了什么、原本期待什么。
代码质检员 · code-review
准备合并改动前,让它对照代码规范和需求再检查一遍。
$code-review 检查当前分支相对 main 的改动,对照这份需求审查。main 要换成项目真实基准;最好提供需求来源。
06 · 整理结构,让以后更好改
项目越做越大,这几个技能分别处理结构、接口和业务概念。
结构体检员 · improve-codebase-architecture
不知道该先整理哪里时,让它查看代码结构,生成可视化报告,再挑出值得改善的地方。
$improve-codebase-architecture 检查订单模块,找出最值得改善的结构问题。先找候选问题,再讨论选中的方向。
模块设计师 · codebase-design
某部分代码难用、难改或难测试,可以用它梳理职责和调用方式,让复杂逻辑集中处理。
$codebase-design 支付模块调用太复杂,帮我设计更简单的接口。适合讨论一个模块应该怎么组织和使用。
业务词典员 · domain-modeling
“用户”“客户”“会员”可能指不同对象。它帮助统一业务概念和名称,并记录必要的决定。
$domain-modeling 理清用户、客户、会员和订阅的区别。会维护术语表,必要时记录设计决策。
07 · 把需要的信息找齐
有些答案在资料里,有些在客户那里,有些藏在反馈中。
资料调查员 · research
选方案需要依据时,让后台 AI 助手查官方文档、源码等一手资料,保存带出处的结论。
$research 查官方资料,比较这两个库对当前项目的适用性。会生成 Markdown 调研文档,方便回查来源。
问卷设计员 · to-questionnaire
当关键信息在客户或同事那里,它会先弄清问谁、缺什么,再写成可填写的问卷。
$to-questionnaire 帮我做一份给客户填写的网站需求问卷。生成问卷不等于已经发给对方。
反馈分诊员 · triage
收到很多报错和新功能建议后,用它区分有效反馈、待补信息和可以开始做的任务。
$triage 整理待处理反馈,找出已经可以开发的任务。会按配置更新任务状态;已拆好的任务通常不用再分诊。
08 · 交付前后,把事情交代清楚
说明改了什么、留下进度,再想想下次怎样做得更顺。
改动说明员 · pr
把代码改动交给别人检查前,让它写清改动效果、验证证据和合并影响。
$pr 根据当前改动写 PR 描述,包含验证结果和影响。PR 可理解为“请检查并合并这些改动”的申请。
工作交接员 · handoff
换聊天之前,让它把进度、决定、相关材料和下一步整理成文档,供后续接手。
$handoff 下一轮继续做移动端适配,请整理交接信息。文件默认在临时目录;长期保存请复制到稳定位置。
复盘教练 · retro
如果一次开发反复返工,可以请它回看过程,提出工具、项目说明和检查方式的改进建议。
$retro 回顾这次修复为什么反复失败,提出改进建议。重点改善下一次工作的条件。
09 · 学习与配置,也有好帮手
不会就学,需要亲手完成的步骤就让向导带路。
长期学习教练 · teach
告诉它你想学到什么程度,它会安排课程和练习,并记录学习进度。
$teach 教我 TypeScript,目标是能看懂并修改当前项目。会创建课程和学习记录,适合放在专门的学习目录。
一步一步的向导 · wizard
有些配置需要你亲自登录或输入信息。它会生成交互式脚本,逐步说明打开哪里、填写什么。
$wizard 为必须由我手动完成的服务配置生成操作向导。生成的脚本可能写入配置;具体范围由任务决定。
AI 说明书编辑 · writing-for-agents
用它整理给 AI 阅读的项目说明,减少重复和含糊要求,让规则更容易理解。
$writing-for-agents 精简当前 AGENTS.md,保留必要规则。AGENTS.md 可以理解为“这个项目给 AI 的工作说明”。
跟着一个小例子走一遍
假设你有一个网站,想增加优惠券。你还没决定优惠券能不能叠加、退款后是否退回、过期时间怎么算。这时先把规则聊清楚,会比直接让 AI 开工省事。
$grill-with-docs 我想给网站增加优惠券。请帮我问清适用商品、有效期、是否叠加、退款后怎么处理。先确定规则和验收方法,暂不修改代码。等讨论结束,需求已经够小、够明确,就发送:
$implement 按刚才确定的优惠券规则完成实现。验证正常使用、过期和不符合条件的情况,暂不提交 Git,不部署。如果工作已经大到要分很多次做,再分别调用 to-spec 写需求、to-tickets 拆任务,随后根据规模选择 implement 或 implement-spec。每一步单独发送,等结果出来再继续。
这里的“验收”就是检查有没有满足你的要求。例如:有效券能使用,过期券会被拒绝,用户能看到正确的提示。看到代码写完,还需要看这些检查的实际结果。

网站坏了,换成“故障侦探”的说法
$diagnosing-bugs 订单页点击保存后偶尔没有反应。操作步骤:修改备注,再点击保存。实际现象:按钮没有提示,刷新后备注还是旧的。预期结果:保存成功并显示新备注。请先复现并定位原因,修复后验证。暂不部署。这是一个示例场景,并非本教程实际修复过的故障。你使用时,把页面、步骤、现象替换成真实情况;如果有报错截图或日志,也一并提供。
准备换聊天,让它留下交接便条
$handoff 下一轮继续做移动端适配。请整理已完成部分、确定的要求、相关文件、验证结果和未解决问题。把交接文档保存在当前项目里,方便之后继续。在新聊天里提供这份文件的位置,再说“读取交接文档后,继续处理未完成的移动端适配”。handoff 默认可能把文件放到临时目录,上面的示例明确要求存到项目中,方便长期保留。
哪些事会真的动到项目?
调用前,可以在请求末尾补一句自己的范围。下面几种说法都很直接:
| 当前只想做到这里 | 补充这句话 |
|---|---|
| 先看方案 | 先分析并给方案,暂不修改代码。 |
| 允许改文件,暂不提交版本记录 | 完成实现和验证,暂不提交 Git。 |
| 任务保存在自己电脑 | 使用本地 Markdown,不发布到远程任务系统。 |
| 完成开发,暂不上线 | 完成本地实现和测试,不部署。 |
implement 的原始流程包含 Git 提交;implement-spec 会安排子代理和独立工作区,集成分支,并可能按项目配置创建 PR。Git 用来保存代码版本,分支是一条独立的修改路线,PR 则是请别人检查并合并代码改动的申请。
to-spec、to-tickets 和 triage 会按配置读写任务系统;wizard 生成的脚本可能修改本地或远程配置。问卷生成也不代表已经发给客户。需要发出消息或上线时,要把具体要求另行说清楚。
学长刚蝈更建议新手第一次先拿一个小任务练习,例如整理一份问卷,或让 wait-what 解释一段看不懂的话。等你熟悉它会产出什么,再把修改项目的工作交给它。
留一份手册,下次按场景翻
下载澜序 AI · 27 个 Skills 卡通入门手册(PDF,14 页)
PDF 保留了小机器人、场景卡片和可点击的目录,适合放在电脑或手机里随时查阅。博客中的调用示例可以直接复制;读到某个英文名忘了用途,再回来找对应的小帮手即可。
本教程依据 2026 年 10 月 11 日整理的中文手册与本机技能说明编写,版本为 1.3.1,对应源代码提交 49dd158d1076134a641b33efb035946536778336。技能更新后,数量、安装方法或具体流程可能变化。
原始规则请查阅 Matt Pocock Skills 源项目及这次手册对应的源码版本。本次核对了说明和技能清单,没有对全部 27 个技能逐一做真实项目运行测试。
支持与分享
如果这篇文章对你有帮助,欢迎分享给更多人或赞助支持!
最后核对于 。AI 产品更新很快,如果页面、价格或规则已经变化,欢迎顺手告诉我。