From mattpocock-skills
Sets up Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ configuring issue tracker (GitHub/GitLab/local markdown), triage labels, and domain docs layout for skills like triage, to-issues, diagnose.
npx claudepluginhub vinvcn/mattpocock-skills-zh-cnThis skill uses the workspace's default tool permissions.
搭建 engineering skills 依赖的每仓库配置:
Sets up Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ configuring issue tracker (GitHub/GitLab/local markdown), triage labels, and domain docs layout. Run before triage, to-issues, tdd, etc.
Injects compressed SKILL-MAP and AGENT-MAP directives into CLAUDE.md to persist skill names and agent IDs across sessions, invoked when modifying CLAUDE.md, adding skills/agents, or on phrases like 'update skill map'.
Guides interview-based setup of GitHub as command center for AI-agent project management, creating projects, labels, CLAUDE.md config, and canonical files.
Share bugs, ideas, or general feedback.
搭建 engineering skills 依赖的每仓库配置:
CONTEXT.md 和 ADRs 的位置,以及读取它们的消费规则这是 prompt-driven skill,不是确定性脚本。先探索,展示发现,和用户确认,然后再写入。
查看当前 repo,理解起始状态。读取已有内容,不要假设:
git remote -v 和 .git/config — 这是 GitHub repo 吗?是哪一个?AGENTS.md 和 CLAUDE.md — 是否存在?其中是否已经有 ## Agent skills section?CONTEXT.md 和 CONTEXT-MAP.mddocs/adr/ 以及任何 src/*/docs/adr/ 目录docs/agents/ — 这个 skill 之前是否已经输出过内容?.scratch/ — 表明已经在使用 local-markdown issue tracker 约定总结现有什么、缺什么。然后带用户逐一完成三个决策:每次只展示一个 section,拿到用户回答后再进入下一个。不要一次性倾倒全部三个。
假设用户不知道这些术语是什么意思。每个 section 先用简短说明开头(它是什么、为什么这些 skills 需要它、选择不同选项会改变什么),然后展示选项和默认值。
Section A — Issue tracker.
Explainer: “issue tracker” 是这个 repo 存放 issues 的地方。
to-issues、triage、to-prd和qa等 skills 会从中读取并写入;它们需要知道是调用gh issue create、在.scratch/下写 markdown 文件,还是遵循你描述的其他工作流。请选择你实际用来跟踪这个 repo 工作的位置。
默认姿态:这些 skills 是为 GitHub 设计的。如果 git remote 指向 GitHub,就推荐 GitHub。如果 git remote 指向 GitLab(gitlab.com 或 self-hosted host),就推荐 GitLab。否则(或用户偏好),提供:
gh CLI)glab CLI).scratch/<feature>/ 下(适合个人项目或没有 remote 的 repos)Section B — Triage label vocabulary.
Explainer:
triageskill 处理 incoming issue 时,会把它移过一个 state machine:需要评估、等待 reporter、已准备好给 AFK agent 接手、需要人工实现,或 won't fix。为此,它需要应用与你实际配置相匹配的 labels(或 issue tracker 中的等价物)。如果你的 repo 已经使用不同 label 名(例如bug:triage而不是needs-triage),在这里映射它们,避免 skill 创建重复 labels。
五个 canonical roles:
needs-triage — maintainer needs to evaluateneeds-info — waiting on reporterready-for-agent — fully specified, AFK-ready (an agent can pick it up with no human context)ready-for-human — needs human implementationwontfix — will not be actioned默认:每个 role 的字符串等于它的名称。询问用户是否想覆盖任何项。如果他们的 issue tracker 还没有现有 labels,默认值即可。
Section C — Domain docs.
Explainer: 一些 skills(
improve-codebase-architecture、diagnose、tdd)会读取CONTEXT.md来学习项目的 domain language,并读取docs/adr/来了解过去的架构决策。它们需要知道 repo 是一个 global context,还是多个 contexts(例如 frontend/backend 分离的 monorepo),这样才能看对位置。
确认布局:
CONTEXT.md + docs/adr/。大多数 repos 是这样。CONTEXT-MAP.md 指向每个 context 的 CONTEXT.md 文件(通常是 monorepo)。向用户展示草稿:
CLAUDE.md / AGENTS.md 中的 ## Agent skills block(选择规则见 step 4)docs/agents/issue-tracker.md、docs/agents/triage-labels.md、docs/agents/domain.md 的内容允许用户在写入前修改。
选择要编辑的文件:
CLAUDE.md 存在,编辑它。AGENTS.md 存在,编辑它。当 CLAUDE.md 已经存在时,绝不创建 AGENTS.md(反之亦然);始终编辑已经存在的那个。
如果所选文件已经有 ## Agent skills block,就原地更新其内容,而不是追加重复 block。不要覆盖周围 section 的用户编辑。
Block:
## Agent skills
### Issue tracker
[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.
### Triage labels
[one-line summary of the label vocabulary]. See `docs/agents/triage-labels.md`.
### Domain docs
[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.
然后使用这个 skill 文件夹中的 seed templates 作为起点,写入三个 docs files:
对于 “other” issue trackers,根据用户描述从头写 docs/agents/issue-tracker.md。
告诉用户 setup 已完成,以及哪些 engineering skills 现在会读取这些文件。说明他们之后可以直接编辑 docs/agents/*.md;只有当他们想切换 issue trackers 或从头开始时,才需要重新运行此 skill。