1. setup-matt-pocock-skills 技能

教会代码仓库如何让工程类技能正确运作的一次性设置工具

快速开始

npx skills add mattpocock/skills --skill=setup-matt-pocock-skills
npx skills update setup-matt-pocock-skills

源代码

功能说明

setup-matt-pocock-skills 教会一个代码仓库如何让工程类技能在其内部正确运作——包括问题(issue)存放在哪里、分类标签叫什么名字、领域文档放在什么位置——并将这些答案记录为配置,供其他技能读取。

它写入的是配置,而不是硬编码行为。工程链假设 docs/agents/ 目录下存在三个文件;这个技能就是一次性引导工具,负责从你的实际代码仓库中(通过 git remote、现有标签、现有 CONTEXT.md)发现这些信息,并经你确认后生成这些文件,而不是凭空猜测。它由提示驱动——先探索、展示发现、确认、再写入——而非确定性的脚手架工具。

何时使用

你通过输入 /setup-matt-pocock-skills 来调用它——智能体不会主动使用它。

在每个代码仓库中,在使用任何其他工程类技能之前,使用一次即可。如果 triageto-specto-tickets 开始猜测你的问题存放在哪里,或者应用不存在的标签,说明它们还没有在此处完成设置。只有在需要切换问题追踪器或重新开始时才重新运行它——日常的微调只需要编辑 docs/agents/*.md 即可。

三项决策

每一项都会先给出一个建议答案,你可以一键接受,并且会跳过所有已经能推断出的内容——所以大多数运行只需要几次快速确认:

  • 问题追踪器——工作在哪里被追踪,这样 triage/to-spec/to-tickets 就知道是调用 ghglab、在 .scratch/ 下写入 markdown,还是遵循你描述的工作流。支持 GitHub、GitLab、本地 markdown 或其他。(它会根据你的 git remote 提出匹配的方案。)
  • 分类标签——只有在 triage 技能已安装时才会询问,而且只问一句:保留默认标签(needs-triageneeds-infoready-for-agentready-for-humanwontfix)吗?只有当你的追踪器已经使用了其他名称时才说不,这样 triage 会应用真实的标签而不会创建重复项。
  • 领域文档——默认假定为单上下文(根目录下有一个 CONTEXT.md + docs/adr/),这适用于几乎所有的代码仓库;只有在检测到 monorepo 信号时,它才会提出多上下文映射的配置。

输出是在 docs/agents/ 下生成一组文件——issue-tracker.mddomain.md,以及当 triage 已安装时的 triage-labels.md——并在代码仓库已使用的 CLAUDE.mdAGENTS.md 中添加一个指向这些文件的 ## Agent skills 区块。这些文件是整个工具包所依赖的共享基础。

成功的标志

  • issue-tracker.mddomain.md 出现在 docs/agents/ 下(以及当 triage 已安装时的 triage-labels.md),并且 ## Agent skills 章节出现在你的 CLAUDE.mdAGENTS.md 中。
  • 它提出的追踪器与你的真实 git remote 匹配,标签与你代码仓库中已有的字符串匹配。
  • 之后,triageto-tickets 会在正确的位置使用正确的标签进行操作,而不再需要询问或猜测。

在整个流程中的位置

setup-matt-pocock-skills一次性设置——是整个工程技能集的基础,而不是需要重复执行的步骤。与之相邻的技能是那些读取它所写入内容的技能:triage,因为它应用这里配置的标签词汇;以及 to-specto-tickets,因为它们将内容发布到此处配置的问题追踪器中。首先运行它;所有下游技能都假设它已经运行过了。当你不确定哪个技能或流程适合时,可以找 ask-matt 帮你导航。

标签:LLMSkillsAI编程