setup-matt-pocock-skillslisted
Install: claude install-skill shumingyang-opencode/mattpocock-skills-zh-tw
# 設定 Matt Pocock 的技能
為工程技能假設的每個 repo 設定建立骨架:
- **Issue 追蹤器**——issue 放在哪裡(預設 GitHub;本機 markdown 也開箱即支援)
- **分���標籤**——五個標準分診角色使用的字串
- **領域文件**——`CONTEXT.md` 與 ADR 放在哪裡,以及讀取它們的消費規則
這是一個提示驅動的技能,不是確定性腳本。探索、呈現你所發現的、與使用者確認,然後寫入。
## 流程
### 1. 探索
檢視目前 repo,理解它的起點狀態。讀任何存在的東西;不要臆測:
- `git remote -v` 與 `.git/config`——這是 GitHub repo 嗎?哪一個?
- repo 根目錄的 `AGENTS.md` 與 `CLAUDE.md`——兩者存在嗎?其中一個是否已經有 `## Agent skills` 章節?
- repo 根目錄的 `CONTEXT.md` 與 `CONTEXT-MAP.md`
- `docs/adr/` 與任何 `src/*/docs/adr/` 目錄
- `docs/agents/`——這個技能先前的輸出是否已經存在?
- `.scratch/`——顯示本機 markdown issue 追蹤器慣例已在使用的跡象
- `triage` 技能有安裝嗎?(旁邊的 `triage` 技能資料夾,或在你可用的技能中。)這決定 B 章節要不要跑。
- Monorepo 訊號——`pnpm-workspace.yaml`、`package.json` 中的 `workspaces` 欄位,或有自己 `src/` 的 `packages/*`。只有在真正的大型多套件 repo 中才呈現;它們不存在代表單一上下文,而幾乎每個 repo 都是。
### 2. 呈現發現並詢問
總結有哪些、缺哪些。然後依序處理各章節——一個章節、一個答案,然後下一章節。
每個章節都以建議答案領頭,讓使用者一個字就能接受。只有當選擇真的分歧時才給一行說明;探索已經定案時直接跳過該章節(`triage` 未安裝時跳過 B 章節、沒有 monorepo 時跳過 C 章節)。
**A 章節——Issue 追蹤器。**
> 說明:「issue 追蹤器」是這個 repo 的 issue 所在之處。`to-tickets`、`triage` 與 `to-spec` 等技能會讀寫它——它們需要知道該呼叫 `gh issue create`、在 `.scratch/` 下寫 markdown 檔案,還是遵循你描述的其他工作流程。選一個你實際用來追蹤這個 repo 工作的場所。
預設姿態:這些技能是為 GitHub 設計的。如果 `git remote` 指向 GitHub,提出 GitHub。如果 `git remote` 指向 GitLab(`gitlab.com` 或自架的 host),提出 GitLab。否則(或使用者偏好時),提供:
- **GitHub**——issue 存在 repo 的 GitHub Issues(使用 `gh` CLI)
- **GitLab**——issue 存在 repo 的 GitLab Issues(使用 [`glab`](https://gitlab.com/gitlab-org/cli) CLI)
- **本機 markdown**——issue 以 `.scratch/<feature>/` 下的檔案形式存在於此