Matt Pocock 技能集
Matt Pocock Skills 底层设计：调用边界与共享参考资料
把技能集合读成用户入口、可复用方法和项目约定组成的关系图，而不是不存在的隐藏编排引擎。
你将学会
- 控制边界本身就是设计的一部分
- 让可复用知识有明确归属
- 参考资料不一定都是硬性前提
开始前需要
- 理解基础仓库、工单系统与测试概念
- 能够区分指令内容和执行权限
选择采用方式，并追踪相关文件、权限边界和验证证据。
先看结论
- 调用标记表达预期可达性，不代表通用权限强制执行。
- 查阅领域术语与修改领域决策是不同操作。
- 工单配置可能是硬前提，术语上下文则可能缺省。
控制边界本身就是设计的一部分
仓库将用户主动进入的流程与模型可发现的方法分开。用户触发技能在 SKILL.md 中声明 disable-model-invocation，同时在 OpenAI 元数据中声明 allow_implicit_invocation: false；项目约定要求两处一致。这表达的是预期集成契约，并不是独立的安全沙箱。
ask-matt 这样的路由技能面向人解释哪个入口适合当前情况，不应把说明文字变成自动启动其他用户专属流程的权限。检查真实宿主时，还要确认它识别哪些元数据、怎样暴露调用能力；仓库设计文档不是对所有宿主版本行为的保证。
让可复用知识有明确归属
调用指南把可复用方法放入模型触发技能，并要求依赖者明确调用它们；辅助文档保留在负责该知识的技能旁边。这减少了测试规则或领域建模规则被多份复制后逐渐漂移的可能。依赖应该写在指令里，而不是只靠文件夹名字让读者猜测。
项目上下文属于另一层。读取已有术语表是被动理解词汇，主动质疑术语并记录决策才是领域建模工作。若把两者混为一谈，一次只读探索就可能意外改写项目知识。审查时可以明确追问：任务只是查阅上下文，还是已经授权改变它？
参考资料不一定都是硬性前提
setup 的 ADR 区分必须知道工单目标或标签映射的流程，以及缺少术语表也能运行的方法。目标位置不明时，工单无法被正确发布；缺少领域文档时，行为测试仍可能有价值，只是命名和假设不够准确。这种区别不能成为编造缺失配置的理由。
可以用三层结构理解本仓库：明确选择的流程入口、可复用方法、仓库特定约定。解释它不需要虚构队列服务器或执行守护进程。改造技能时，应同时追踪调用依赖和预期项目文件，避免一次小的文字修改悄悄改变流程权限或必要前提。
实施步骤
- 1
找出当前任务由用户触发的入口。
- 2
追踪它明确依赖的可复用技能。
- 3
列出预期项目文件与外部目标。
- 4
依赖调用边界之前，核对宿主的实际行为。
可复制示例
{
"entryPoint": "human-invoked workflow",
"reusableLayer": ["testing discipline", "domain modeling"],
"projectContext": ["issue tracker", "label mapping", "domain documents"],
"metadataIsSecuritySandbox": false
}常见问题
文字里出现斜杠命令就会自动执行吗？
不能这样理解。仓库区分面向人的路由说明与实际调用指令，最终执行还取决于宿主。
所有方法都必须在 setup 缺失时拒绝工作吗？
不是。源码区分不可缺少的配置依赖，与能改善输出但可以缺省的上下文。
资料来源
- .agents/invocation.md来源核查 2026-09-08
- .agents/adr/0001-explicit-setup-pointer-only-for-hard-dependencies.md来源核查 2026-09-08
- skills/productivity/writing-for-agents/SKILL-MECHANICS.md来源核查 2026-09-08