Matt Pocock Skills to-spec 完全指南从会话到发布【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills你刚聊完的两个小时关掉终端就没了 你刚和 Agent 聊完两个小时方案形状、反复权衡、你明确拒绝过的东西全在这段对话里。终端一关这些就没了明天的新会话一无所知你得重新讲一遍背景。Matt Pocock Skills 里的 to-spec规格文档生成技能就是为这一刻准备的它不打断你的思路把当前会话里已经做完的决策综合成一份 spec规格文档并作为单条 issue 发布到项目的 issue tracker问题追踪器上。to-spec 到底产出什么一份决策记录 先看产物形态。输入是当前对话线程、代码库现状加上仓库里的 CONTEXT.md 领域词汇表和 ADR架构决策记录输出是一条 spec issue。中间没有任何做新决策的环节。说白了就是它只记录不决策。spec 里断言了一句你从没说过的话那这句话就是缺陷。它和相邻技能的边界可以这样切对比维度to-specgrill-with-docsto-tickets干什么综合已做出的决策做出新决策把决策切成执行步骤产出物一条 spec issueADR 与 CONTEXT.md一组 ticket 垂直切片生命周期长期留存推理的唯一存放处长期项目词汇一次性用完即关发布出来的 spec 长什么样骨架来自 SKILL.md 内嵌的模板截取关键部分## Problem Statement ## Solution ## User Stories 1. As an actor, I want a feature, so that benefit ## Implementation Decisions Do NOT include specific file paths or code snippets. ## Testing Decisions - Prior art for the tests ## Out of Scope ## Further Notes这个片段里真正重要的只有两处。Implementation Decisions下的那句英文禁令不要包含具体文件路径和代码片段是模板里最反直觉的一条路径和代码过期最快写进去就是埋雷。唯一例外是原型prototype产出的、比散文更精确的片段比如状态机、schema、类型形状可以裁剪后内联并注明来源。另一处是Testing Decisions要求给出 prior art先例即代码库里的同类既有测试让后续实现有章可循。发布后它会给自己打上ready-for-agent标签。这是 triage-labels.md 定义的五种规范 triage分诊角色之一含义是文档已完整、无需再分诊。这个标签的坑后文细说。从调用到发布to-spec 的完整操作路径 ⚙️触发前检查清单tracker 与标签词汇仓库没拿到就先克隆git clone https://gitcode.com/GitHub_Trending/skills13/skills第一次使用任何工程技能前先跑一次/setup-matt-pocock-skills。它负责三件事选 issue trackerGitHub 走ghCLI、GitLab 走glabCLI、或本地 Markdown、把五种 triage 角色映射成真实标签串、登记领域文档位置。选本地 Markdown 的话约定写死在 issue-tracker-local.md 里spec 固定在.scratch/feature-slug/spec.md实现 ticket 是issues/NN-slug.md一票一文件、从01编号triage 状态记录在文件顶部的Status:行。这两项没配好时to-spec 不会自己猜它会直接让你去跑/setup-matt-pocock-skills。这是它少数几个会停手的时刻之一。唯一的触发方式/to-spec 及其参数手动敲/to-spec。技能在 skills/engineering/to-spec/SKILL.md 头部声明disable-model-invocation: trueagents/openai.yaml 里又是allow_implicit_invocation: false两个开关一起保证 Agent 永远不会自己伸手拿它。wayfinder 地图跑完之后把地图主 issue 的编号当参数传进去/to-spec #map_issue。地图散落的决策就在这一步被折叠成一份可构建文档。用不用它按这个表对号入座你现在的状态该怎么做做错了会怎样什么都还没决定先跑 grill-with-docs 做决策spec 会替你编决策已决定一个上下文窗口放得下直接/implement跳过 spec多付一次综合步骤模型可能漂移已决定且要横跨多个会话/to-spec再/to-tickets这才是它的主场wayfinder 地图已跑完/to-spec #map_issue喂零散决策票会丢掉折叠过程Agent 被调用后的三个动作探索仓库建立词汇。没看过代码就先看一遍spec 全程使用项目的领域词汇尊重所触及区域内的 ADR。卡住就它用的名词和你的代码库对不上回查 CONTEXT.md 是不是过期了。先勾勒测试缝seam。优先复用已存在的 seam取能取到的最高层理想情况下整个变更只要一个。列出来会先跟你确认再动笔。这步不能快进因为 seam 会传导下游tdd 技能只在预先商定的 seam 上写测试Test only at pre-agreed seamscode-review 会拿 diff 对照 spec 审查没人同意过的 seam 会直接变成 review 发现。卡住就seam 数量降不下来时别让它新建把测试点往公开接口上推。按模板写 spec、发布、打标签。七个小节填满作为单条 issue 发布打上ready-for-agent。卡住就发布失败或标签没打上回去检查 tracker 配置是否完整。发布之后你要做的三件事只读两个地方seam 部分和 Out of Scope 小节。错误决策在这两处被抓住最便宜事后发现最贵。通读全文没有摘要模式也别指望有。紧接着在同一窗口跑/to-tickets中间不要清空clearing或压缩compaction上下文。原因见下一节的第 5 条。如果你跑着轮询式 AFK Agent先处理标签问题同样是下一节第 1 条。文档不会主动告诉你的事 ⚠️这些不是 bug 报告多半是设计取舍。但文档不会专门点名所以这里点名。标签被当工单现象是 AFK Agent 轮询到ready-for-agent的 spec试图一口气构建整个 spec而不是捡 ticket 切片。根因是标签语义为无需再分诊属于输入标记而非工作指令而 Agent 看不见这个区别。规避在 AFK Agent 提示词里显式排除父级 spec或在/to-tickets跑完后剥掉该标签。spec 在实现当天就开始过时现象是实现教会你第一件事时spec 已经错了。根因是没有任何机制让它同步它本质是你当时所知的快照。规避交付后把 spec 当一次性物品实现中学到、值得留存的结论写进 CONTEXT.md 或 ADR别去改 spec 本身。用户故事模板装不下重构现象是围绕接口与不变量的决策被硬写出没人要的故事。根因是模板的形状为功能特性设计架构类工作是错的形状属于已知局限。规避倚重 Implementation Decisions 与 Testing Decisions 两节持久性的架构决策通过 grill-with-docs 落成 ADR。悄悄重复别人的工作现象是 spec 和追踪器里已存在的相关 issue 撞车。根因是它起草前不搜索追踪器读 ADR 也不做链接。规避该区域活跃时自己先搜一遍追踪器再跑/to-spec。下游读不回大 spec现象是/to-tickets反复截断本地没有副本兜底。根因是 spec 超出了 issue 正文能干净回读的容量。规避两个命令之间不做任何上下文清理同一个窗口连着跑spec 就根本不需要被重新拉取。决策其实没做现象是 spec 里断言了一句你从没说过的话。根因是它不采访你grilling追问决策不够深时综合只能靠补。规避spec 让你意外时说明是追问太浅回去补决策而不是硬验收。把 to-spec 放回整条构建链 决策grill-with-docs做出决策→ 沉淀to-spec记录决策→ 切片to-tickets切成垂直票→ 构建implement在 seam 上开发→ 审查code-review对照 spec 查 diffwayfinder 跑完的地图也在沉淀这一节点并入喂的是地图主 issue 而不是零散决策票不确定用哪个技能时ask-matt 负责路由。第一次用就先跑/setup-matt-pocock-skills零依赖场景选本地 Markdown 追踪器。单会话任务走 grilling 加/implement就够了to-spec 只给跨多会话的工作付账。下次长会话收尾时直接/to-spec然后在同一窗口接/to-tickets——这就是这套技能给出的标准答案。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Matt Pocock Skills to-spec 完全指南从会话到发布【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills你刚聊完的两个小时关掉终端就没了 你刚和 Agent 聊完两个小时方案形状、反复权衡、你明确拒绝过的东西全在这段对话里。终端一关这些就没了明天的新会话一无所知你得重新讲一遍背景。Matt Pocock Skills 里的 to-spec规格文档生成技能就是为这一刻准备的它不打断你的思路把当前会话里已经做完的决策综合成一份 spec规格文档并作为单条 issue 发布到项目的 issue tracker问题追踪器上。to-spec 到底产出什么一份决策记录 先看产物形态。输入是当前对话线程、代码库现状加上仓库里的 CONTEXT.md 领域词汇表和 ADR架构决策记录输出是一条 spec issue。中间没有任何做新决策的环节。说白了就是它只记录不决策。spec 里断言了一句你从没说过的话那这句话就是缺陷。它和相邻技能的边界可以这样切对比维度to-specgrill-with-docsto-tickets干什么综合已做出的决策做出新决策把决策切成执行步骤产出物一条 spec issueADR 与 CONTEXT.md一组 ticket 垂直切片生命周期长期留存推理的唯一存放处长期项目词汇一次性用完即关发布出来的 spec 长什么样骨架来自 SKILL.md 内嵌的模板截取关键部分## Problem Statement ## Solution ## User Stories 1. As an actor, I want a feature, so that benefit ## Implementation Decisions Do NOT include specific file paths or code snippets. ## Testing Decisions - Prior art for the tests ## Out of Scope ## Further Notes这个片段里真正重要的只有两处。Implementation Decisions下的那句英文禁令不要包含具体文件路径和代码片段是模板里最反直觉的一条路径和代码过期最快写进去就是埋雷。唯一例外是原型prototype产出的、比散文更精确的片段比如状态机、schema、类型形状可以裁剪后内联并注明来源。另一处是Testing Decisions要求给出 prior art先例即代码库里的同类既有测试让后续实现有章可循。发布后它会给自己打上ready-for-agent标签。这是 triage-labels.md 定义的五种规范 triage分诊角色之一含义是文档已完整、无需再分诊。这个标签的坑后文细说。从调用到发布to-spec 的完整操作路径 ⚙️触发前检查清单tracker 与标签词汇仓库没拿到就先克隆git clone https://gitcode.com/GitHub_Trending/skills13/skills第一次使用任何工程技能前先跑一次/setup-matt-pocock-skills。它负责三件事选 issue trackerGitHub 走ghCLI、GitLab 走glabCLI、或本地 Markdown、把五种 triage 角色映射成真实标签串、登记领域文档位置。选本地 Markdown 的话约定写死在 issue-tracker-local.md 里spec 固定在.scratch/feature-slug/spec.md实现 ticket 是issues/NN-slug.md一票一文件、从01编号triage 状态记录在文件顶部的Status:行。这两项没配好时to-spec 不会自己猜它会直接让你去跑/setup-matt-pocock-skills。这是它少数几个会停手的时刻之一。唯一的触发方式/to-spec 及其参数手动敲/to-spec。技能在 skills/engineering/to-spec/SKILL.md 头部声明disable-model-invocation: trueagents/openai.yaml 里又是allow_implicit_invocation: false两个开关一起保证 Agent 永远不会自己伸手拿它。wayfinder 地图跑完之后把地图主 issue 的编号当参数传进去/to-spec #map_issue。地图散落的决策就在这一步被折叠成一份可构建文档。用不用它按这个表对号入座你现在的状态该怎么做做错了会怎样什么都还没决定先跑 grill-with-docs 做决策spec 会替你编决策已决定一个上下文窗口放得下直接/implement跳过 spec多付一次综合步骤模型可能漂移已决定且要横跨多个会话/to-spec再/to-tickets这才是它的主场wayfinder 地图已跑完/to-spec #map_issue喂零散决策票会丢掉折叠过程Agent 被调用后的三个动作探索仓库建立词汇。没看过代码就先看一遍spec 全程使用项目的领域词汇尊重所触及区域内的 ADR。卡住就它用的名词和你的代码库对不上回查 CONTEXT.md 是不是过期了。先勾勒测试缝seam。优先复用已存在的 seam取能取到的最高层理想情况下整个变更只要一个。列出来会先跟你确认再动笔。这步不能快进因为 seam 会传导下游tdd 技能只在预先商定的 seam 上写测试Test only at pre-agreed seamscode-review 会拿 diff 对照 spec 审查没人同意过的 seam 会直接变成 review 发现。卡住就seam 数量降不下来时别让它新建把测试点往公开接口上推。按模板写 spec、发布、打标签。七个小节填满作为单条 issue 发布打上ready-for-agent。卡住就发布失败或标签没打上回去检查 tracker 配置是否完整。发布之后你要做的三件事只读两个地方seam 部分和 Out of Scope 小节。错误决策在这两处被抓住最便宜事后发现最贵。通读全文没有摘要模式也别指望有。紧接着在同一窗口跑/to-tickets中间不要清空clearing或压缩compaction上下文。原因见下一节的第 5 条。如果你跑着轮询式 AFK Agent先处理标签问题同样是下一节第 1 条。文档不会主动告诉你的事 ⚠️这些不是 bug 报告多半是设计取舍。但文档不会专门点名所以这里点名。标签被当工单现象是 AFK Agent 轮询到ready-for-agent的 spec试图一口气构建整个 spec而不是捡 ticket 切片。根因是标签语义为无需再分诊属于输入标记而非工作指令而 Agent 看不见这个区别。规避在 AFK Agent 提示词里显式排除父级 spec或在/to-tickets跑完后剥掉该标签。spec 在实现当天就开始过时现象是实现教会你第一件事时spec 已经错了。根因是没有任何机制让它同步它本质是你当时所知的快照。规避交付后把 spec 当一次性物品实现中学到、值得留存的结论写进 CONTEXT.md 或 ADR别去改 spec 本身。用户故事模板装不下重构现象是围绕接口与不变量的决策被硬写出没人要的故事。根因是模板的形状为功能特性设计架构类工作是错的形状属于已知局限。规避倚重 Implementation Decisions 与 Testing Decisions 两节持久性的架构决策通过 grill-with-docs 落成 ADR。悄悄重复别人的工作现象是 spec 和追踪器里已存在的相关 issue 撞车。根因是它起草前不搜索追踪器读 ADR 也不做链接。规避该区域活跃时自己先搜一遍追踪器再跑/to-spec。下游读不回大 spec现象是/to-tickets反复截断本地没有副本兜底。根因是 spec 超出了 issue 正文能干净回读的容量。规避两个命令之间不做任何上下文清理同一个窗口连着跑spec 就根本不需要被重新拉取。决策其实没做现象是 spec 里断言了一句你从没说过的话。根因是它不采访你grilling追问决策不够深时综合只能靠补。规避spec 让你意外时说明是追问太浅回去补决策而不是硬验收。把 to-spec 放回整条构建链 决策grill-with-docs做出决策→ 沉淀to-spec记录决策→ 切片to-tickets切成垂直票→ 构建implement在 seam 上开发→ 审查code-review对照 spec 查 diffwayfinder 跑完的地图也在沉淀这一节点并入喂的是地图主 issue 而不是零散决策票不确定用哪个技能时ask-matt 负责路由。第一次用就先跑/setup-matt-pocock-skills零依赖场景选本地 Markdown 追踪器。单会话任务走 grilling 加/implement就够了to-spec 只给跨多会话的工作付账。下次长会话收尾时直接/to-spec然后在同一窗口接/to-tickets——这就是这套技能给出的标准答案。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
