一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | setup-matt-pocock-skills（Matt Pocock Skills 合集内子技能） | GitHub API |
| 作者/维护者 | Matt Pocock（个人开发者，TypeScript 教育者，“Total TypeScript”作者） | GitHub API |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/engineering/setup-matt-pocock-skills | 用户提供 |
| 许可证 | MIT（仓库级，LICENSE 文件已核实） |
GitHub API |
| 所属合集仓库 Stars / Forks | 228,813 / 19,571（该数字属整个 52 技能合集，不代表本技能自身热度） | GitHub API |
| 本技能自身热度 | skills.sh 第三方技能市场单列该技能安装量 675,800 次，为该合集内已核实数字最高者之一 | skills.sh（实测抓取） |
| 最新版本 | 无独立版本号；随仓库持续发版（仓库整体 package.json 版本 1.2.3），本技能最近一次改动随仓库 2026-08-21 提交同步 | GitHub API |
| 安装方式 | 见第十章 | 仓库根 README |
二、功能介绍与亮点
setup-matt-pocock-skills 是 Matt Pocock 工程技能族的官方指定第一步——README 安装说明第 2 步就是“运行 /setup-matt-pocock-skills”，且通用安装器的提示语明确写着“务必把 setup-matt-pocock-skills 也选上”。它把工程技能族运行所需的三项仓库级约定一次性问清楚并落地：
- Issue 跟踪方式：GitHub Issues（用
ghCLI）、GitLab Issues（用glabCLI）、仓库内本地 Markdown（.scratch/<feature>/），或自由描述的其他工作流，写入docs/agents/issue-tracker.md - 分诊标签词表：五个标准分诊角色（
needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix）默认直接采用，也支持把仓库已有标签名映射进来，避免重复建标签 - 领域文档布局：单仓库默认写一份
CONTEXT.md+docs/adr/；侦测到 monorepo 信号（pnpm-workspace.yaml、workspaces字段等）才提供多上下文的CONTEXT-MAP.md方案
设计上有两处克制：一是先探测、后提问——工具会先读 git remote、CLAUDE.md/AGENTS.md、既有 .scratch/ 等现状，问题只问在探测无法自动确定的地方；二是写入前必须过目确认——把要写入 CLAUDE.md/AGENTS.md 的 ## Agent skills 区块和三份 docs/agents/*.md 草稿先展示给用户，允许修改后才落盘，且若该区块已存在则原地更新而不是重复追加。
三、适用场景
所属分类：元技能与 Agent 增强
适合已经在仓库里安装了 Matt Pocock 工程技能族中至少一个成员（如 tdd、triage、to-tickets、to-spec、domain-modeling 等）、需要为这些技能补上它们共同依赖的仓库级配置的 Claude Code / Codex 用户；也适合刚接触这套技能族、准备批量引入并希望一次性把 issue 跟踪、分诊标签、领域文档三件事定下来的团队或个人维护者。运行一次即可覆盖同仓库内该技能族此后的所有调用，重复运行仅用于切换 issue 跟踪方式或推倒重来。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 已收录进官方插件市场清单 .claude-plugin/plugin.json，claude plugins install mattpocock-skills 或会话内 /plugin install mattpocock-skills 一条命令即可获取 |
| Codex | ✅ 支持（经通用安装器） | 仓库 README 专列 “Codex, and other agents” 安装区块，指引使用 npx skills@latest add mattpocock/skills 安装；该安装器（vercel-labs/skills）官方文档确认原生支持 Codex。仓库自身注明“原生 Codex 插件格式在路上”，目前走通用安装器 |
| OpenClaw | ❓ 未验证 | 仓库 README 与通用安装器文档均未点名提及该平台，未找到可核实的证据 |
| Hermes Agent | ❓ 未验证 | 同上，未找到可核实的证据 |
五、推荐理由
这是一个“看似基础设施、实则决定后续体验”的技能：Matt Pocock 工程技能族里的 tdd、triage、to-tickets、to-spec、domain-modeling 等成员，运作时都假设 issue 跟踪方式、分诊标签、领域文档位置已经谈妥——没有这一步，那些技能要么反复追问同样的配置问题，要么行为不一致。setup-matt-pocock-skills 把这件事标准化成一次性、可复核的对话，写入前给用户看草稿、不覆盖已有内容，是同类“仓库初始化”工具里少见的谨慎设计。它同时被官方收进插件市场清单，一条命令即可获取，安装摩擦极低。
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 所属合集为 GitHub 历史最高星标仓库之一（22.8 万星，多个独立第三方趋势站交叉验证），但合集星数不计入单个子技能；本技能自身在第三方技能市场的独立安装量达 67.5 万次，为同批技能中最高，且是官方安装文档中唯一被点名“务必选上”的技能 |
| 可用性 | 9 | 已进入官方插件市场清单，一条命令安装；流程分探测、提问、确认、写入四步，逻辑清晰且写入前必须过目确认；所属仓库 2026-08-21 仍有提交，维护活跃 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 仅读取 git remote -v、.git/config 等本地信息；写入操作限于 docs/agents/*.md 与 CLAUDE.md/AGENTS.md 内一个约定区块，且写入前展示草稿供用户确认 |
| ② 联网外发 | 无数据外发；若用户选择 GitHub/GitLab 作为 issue 跟踪方式，仅调用本机已授权的 gh/glab CLI，不额外联网取数 |
| ③ 凭据处理 | 不索取、不存储任何新增凭据；gh/glab 的鉴权沿用用户本机既有配置 |
| ④ 可疑指令 | 完整通读 SKILL.md 全文，未发现提示词注入或夹带无关推广内容 |
| ⑤ 作者信誉 | Matt Pocock 为知名 TypeScript 教育者（“Total TypeScript”创始人），仓库星标增长经 star-history.com、trendshift.io 等独立第三方站点交叉验证为自然增长，无刷量迹象 |
| ⑥ License | MIT，条款清晰 |
| ⑦ 最近维护 | 仓库 2026-08-21 仍有提交，活跃维护中 |
| 补充：第三方自动化审计 | skills.sh 第三方市场展示三项自动化安全审计：Gen Agent Trust Hub Pass、Socket Pass、Snyk Warn（页面未展开具体触发原因） |
七、跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| claude-md-management（Anthropic 官方） | 审计并持续维护已有 CLAUDE.md 的内容质量与时效性 | 面向“文档写完后如何保鲜”，不涉及 issue 跟踪方式或分诊标签这类仓库级约定 |
| agents-md（Sentry 官方，CTO 维护） | 侦察仓库结构后从零生成一份 AGENTS.md/CLAUDE.md | 产出是文档本身；本技能产出的是三项具体配置决策 + 一个指向配置文件的摘要区块 |
| writing-for-agents（同合集） | 讲解如何为技能、AGENTS.md、CLAUDE.md 写出智能体能稳定执行的说明文档 | 是写作方法论，不做仓库配置；两者可搭配使用但解决的是不同问题 |
三者都在“让 agent 更懂这个仓库”这个大方向上发力，但分工不同：本技能解决的是 Matt Pocock 工程技能族特有的运行前置条件，其他三者要么管文档质量、要么管文档生成、要么管写作规范。
八、用户评价
该技能目前在第三方平台尚无具名用户评价；所属的 Matt Pocock Skills 合集本身有多篇具名作者的体验文章（如 Medium 作者 Aditya Kumar Puri、Devtalk 论坛用户 xiji2646-netizen），但内容集中在 /grill-with-docs、/tdd、/diagnosing-bugs 等其他成员技能，未点名评价本技能。
九、其他补充
本技能不支持多语言配置文本，写入的 docs/agents/*.md 内容为英文；仓库整体采用 changesets 管理版本迭代，欢迎社区通过 PR 贡献。
十、安装使用方式
Claude Code：
claude plugins install mattpocock-skills或在会话内执行：
/plugin install mattpocock-skills安装后在目标仓库内运行一次：
/setup-matt-pocock-skillsCodex 及其他 agent（通用安装器）：
npx skills@latest add mattpocock/skills安装器会让你勾选要安装的技能与目标 agent，请确保勾选 setup-matt-pocock-skills。
注意事项：该技能标记为仅可手动调用（不会被模型自动触发），需显式运行 /setup-matt-pocock-skills；同一仓库通常只需运行一次，之后可直接编辑 docs/agents/*.md 微调，仅在需要切换 issue 跟踪方式或推倒重来时才需再次运行。
十一、注意事项
- 单独安装本技能对未安装任何 Matt Pocock 工程技能族其他成员的用户价值有限——它写入的三份配置文件是给
to-tickets、triage、to-spec、domain-modeling等技能读取的，若不打算引入这些技能，配置本身不会被消费 - 选择 GitHub/GitLab 作为 issue 跟踪方式时依赖本机已安装并登录的
gh/glabCLI，未安装则该选项不可用 - 官方原生 Codex 插件包尚在开发中，当前 Codex 用户需经第三方通用安装器
npx skills安装