每次都要跟AI重新说一遍?writing-for-agents 教你写AI真正会看的文档

你有没有这种感觉——每次打开 AI 对话,都要先把项目背景、规则、上次做到哪了重新说一遍?就像请了个记忆力只有一泡的实习生,每次交接都要从零教?

这个痛点太真实了,而 writing-for-agents 就是来解决它的。

它是干什么的

这个 Skill 出自 TypeScript 大神 Matt Pocock 的 mattpocock/skills 仓库(Stars:271K+,闭眼信的级别)。它专门教你——或者更准确说,教你的 AI agent——怎么写出让下一轮对话直接可用的文档。

什么文档?三种:

  • Skill:给 AI 看的操作说明书
  • AGENTS.md / CLAUDE.md:你的私人 AI 使用手册
  • Context Pointer:精准触发 AI 调用特定知识的”书签”

核心方法论:两个 Load

这个 Skill 的精华在于它提出了 两个 Load 的概念,帮你决定信息放在哪里:

Context Load(上下文负载):每次对话都加载进 AI 窗口的内容。少放,放精华。

Cognitive Load(认知负载):你需要自己记住”这份文档存在、这里去找”的信息。可以多一些,但放错地方就等于没放。

听起来简单?但大多数人写 AGENTS.md 的问题就是把所有东西都往 Context Load 里塞——结果 AI 的上下文窗口一开始就被垃圾信息占满了,真正需要的东西反而挤不进去。

什么时候用它

写新的 Skill 时——你知道这个 Skill 什么时候该被触发吗?触发词写得模糊,AI 就不会调用。writing-for-agents 告诉你怎么写触发词、怎么组织 Skill 结构。

维护 AGENTS.md 时——很多人把 AGENTS.md 写成流水账。这个 Skill 教你怎么把 AI “不需要每次都知道”的信息剥离出去,只留真正每次都要用到的。

团队共享知识时——当你需要把某个领域的判断标准写成文档,让团队里所有人调教出来的 AI 都能统一行为,writing-for-agents 教你结构化地组织这些内容。

一句话总结

writing-for-agents 解决的是「人和 AI 之间信息怎么传递」的问题。它不是教你写更好的提示词,而是教你写 AI 愿意认真读、读得懂、读了会照做的文档。

在这个 AI 工具爆发的时代,最高效的人不是会用最多工具的人,而是最擅长和 AI 交接工作的人。

GitHub:https://github.com/mattpocock/skills(在 skills/productivity/writing-for-agents 目录下,找 SKILL.md 和 SKILL-MECHANICS.md 两份文件结合看效果最佳)。


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

评论区

0 条评论

登录后可评论。

林小秋 23 阅读