Skills 更新日志：统一语言 → /grill-with-docs
我的 skills 仓库已经获得超过 46.6k（约 4.66 万）颗 Star，也逐渐成为我对工程实践思考的提炼合集。现在，我会定期发布技能变更，这些视频就像更新日志一样，帮助你及时了解发生了什么。
这些技能就是为了让你下载到自己的环境中并立即使用。它们代表了我在日常工作中实际采用的方法和技巧。
仓库结构调整
第一项重大变化是仓库结构。技能现在被整理到不同分类中：
目前可以放心忽略 misc 和 deprecated 目录。
重大变更与新功能
/ubiquitous-language → /grill-with-docs
/ubiquitous-language 技能已弃用，并合并到一个更强大的新技能中：/grill-with-docs。
具体变化如下：
- 不再创建
ubiquitous-language.md，而是创建context.md - 把深度追问会话和文档整理合并到同一个阶段
- 支持多个限界上下文，这是领域驱动设计（DDD）中的常见模式
这意味着你可以拥有：
- 系统不同部分使用不同上下文（例如订单与账单）
- 每个上下文都有自己的
context.md和共享语言 - 无需强迫整个应用共用一套统一语言
/grill-with-docs 与 /grill-me 的区别：
| 功能 | /grill-with-docs | /grill-me |
|---|---|---|
| 最适合 | 代码库 | 通用场景（生活、工作、创意项目） |
| 输出 | context.md、ADR | 灵活的文档结构 |
| 位置 | 工程技能目录 | 效率技能目录 |
/grill-me 本身完全没有变化，只是重新整理了位置。甚至有人用它为母亲写悼词，效果非常好。
/grill-with-docs ——架构决策记录（ADR）
/grill-with-docs 现在会处理 ADR（架构决策记录）。当以下三个条件同时成立时，就应该创建 ADR：
- 决策很难撤销
- 缺少背景时，这项决策会令人意外
- 它确实源于一次取舍
你与 AI 就这些不明显的决策达成一致后，AI 就不会反复提出同一个坏主意。
/improve-codebase-architecture ——新的 LANGUAGE.md
/improve-codebase-architecture 获得了一次重大升级，现在提供了一整套讨论代码库改进的语言定义。
该技能现在会使用精确术语描述架构概念。例如：
**`Module`**Anything with an interface and an implementation. Deliberately scale-agnostic - applies equally to a function, class, package, or tier-spanning slice.**`Interface`**Everything a caller must know to use the module correctly. Includes the type signature, but also invariants, ordering constraints, error modes, required configuration, and performance characteristics.**`Implementation`**What's inside a module - its body of code. Distinct from Adapter: a thing can be a small adapter with a large implementation (a Postgres repo) or a large adapter with a small implementation (an in-memory fake).
有了这套共享语言，就能减少冗长对话，并让你与 AI 对“优秀代码库应该是什么样”保持一致。
/setup-matt-pocock-skills ——灵活适配任务跟踪器
这些技能现在可以适配任何任务跟踪器，不再局限于 GitHub Issues。
过去：/to-issues 等工程技能专门针对 GitHub Issues 调优。
现在：技能只会说“把任务发布到任务跟踪器”，但它怎样知道具体是哪一个？
答案是一个新技能：/setup-matt-pocock-skills。
它会创建 CLAUDE.md，为每个仓库搭建专属配置，其中包括：
- 任务跟踪器的位置
- 分诊标签
- 领域文档路径
自定义跟踪器：由于这些智能体由 LLM 驱动，你可以接入任何自定义任务跟踪器，甚至是尚未正式支持的工具。
设置过程如下：
Set up Matt Pocock Skills→ Install all engineering skills→ Pick the skills you want→ Run: matt-pocock set-up-matt-pocock-skills
最终生成的 CLAUDE.md 非常精简、清晰：
issues live at: github/issues at mattpocock.sandcastleissue tracker: logged in here
这些配置会渐进式披露——只有真正需要时，智能体才会读取。
新的实验性技能
/diagnose
/diagnose 用于修复棘手缺陷。每次调试时都可以运行它。
流程如下：
- 建立反馈循环
- 在该循环中复现缺陷
- 提出缺陷假设，并按可能性排序
- 加入观测手段（添加日志以观察行为）
- 实施修复
注意：目前 AI 在这些阶段中仍然太容易抢跑。这个技能还在继续调优。
/triage
/triage 用于分诊并非由你创建的任务，通常就是积压列表中的任务。
使用场景：产品经理写下模糊的功能想法，triage 负责把它们整理清楚。
工作方式：使用一套包含类别角色和状态角色的状态机。
类别角色：
bug——某项功能发生故障enhancement——新功能或改进
状态角色：
needs-triage——需要维护者评估needs-info——等待报告者补充信息ready-for-agent——信息完整，可以交给 AFK 智能体ready-for-human——需要人类实现wontfix——不会处理
每个完成分诊的任务都恰好拥有一个类别角色和一个状态角色。我在自己的开源仓库中使用这套方法，效果非常好：可以先添加模糊消息，再生成评论补充澄清，最终把任务整理到可由 AI 接手的状态。
获取更多更新
所有技能更新和充分发挥智能体能力的技巧，都会发布在 aihero.dev/skills。这是一份专门为 Skills 定制的通讯。
感谢你一路关注。希望你享受这些更新，就像我享受创造它们一样。下次见！