ikook’s Blog
独立之精神,自由之思想

AI 实践指南 11:做过一次的方法,怎样让 AI 下次照做

2026-11-01

上一篇把出简报的要求写进了说明文件,之后出一期只要说一句话。现在再看那份 AGENTS.md,里面其实混着两种东西:一种是每次都要遵守的约定,比如只看官方来源、数据长什么样;另一种是一套做事的步骤,先换算时间窗口,再按什么顺序查来源,怎么确认发布时间,最后怎么写文件、怎么汇报。

后面这种“一套步骤”,更适合做成一个 Skill。

Skill 是什么

Skill 就是把一套做事的方法打包成一个文件夹,交给 AI,让它下次按这个方法做。

文件夹里最重要的是一个 SKILL.md。开头写两样东西:名字,和一句“什么时候该用它”的描述;下面写具体怎么做,一步一步写清楚。文件夹里还可以放脚本、参考资料、模板,做事的时候用得上。

它和上一篇的说明文件最大的区别,是什么时候读。说明文件每次开工都会整份读进去;Skill 平时只读名字和描述,碰到对得上的任务,才把整份读进来。所以 Skill 可以写得很细,装很多个也不占地方。

打个比方,说明文件像入职手册,这个项目有哪些约定,每个人第一天都要看;Skill 像一本本操作手册,平时放在柜子里,要干哪件活,才把那一本拿出来用。

Claude Code 的官方文档里也是这么建议的:说明文件里那些已经长成了一套流程、不只是事实的内容,挪到 Skill 里去。

Skill 现在是一个通用的格式,叫 Agent Skills,最早是 Anthropic 做的,后来开放成了标准,Claude Code、Codex、ChatGPT 都支持,同一个 SKILL.md 主流 AI Agent 都能用。

把出简报做成 Skill

还是在简报项目里,新开一个会话,让它自己来拆:

把“出一期简报”的做法做成一个 Skill:
- 放在 .agents/skills/daily-brief/SKILL.md,按 Agent Skills 的标准格式写,开头写 name 和 description;再建一个 .claude/skills/daily-brief 链接指向它,让 Claude Code 和 Codex 都能用
- 把 AGENTS.md 里“怎么做”的步骤挪进 Skill:换算时间窗口、按什么顺序查来源、怎么确认发布时间、写原文和数据、本地预览、最后汇报。AGENTS.md 只留每次都要遵守的事实和约定,比如信息源、收录标准、数据格式
- description 要写清楚什么时候该用它,比如让你出某一天的简报时
- 写完先别提交,给我看看

两分钟不到,它做好了。SKILL.md 的开头是这样的:

---
name: daily-brief
description: 出一期“AI 工具变化简报”:按北京时间某一天的窗口,核查 Codex、ChatGPT、Claude(含 Claude Code)、DeepSeek 的官方更新,写出 raw/YYYY-MM-DD.md 原文和 data/YYYY-MM-DD.json 数据,本地预览后汇报。当用户让你出某一天的简报、补某一期、重做或核对某一期简报时使用。
---

下面分了七步:换算时间窗口、按顺序查来源、确认每一条的发布时间、写原文、写数据、本地预览、汇报。AGENTS.md 里的步骤都挪走了,开头加了一句,操作步骤见这个 Skill。

它还多做了一样我没要求的:写了一个时间换算的小脚本,放在 Skill 的文件夹里。时间窗口换成 UTC 和美国太平洋时间、发布时间换成北京时间、推文编号换算出发布时间,这几件事每期都要做,手算容易错,干脆交给脚本。拿第二期一条已知的推文试了一下,算出来的时间和当时一致。Skill 里不光能放怎么做,还能把做事用的工具一起放进去。

两个工具都能用

这里有个容易踩的坑。SKILL.md 的写法两家是一样的,但放的位置不一样:Claude Code 读项目里的 .claude/skills/,Codex 读 .agents/skills/。

所以这里把 Skill 放在 .agents/skills/ 里,再在 .claude/skills/ 放一个链接指过去,两边用的是同一份文件,改一处两边都生效。我在 Claude Code 和 Codex 里分别试了,都能用上。

一句话出第四期

Skill 提交上去之后,新开一个会话,还是只说一句:

出一期 10 月 31 日的简报。

我没提 Skill,它第一件事就是自己把 daily-brief 调了出来,然后按里面的步骤,先跑脚本换算时间窗口,再一个个去查来源。会话记录里能清楚地看到这一步,它是看了描述,判断这个任务该用它。

如果想手动叫它,Claude Code 里输入 /daily-brief,Codex 里输入 $daily-brief 就行。

这一期有 3 条,都在 Claude 这边,最要紧的是 Claude Code 的一个新版本:Opus 4.8 的快速模式 11 月 30 日下线,下线后请求会直接报错,不会自动退回普通模式。这一条我对过 GitHub 上的发布说明,没问题。

它还顺手提了个建议

写 Skill 的时候,它提了一句:评分现在没有明确的分档,什么分数算“需要调整”,全凭感觉,建议定一下。

我觉得有道理,就让它参考前四期的实际打分来定。四期一共 23 条,写“需要”的 4 条都是 Claude Code 的新版本,分数在 85 到 88;写“可以关注”的最高只到 82。它就把 85 定成了分界线,写进了说明文件:

- 评分按对日常使用这几个工具的人有多大影响分三档,和“是否调整用法”对应:
  - 85—100:直接影响日常用法,比如主力工具的新版本、默认行为或额度变化;写“需要”。
  - 70—84:值得了解、可能用得上,比如新功能、套餐或使用政策调整;写“可以关注”。
  - 0—69:间接相关或影响面小,比如研究、安全、学术计划类消息和小范围功能;写“可以关注”,和日常用法无关的产品变化写“不需要”。
  - 写“需要”的必须在 85 分以上,85 分以上的必须写“需要”。

前几期的分数一个都不用改。它还建议在 Skill 的自查那一步加一句,每期出完核对分数和标签对不对得上,我也加上了。

这就是用 AI 做一件事做久了的好处:它跑过几次之后,能从实际结果里看出哪里还可以更好,你只要判断要不要采纳。

放在项目里,还是放在自己电脑上

Skill 和说明文件一样,也分放在哪。

放在项目里,比如这次的 .agents/skills/,Skill 就跟着项目走,项目推到 GitHub,别人下载下来也有这个 Skill。适合只跟这个项目有关的流程,出简报要查哪些来源、数据写成什么格式,换个项目就用不上。

放在自己电脑的个人目录,Claude Code 是 ~/.claude/skills/,Codex 是 ~/.agents/skills/,就是在所有项目里都能用。适合你自己的通用做法,比如写周报、整理会议纪要。

如果打算把 Skill 分享出去,或者跟项目一起公开,记得先看一眼里面有没有写死自己的名字、自己的习惯。这次我就发现,项目的说明文件和 Skill 里写着我的称呼,还有“先别提交、等我看过”这种只属于我的习惯,都改成了通用的写法。个人习惯放在全局说明里就够了。

不写代码,也一样用得上

Skill 同样不只是研发人员的事。比如整理会议纪要,每次的步骤都差不多,就可以做成一个 Skill(这是我随手写的示例):

---
name: meeting-notes
description: 把会议录音转写稿整理成会议纪要。用户给出转写稿、让你整理会议记录或会议纪要时使用。
---

# 整理会议纪要

1. 先通读全文,找出会议主题、参会人和结论
2. 按“结论、待办、待定问题”三部分整理,待办写清楚谁、做什么、什么时候
3. 只用转写稿里有的内容,听不清、不确定的地方标出来,不要猜
4. 控制在一页以内,最后问一句有没有漏掉的

写 Skill 也不用从零开始。Codex 和 ChatGPT 自带一个 skill-creator,Codex 里输入 $skill-creator,它会问你这个 Skill 做什么、什么时候用,然后帮你写好;Claude Code 里直接跟它说“帮我把刚才这套做法做成一个 Skill”也可以。

你也可以试试:找一件你重复做过三次以上、每次步骤都差不多的事,把这次做的过程交给 AI,让它整理成一个 Skill。下次只说一句话,看它会不会自己用上。

出简报现在有了说明文件,也有了 Skill。不过有一个问题一直没解决:X 上的官方账号,没登录只能看到一部分,每期都有没加载全的时候。下一篇就讲 MCP,看怎么把这类工具和资料接给 AI。

相关阅读:
AI 实践指南 01:让所有人把 AI 真正用起来
AI 实践指南 02:模型、聊天工具和 Agent,我们到底在用什么
AI 实践指南 03:ChatGPT、Claude 开通指南,一步步来
AI 实践指南 04:怎样把一件事交给 AI
AI 实践指南 05:AI 交回来的东西,怎么检查和纠正
AI 实践指南 06:从需求到交付,做出第一期简报
AI 实践指南 07:让 AI 围绕一个项目持续工作
AI 实践指南 08:一次任务背后,AI 是怎么干活的
AI 实践指南 09:上手 Agent,装好、打开、做完第一件事
AI 实践指南 10:让 AI 遵循你的工作习惯


题图标题:《窗台》
创作者:ikook
AI 算法提供:

  • OpenAI GPT Image 2(题图)

本文图文版权所有,未经授权请勿转载或使用。