询问 Matt

ask-matt

分类通用

作者Agentic Awesome Skills 社区

许可MIT

评分4.20/5

使用9.9K

Ask Matt

使用场景

当用户请求符合以下情况时使用：询问哪项技能或工作流适合当前情况。它是本仓库中用户调用技能的路由工具。

_来源：mattpocock/skills (MIT)。_

你不需要记住每项技能，直接询问即可。

工作流 (flow) 是穿梭于各项技能之间的路径。大多数路径沿着一条主流程 (main flow) 运行，并有两个入口 (on-ramps) 合并其中。其余均为独立技能。

主流程：从想法 $\rightarrow$ 发布 (idea $\rightarrow$ ship)

大多数工作的运行路径。当你有一个想法并希望将其实现时使用。

1. /grill-with-docs —— 通过访谈完善想法。当你已有代码库时从这里开始：它是状态化的，会在 CONTEXT.md 和 ADR 中记录学习到的内容。（没有代码库？请使用 /grill-me —— 见“独立技能”。）
2. 分支 —— 所有问题能否在对话中解决？ 如果某个问题需要可运行的答案（状态、业务逻辑、必须看到的 UI），请通过原型开发进行绕道，并使用 /handoff 在两个方向上进行衔接（见“跨会话”）：
- 使用 /handoff 移出，然后针对该文件开启一个新会话，
- 使用 /prototype 用临时代码回答问题，
- 使用 /handoff 将学习到的结果移回，并在原始想法线程中引用它。
3. 分支 —— 这是否是一个多会话构建任务？
- 是 $\rightarrow$ /to-prd（将线程转换为 PRD）$\rightarrow$ /to-issues（将 PRD 拆分为可独立处理的 issue）。由于 issue 是独立的，请在每个 issue 之间清除上下文：为每个 issue 开启新会话，并通过传递 PRD 和单个待处理 issue 来启动 /implement。
- 否 $\rightarrow$ 直接在当前的上下文窗口中使用 /implement。

上下文卫生 (Context hygiene)

请将步骤 1-3 保持在同一个连续的上下文窗口中 —— 在 /to-issues 之前不要压缩或清除 —— 这样访谈、PRD 和 issue 都能基于相同的思考过程。随后的每个 /implement 都会从 issue 开始全新启动。

此操作的限制是 智能区 (smart zone)：即模型仍能保持敏锐推理的窗口范围（顶尖模型约为 120k token）。如果会话在 /to-issues 之前接近该限制，不要在性能下降的情况下强行推进 —— 请使用 /handoff 并在新线程中继续。

入口 (On-ramps)

产生工作并随后合并到主流程的起始场景。

Bug 和需求堆积 $\rightarrow$ /triage。它将 issue 通过分诊角色进行处理，并生成可供 Agent 处理的 issue，随后由 /implement 接手。

分诊仅用于非你创建的 issue —— 如 Bug 报告、外部功能请求等原始输入。由 /to-issues 生成的 issue 已经是 Agent 就绪状态，因此无需再次分诊。

代码库健康

非功能开发 —— 而是维护工作。

/improve-codebase-architecture —— 每当你有一点空闲时间，可以用它来优化代码库，使其更适合 Agent 操作。它会挖掘潜在的优化机会；选择其中一项将*产生一个想法*，你可以将其带入主流程的 /grill-with-docs 阶段。

跨会话操作

/handoff — 当对话线程已满或需要分叉（例如进入 /prototype 会话）时，此命令会将对话压缩为 Markdown 文件。你不会在原处继续，而是开启新会话并引用该文件以传递上下文。它是上下文窗口之间的双向桥梁。当你需要全新会话但又需要保留当前对话时请使用此命令。

/compact (内置) — 留在同一对话中，将之前的对话轮次进行总结。请在阶段之间有意识的停顿时使用，此时你不在意丢失逐字历史记录。不要在阶段中间进行压缩，否则 Agent 可能会迷失方向。/handoff 是分叉，/compact 是延续。

独立功能

完全脱离主流程。

/grill-me — 与 /grill-with-docs 一样进行严苛的面试，但适用于没有代码库的情况。无状态：不保存任何本地内容，不构建 CONTEXT.md。用于磨练任何不在代码仓库中的计划或设计。

/teach — 通过多个会话学习某个概念，将当前目录作为有状态的工作区。

/writing-great-skills — 优秀的写作与编辑技巧参考。

前置条件

/setup-matt-pocock-skills — 在开始首次工程流程前运行，以配置其他技能所依赖的问题追踪器 (issue tracker)、分拣标签 (triage labels) 和文档布局。自定义问题追踪器同样适用。

局限性

当工作流指定了上游工具、账户、API 密钥或本地设置时，需要相应配置。

未经用户明确批准，不会授权执行破坏性、生产环境、付费或发送外部消息的操作。

在将生成的产出或建议视为最终结果前，请对照用户的实际源文件进行验证。