Skills

Setup Matt Pocock Skills

为此仓库配置 engineering skills:设置其 issue tracker、triage labels 词汇与 domain docs 布局。在首次使用其他...

Install

npx skills add vinvcn/mattpocock-skills-zh-CN --skill setup-matt-pocock-skills -g -a claude-code -y
Category
Engineering
Updated
7d ago
License
MIT
Context cost
Lightabout 1,199 tokens
Runs scripts
No, instructions only

What it does

为此仓库配置 engineering skills:设置其 issue tracker、triage labels 词汇与 domain docs 布局。在首次使用其他 engineering skills 前运行一次。

配置 Matt Pocock 的 Skills

搭建 engineering skills 所假定的每仓库配置:

  • Issue tracker - issues 存放在哪里(默认 GitHub;也原生支持 local markdown)
  • Triage labels - 五个 canonical triage roles 使用的字符串
  • Domain docs - GLOSSARY.md 与 ADRs 的位置,以及读取它们的 consumer rules

这是 prompt-driven skill,不是确定性脚本。先探索,展示发现,与用户确认,然后写入。

流程

1. 探索

查看当前 repo,理解起始状态。读取已有内容,不要假设:

  • git remote -v 和 .git/config - 这是 GitHub repo 吗?是哪一个?
  • repo root 的 AGENTS.md 和 CLAUDE.md - 是否存在?其中是否已有 ## Agent skills section?
  • repo root 的 GLOSSARY.md 和 GLOSSARY-MAP.md,以及 legacy 的 CONTEXT.md / CONTEXT-MAP.md。如果存在 legacy 文件,提议用 git mv 把它改名为对应的 GLOSSARY 名称,并改写 docs/agents/domain.md 中的这些名称。
  • docs/adr/ 以及任何 src/*/docs/adr/ directories
  • docs/agents/ - 这个 skill 之前是否已经输出过内容?
  • .scratch/ - 表明已经在使用 local-markdown issue tracker 约定
  • 是否已安装 triage skill(本 skill 旁边有 triage folder,或 available skills 中存在 triage)?这决定 Section B 是否运行。
  • Monorepo signals:pnpm-workspace.yaml、package.json 的 workspaces field,或已有内容且各自带 src/ 的 packages/*。只有真正的大型 multi-package repo 才算;没有这些 signal 就是 single-context,几乎所有 repo 都如此。

2. 呈现发现并询问

总结已有内容和缺失内容。按顺序处理 sections:每次一个 section、一个回答,再进入下一个。

每个 section 都先给 recommended answer,让用户一个词就能接受。只有 choice 真正分叉时才给一行 explainer;exploration 已经确定答案时跳过整个 section(未安装 triage 时跳过 Section B;没有 monorepo 时跳过 Section C)。

Section A - Issue tracker.

Explainer: "issue tracker" 是这个 repo 存放 issues 的地方。to-tickets、triage 和 to-spec 等 skills 会从中读取并写入;它们需要知道是调用 gh issue create、在 .scratch/ 下写 markdown 文件,还是遵循你描述的其他工作流。请选择你实际用于跟踪这个 repo 工作的位置。

默认姿态:这些 skills 是为 GitHub 设计的。如果 git remote 指向 GitHub,推荐 GitHub。如果 git remote 指向 GitLab(gitlab.com 或 self-hosted host),推荐 GitLab。否则(或用户偏好),提供:

Read the whole SKILL.md on GitHub

More in Engineering