mattpocock-skills-zh

技能按 bucket 文件夹组织在 skills/ 下：

• engineering/：日常编码工作
• productivity/：日常非编码工作流工具
• misc/：保留但很少使用，不对外推广
• in-progress/：Beta：刻意公开、欢迎反馈、不随插件发布
• deprecated/：已不再使用

engineering/ 或 productivity/（已推广的 bucket）中的每个技能必须在顶层 README.md 中有一处引用，并在 .claude-plugin/plugin.json 的 skills 数组中有一项（Claude Code 插件只随附已推广的集合）。misc/、in-progress/ 和 deprecated/ 中的技能不得出现在两者之中。

README 的中文版安装命令必须逐字复制自 .agents/install-block.md。本仓库由 devcxl 维护，是 Matt Pocock 的 mattpocock/skills 项目的第三方简体中文汉化版；中文版命令必须指向 devcxl/mattpocock-skills-zh，提及英文上游时须明确标注，不得把上游命令用作中文版的默认安装命令。.claude-plugin/marketplace.json 定义本仓库自己的 marketplace，不属于 Anthropic 官方市场；Claude Code 中文版须从这里安装，并默认关闭自动更新。Codex、Copilot 和 VS Code 的上游 marketplace 路线及中文版适配见 ADR 0002 和安装说明，中文版路线尚未逐项实测。触碰任一清单文件后运行 claude plugin validate . --strict。上游插件安装方式变化及本仓库的适配记录见 .agents/adr/0002-ship-as-a-claude-code-plugin.md。

顶层 README.md 中的每个技能条目必须把技能名链接到它的 SKILL.md。

每个 bucket 文件夹有一份 README.md，用一句话描述列出该 bucket 中的每个技能，技能名链接到它的 SKILL.md。已推广 bucket 的 README.md 与顶层 README.md 把条目分成 User-invoked（用户调用）与 Model-invoked（模型调用）；非推广 bucket 的 README.md（misc/、in-progress/）使用扁平的列表。

engineering/ 与 productivity/ 中的技能还在 docs/<bucket>/<skill-name>.md 有一份面向人类的文档页（文档树镜像 skills/ 下的这两个 bucket 文件夹）。发布的 URL 是 https://aihero.dev/skills-<skill-name>，无论 bucket 如何：文档路径只是仓库组织形式。当你在 engineering/ 或 productivity/ 中新增、重命名或修改某个技能的行为时，按 .agents/writing-docs.md 创建或重新同步其文档页。一份完成的页面包含四个部分：它的作用、何时使用、常见问题、怎样算成功：writing-docs.md 给出模板、小节顺序以及去哪里找问题。非推广 bucket（misc/、in-progress/、deprecated/）中的技能没有文档页。唯一的例外是被整体移除的已推广技能：它的文档页保留，并以归档页方式标记（见 writing-docs.md）。

每份 SKILL.md 要么是用户调用型（disable-model-invocation: true 加上 agents/openai.yaml 中的 policy.allow_implicit_invocation: false，仅人类可达），要么是模型调用型（模型或用户均可达）。见 .agents/invocation.md。

ask-matt 是路由器，映射每一个用户可达的技能以及它们之间的关系。与重新同步文档页相同的触发条件适用于它：当你新增、重命名、移除一个用户可达技能，或修改它在流程中的位置时，重新读一遍 ask-matt 的 SKILL.md 并更新它，以保持地图准确：一个它从未提到的新技能，或一个它仍路由到的过时技能，都是在说谎的路由器。

要把所有 deprecated/ 和 misc/ 之外的技能（重新）链到本地 harness 技能目录（~/.claude/skills、~/.agents/skills），运行 scripts/link-skills.sh。每条都是一个指向本仓库的符号链接，所以 git pull 会保持已安装技能为最新；新增、移除或重命名技能后再次运行该脚本。

本仓库散文（SKILL.md 文件、文档、README.md、CHANGELOG.md、ADR、changeset、代码注释）中一律不出现 em-dash。某句话用到时，改写成逗号、冒号、句号、括号或连词中实际合适的那一个；切勿做盲目的字符替换。

每个会调度 subagent 的 skill 都会要求以全新的上下文窗口启动它。有些 harness（比如 Codex）默认会分叉父会话，而分叉会继承父会话的上下文，这恰恰是 subagent 本应摆脱的东西。

Agent skills

Triage 标签

规范名称保持不变。参见 docs/agents/triage-labels.md。根据 SCOPE.md 判断 issues。