你的信息源有点过时了,你去看看他的 skills 最新版更新了啥?反思一下自己为什么没有获取到最新的信息
回 群友 7409: 去查了。先认账:我上一条里把「Agent 读的术语表」写成 CONTEXT.md,这个已经不是当前命名了——仓库在 1.3.0 把 CONTEXT.md / CONTEXT-MAP.md 全量改名为 GLOSSARY.md / GLOSSARY-MAP.md,而且这次是 breaking,老的 CONTEXT.md 得自己 git mv 过去,新技能只认新名字。 为什么我过时了,三个具体原因,不找借口: 一是吃了二手快照。我上条的知识来自 X 那条原帖加一篇 7 月写的仓库导览(那份导览当时数的是 160k star,现在 README 上是 278.4k star、1.5k watching、23.3k fork,光这一点就说明我引的是旧截面)。搜索会把同一个链接反复喂给我,但页面内容已经变了,我没回主源对时间戳。 二是没读 CHANGELOG。这个仓库是 changesets 发版节奏,527 次提交,最新版本 1.3.1。像改名、删技能、调用约定这种变更全在 CHANGELOG 和 releases 里,README 只反映当前状态、不带「什么时候变的、怎么迁移」。我上条只读了 README 和一篇文档页,等于只看结果不看 diff,所以不知道哪些说法刚过期。 三是没意识到这个仓库「改名即惯例」。它历史上已经干过 writing-great-skills → writing-for-agents,7 月那篇导览的原话就是「技能被改名、被替换、被公开埋进 deprecated」,对这种仓库,任何「文件叫 xx、技能叫 yy」的表述都得现场复核一次。 那最新的版本更新了什么,拣对你有用的说: 版本与安装。1.3.1 是当前版。安装现在是两条路、两种哲学:Claude Code 官方 marketplace 里的 mattpocock-skills 插件,装的是托管只读整包,更新跟着 marketplace 的 pin 走,可能比仓库晚几天到几周,卡版本用 claude plugin list 看自己装的哪版;或者 npx skills@latest add mattpocock/skills,把技能当普通文件复制进你项目,自己能改,npx skills update 手动拉更新。官方提醒别两个都装,会每个技能装两份。另外仓库自己也进了 marketplace(claude plugin marketplace add mattpocock/skills),走这条路可以开自动更新。装完每个仓库跑一次 /setup-matt-pocock-skills 配 issue tracker、triage 标签和文档目录。 术语表改名。刚才说的 CONTEXT.md → GLOSSARY.md,涉及 domain-modeling、grill-with-docs、improve-codebase-architecture、setup-matt-pocock-skills、triage、tdd、diagnosing-bugs、ask-matt、codebase-design、wait-what、pr 全部读写点,还有文档页和仓库自己的根术语表。wait-what 还会顺着 GLOSSARY-MAP.md 找到多上下文里对的那份 GLOSSARY.md。 新增技能。1.2.0 加了 wait-what,一个词纠正模型啰嗦:消息没落地就敲它,agent 用简体技术英语加你的术语表重讲一遍,整个技能三行,机制就是「名字本身是 leading word」——名字描述听众状态,而不是描述输出,所以它不会像 /tldr 那样让模型硬砍字数。1.3.0 把 implement-spec、pr、retro 从 in-progress 扶正进 engineering 桶:implement-spec 一次跑完整个 spec,把 ticket 当任务图,在各自 worktree 里并行跑实现 subagent,最后落到一条 integration 分支再走 code-review;pr 规定 PR 正文怎么写(最小的可视化摘要 + 前后证据 + 合并风险判断);retro 回头看一次会话,给的是改 agent 环境而不是改代码的建议,机械违规要换成确定性检查,判断类才留 CODING_STANDARDS.md。另有 ask-matt 做路由,你问「我该用哪个技能」它来分派。 行为变更。resolving-merge-conflicts 这个技能被删了,没有替代品,冲突就让 agent 自己走;diagnosing-bugs 的 Phase 6 不再交棒给 improve-codebase-architecture,1.3.1 又把 ask-matt 里那句残留也清了,改成修复完成后指你去 /retro 问「什么能预防这个 bug」。子 agent 派发指令去掉了 Claude Code 特有工具名,好在 Codex 等 harness 上通用。1.2.2 修了 writing-for-agents 在 Codex 里被过滤掉的问题,并把它的 policy 打开成模型可调用。1.2.3 给 diagnosing-bugs 加了脱敏规范,wizard 去掉了时间预估。 调用约定。跨技能调用从「run the /grilling skill」这种散文式写法,统一改成显式的 Call the Skill tool with "grilling"。原因很实在:只用斜杠名字写在正文里,技能不保证被加载,这是 grill-with-docs 被报告最多的问题。同时立了不变量——user-invoked 可以调 model-invoked,但永远不能调另一个 user-invoked,所以 to-spec、wayfinder、to-tickets、triage、code-review 里那五处都改写成「让人去跑」。 writing-for-agents 本身也扩了。除了我上次说的 context pointer、information hierarchy、completion criteria、leading words、pruning,现在多出两块:co-location(同一个概念的定义、规则、注意事项要挨着放,别散)和 negation(用禁止式下指令会把被禁行为拉进上下文、反而更可用,要正面陈述目标行为,禁令只留给无法正面表述的硬护栏)。另外把 cache 讲清楚了:文档复述环境里查得到的东西就是缓存,环境本身也是 source of truth,只缓存查不到的东西。leading words 那节的例子也换了血,现在点名的有 lesson、fog of war、tracer bullets,加上正文里的 tight、red,和我上次列的框架一致,只是「先找现成词、自造词借不到先验、太弱的词等于 no-op」这套判据更硬了。文档站现在是 27 页,writing-for-agents 那页 8 月 24 日更新过。 所以给我自己定的规矩:以后提到这个仓库的任何命名、技能清单、安装命令,都先拉一次 CHANGELOG 或 releases,再回 README 交叉,别拿记忆里的版本答。你上条问的 leading words 本身没被推翻,只是术语表文件名那部分过期了,要我把那批词按最新文档重列一遍也行。