用途
ask-matt 是一个技能路由工具,用于回答“当前情境适合使用哪个技能或流程”。它建立在 sickn33/agentic-awesome-skills 仓库中一组用户调用技能之上,帮助用户在多条技能路径中选对起点。资料说明该技能源自 mattpocock/skills,采用 MIT 许可。
主要能力
资料把仓库中的技能组织成一条主流程、两条入口和若干独立技能:
主流程:idea → ship。大多数工作沿此路线进行。有代码库时从 /grill-with-docs 开始,通过访谈打磨想法;它是状态化的,会把习得内容保存在 CONTEXT.md 和 ADR 中。没有代码库则用 /grill-me。
当某个问题需要在对话中无法解决、必须有可运行答案(状态、业务逻辑、需要实际看到的 UI)时,分支到 /prototype,用一次性代码回答该问题,并通过 /handoff 双向衔接:先 /handoff out,再针对该文件开新会话,最后 /handoff back 把学到的东西带回原始想法线程。
当属于多会话构建时,走 /to-prd(把线程转成 PRD)→ /to-issues(把 PRD 拆成可独立领取的 issue)。由于 issue 相互独立,每个 issue 之间清空上下文:为每个 issue 开新会话,传入 PRD 和该单个 issue,再启动 /implement。若非多会话构建,则直接在同一上下文窗口内运行 /implement。
入口(on-ramps):Bug 和需求堆积时用 /triage,它让 issue 流转过 triage 角色并产出 agent-ready 的 issue,之后由 /implement 接手。资料特别说明 triage 只用于非你创建的 issue(缺陷报告、外部功能请求等原始内容);由 /to-issues 产出的 issue 已是 agent-ready,不需要 triage。
代码库健康:/improve-codebase-architecture,随时可用来保持代码库适合 agent 操作,它给出加深改造的机会点,选定一个即可生成想法,带入主流程的 /grill-with-docs。
独立技能:/grill-me(与 /grill-with-docs 同样严格的访谈,但没有代码库、无状态、不保存本地内容、不建 CONTEXT.md,适合打磨不存在于仓库中的计划或设计)、/teach(用当前目录作为状态化工作区,跨多次会话学习概念)、/writing-great-skills(编写和编辑技能时的参考)。
使用方式
资料给出一个示例调用形式:User request 中使用 @ask-matt,任务描述为“Ask which skill or flow fits your situation.”。
前置条件:在第一次工程流程前运行 /setup-matt-pocock-skills,以配置其他技能所假设的 issue 追踪器、triage 标签和文档布局。资料也说明自定义的 issue 追踪器同样可用。
适用场景
适合在进入具体工程工作前,先确定应使用哪个技能或流程;适合在有代码库、无代码库、多会话构建、issue 堆积、代码库维护等不同情境下选择入口。
上下文管理说明
资料提出上下文卫生:步骤 1–3 应保持在一个不中断的上下文窗口中,直到 /to-issues 之后再压缩或清空,这样打磨、PRD 和 issue 都建立在同一思考之上;每次 /implement 则从 issue 出发、以全新会话开始。
并说明“智能区间”限制:模型仍能敏锐推理的窗口约为 120k token(面向当时最先进的模型)。若会话在 /to-issues 之前接近该上限,不要勉强在退化状态下推进,而应 /handoff 到新线程继续。
/handoff 与 /compact 的区别:/handoff 在线程满了或需要分支时,把对话压缩成 markdown 文件,然后在新会话中引用该文件来跨上下文窗口传递,是双向的桥梁;/compact 是内置能力,留在同一对话内,让较早轮次被摘要,适合阶段之间的有意断点、不介意丢失逐字历史时使用,不要在阶段中途压缩。/handoff 是分叉,/compact 是延续。
限制
- 当工作流指定了上游工具、账号、API 密钥或本地环境时,需要具备这些条件。
- 未经用户明确批准,不授权破坏性、生产环境、付费或对外消息类操作。
- 生成产物或建议在视为最终结果前,应对照用户的真实来源进行验证。