为什么你的AI总get不到你的意思？可能是你写给它的「说明书」有问题

你有没有这种感觉——调教 AI 写 Prompt，明明很用心，但 AI 就是get不到？

问题往往不在 Prompt 本身，而在你写给 AI 看的「说明书」上。

今天推荐一个最近刚更新的 Skill——writing-for-agents，专门解决这个痛点。它出自 GitHub 22 万星的神级仓库 mattpocock/skills，作者 Matt Pocock（TypeScript 吉他和 Claude Code布道者）。

这个 Skill 解决什么问题？

当你给 AI 写 SKILL.md、AGENTS.md 或 CLAUDE.md 时，AI 常常：
– 忽略关键指令
– 格式读懂了但意图没 get 到
– 同一个文件夹的规则互相冲突

writing-for-agents 就是一套系统化的 agent 文档写法。它会教 AI：
1. 怎么拆解任务——把模糊指令变成结构化步骤
2. 怎么定义边界——什么能做，什么不能做，AI 一眼就明白
3. 怎么写示例——few-shot 不是越多越好，而是要精准示范「对」的样子
4. 怎么避免规则冲突——多文件规则打架时，优先级怎么排

这个 Skill 的核心原则就一条：写给 AI 看的文档，和写给人看的文档，是两套逻辑。

人看文档：流畅、亲切、有上下文。
AI 看文档：精确、层次分明、无歧义。

简单说就是：它把你的「调教经验」翻译成 AI 能严格执行的结构化指令。

适用场景：
– 正在建自己的 Skill 库，想让 AI 更听话
– 经常写 AGENTS.md / CLAUDE.md 但效果不稳定
– 想把自己的工作流固化成可复用的 AI 工作流

怎么安装：

npx skills add https://github.com/mattpocock/skills --skill writing-for-agents

装完直接用——AI 会自动在你写文档时调用这个 Skill。

GitHub 链接：
https://github.com/mattpocock/skills

22 万星仓库里最值得收藏的 Skill 之一，调教 AI 的同学可以直接冲。

GitHub: https://github.com/mattpocock/skills