这组入门课的目标,是让你能把一份 Skill 放回真实工作过程里理解。先建立这个基础,后面再学习测试、规格、模块和架构,就知道那些规则究竟由谁在什么时候采用。
一张表,分清六种状态
| 状态 | 一个具体例子 | 尚不能由此推出什么 |
|---|---|---|
| 我看过它 | 在教材网站读了 grill-me |
不能推出任何 AI 已安装它 |
| 我拿到了它 | 保存了技能文件夹 | 不能推出当前产品会发现它 |
| 环境能发现它 | 它出现在当前可用技能清单中 | 不能推出本次任务已经使用 |
| 本次已读取它 | 系统取得正文及必要参考材料 | 不能推出所有要求都已正确执行 |
| 本次按方法工作 | 根据规则提问、调查或生成成果 | 不能推出结果符合你的真实目标 |
| 结果经过检查 | 核对需求、文件或运行证据 | 只能说明实际检查覆盖到的内容 |
这里不是让你多填六张表。它是一个诊断工具:遇到“我都装了,为什么没效果”,先找出卡在哪一层,通常比不断重复同一条命令更有效。
你可以怎样问 AI
不知道现在有哪些技能:
请列出当前会话实际可用、与我的任务有关的技能。只列能够确认的内容,并说明各自适用什么情况。
想使用一项指定技能:
请先确认能够找到并读取这项技能,再按它的方法处理下面的任务。需要我作决定时,用中文解释问题和影响。
发现解释仍然听不懂:
我不理解你使用的这个概念。先用完整中文解释它指什么,再用当前任务举例,最后说明它为什么会影响下一步。不要只换成另一个术语。
这些是老师给你的沟通范例,不是保证在所有产品中执行固定动作的特殊命令。
为什么不能把整本中文教材当作安装包
教材面向你,其中包含解释、假设案例、提问和对原文适用边界的讨论。Skill 原文面向执行任务的 AI,两者的用途不同。
例如原文要求“在已有测试接入点验证行为”,老师可能举“收藏课程”的例子。若把解释和例子全部当成执行要求,AI 可能误以为你的真实项目也必须开发收藏功能。
因此,你学习时读中英对照和讲解;实际使用时,确认采用的是哪份技能正文,以及是否完整具备其依赖。需要改成适合自己的中文版时,应单独维护一份执行文档,并用真实小任务检查它,而不是把整页教材直接改名为 SKILL.md。
与其他 Markdown 文件的关系
你还会遇到 AGENTS.md、CLAUDE.md、规格说明和 CONTEXT.md。先按用途辨认,而不要被文件名吓住。
| 文档 | 主要回答什么 | 教学例子 |
|---|---|---|
项目约定,如 AGENTS.md |
在这个项目中工作,需要遵守什么约定 | 哪些目录保存文档,怎样运行项目检查 |
| Skill | 做某类工作,采用什么方法 | 澄清需求时先识别尚未决定的问题 |
| 本次任务或规格 | 这一次具体要完成什么 | 学习记录助手应保留用户原始笔记 |
领域术语表,如 CONTEXT.md |
本项目的重要概念叫什么、是什么意思 | “原始笔记”特指用户最初提供的记录 |
文件是否自动读取、作用于多大范围,仍由具体产品及项目约定决定。文件名表达用途,也可能参与产品约定;不是只要名字正确,内容就自动永远生效。
第一轮学习,先练“说得清楚”
先用自己的话回答下面三个问题,不要求术语完全标准。
- 我在网站上读了一份 Skill,为什么不意味着我的 Codex 已经安装它?
- AI 读取一份“发布文章”的 Skill,为什么仍可能无法替我发布?
- 我通过对话指定一项 Skill 后,除了看它的最终回答,还可以检查什么?
把你的答案带回我们的对话。我会先找出概念上混淆的位置,再用例子解释;不会仅凭你读完页面,就把状态记为“已掌握”。
然后做一个很小的方法体验:围绕“学习记录助手”澄清一个问题,观察加上明确工作说明前后,AI 的行为有何变化。你希望先讲解、再问答、再讨论场景,实际安装可以放在这些基础已经清楚之后。
接着读哪几课
先读 ask-matt,理解有哪些工作阶段。再把 grill-me、grilling、grill-with-docs 联系起来,观察“入口技能”和“底层方法”的关系。
接着读 setup-matt-pocock-skills,此时你已经知道它配置的是什么。最后再进入 to-spec,学习如何把讨论清楚的内容整理成规格。
每天4小时是你可以投入的时间,不是必须塞满新概念的指标。这一阶段的进展,应看你能否解释并辨认上述真实过程,而不是读到了第几篇。