# Setup Matt Pocock Skills

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

- Repository: https://github.com/vinvcn/mattpocock-skills-zh-CN (5461 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add vinvcn/mattpocock-skills-zh-CN --skill setup-matt-pocock-skills -g -a claude-code -y`
Codex: `npx skills add vinvcn/mattpocock-skills-zh-CN --skill setup-matt-pocock-skills -g -a codex -y`
Cursor: `npx skills add vinvcn/mattpocock-skills-zh-CN --skill setup-matt-pocock-skills -g -a cursor -y`
Gemini CLI: `npx skills add vinvcn/mattpocock-skills-zh-CN --skill setup-matt-pocock-skills -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add vinvcn/mattpocock-skills-zh-CN`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 配置 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。否则（或用户偏好），提供：

The rest: https://github.com/vinvcn/mattpocock-skills-zh-CN/blob/HEAD/skills/engineering/setup-matt-pocock-skills/SKILL.md