mattpocock-skills-zh-CN README

The project's README from github.com/vinvcn/mattpocock-skills-zh-CN. As one markdown file: README.md.

Matt Pocock Agent Skills 中文版

为什么需要这个中文版?

关于这个中文版

这是 mattpocock/skills 的简体中文本地化版本。文档和技能说明已翻译;目录名、技能名、命令、代码块、路径和工具标识保持不变,以免破坏安装和运行行为。

中文版本不只是为了阅读方便。对中文母语用户来说,中文说明能减少概念转换成本;对以中文为主要交互语言或中文语料优化的模型来说,中文 prompt 和 skill instructions 也更容易贴合中文上下文,减少中英混杂带来的歧义。

本仓库按内容刷新方式同步上游,不同步上游 Git 历史或仓库管理状态。维护规则见 .skills/translate-skill/SKILL.md。

本仓库的最近一次同步翻译由 Claude(Anthropic)执行,并由仓库维护者通过 PR 纳入 main。翻译策略是 skill-guided content localization:把上游 mattpocock/skills 当作英文内容来源,只翻译自然语言说明,保留目录名、skill name、frontmatter key、命令、代码块、路径、URL、package/tool/API identifiers 和行为关键 labels。用户可见的安装路径统一保持为 vinvcn/mattpocock-skills-zh-CN。

30 秒安装

npx skills@latest add vinvcn/mattpocock-skills-zh-CN

选择你想安装的 skills,以及要安装到哪些 coding agents。首次安装时请确保选择 /setup-matt-pocock-skills,然后在 agent 中运行它来完成 issue tracker、labels 和 docs 目录配置。

或者在 Claude Code 中运行:

/plugin marketplace add vinvcn/mattpocock-skills-zh-CN
/plugin install mattpocock-skills@mattpocock

skills.sh

Skills

原版 README 翻译

我每天用于真实工程工作的 agent skills,不是 vibe coding。

开发真实应用很难。GSD、BMAD、Spec-Kit 这类方法试图通过接管流程来帮你。但它们在接管流程的同时,也拿走了你的控制权,并让流程里的 bug 更难解决。

这些 skills 被设计得小、易改、可组合。它们适用于任何模型,背后是数十年的工程经验。你可以 hack 它们,让它们变成自己的东西。

如果你想跟进这些 skills 的更新,以及我后续创建的新 skill,可以加入大约 60,000 名开发者订阅的 newsletter:

订阅 Newsletter

Quickstart(30 秒 setup)

  1. 运行 skills.sh installer:
npx skills@latest add vinvcn/mattpocock-skills-zh-CN
  1. 选择你想安装的 skills,以及要安装到哪些 coding agents。确保选择 /setup-matt-pocock-skills。

  2. 在你的 agent 中运行 /setup-matt-pocock-skills。它会:

    • 询问你要使用哪个 issue tracker(GitHub、Linear 或 local files)
    • 询问你 triage issues 时使用哪些 labels(/triage 会使用这些 labels)
    • 询问要把创建的 docs 保存到哪里
  3. 完成后即可开始使用。

作为 Claude Code plugin 安装

如果你更喜欢无需手动维护的即装即用方式,这些 skills 也以原生 Claude Code plugin 发布。与把可编辑文件复制进 repo 不同,plugin 会把整套 skills 安装为受管理的 bundle;新版本发布后可以统一更新。

在 Claude Code 中运行:

/plugin marketplace add vinvcn/mattpocock-skills-zh-CN
/plugin install mattpocock-skills@mattpocock

或在 shell 中运行:

claude plugin marketplace add vinvcn/mattpocock-skills-zh-CN
claude plugin install mattpocock-skills@mattpocock

然后像上面的 quickstart 一样,在每个 repo 中运行一次 /setup-matt-pocock-skills。

两种安装方式代表两种使用取向,只选其一——两个都装会让每个 skill 被安装两次:

使用 Codex 或其他 agent?skills.sh installer 已经可以把这些 skills 安装到 Codex 和其他兼容 Agent Skills 的 harnesses;目前尚未提供原生 Codex plugin。

为什么这些 Skills 存在

我创建这些 skills,是为了解决我在 Claude Code、Codex 和其他 coding agents 中反复看到的常见失败模式。

#1: Agent 没有做我想要的东西

"No-one knows exactly what they want"

David Thomas & Andrew Hunt, The Pragmatic Programmer

问题:软件开发中最常见的失败模式是 misalignment。你以为开发者理解了你想要什么;等看到做出来的东西,才发现对方完全没理解。

AI 时代也是一样。你和 agent 之间存在沟通缺口。修复方式是一次 grilling session,让 agent 针对你要构建的东西提出详细问题。

解决方式是使用:

这些是我最常用的 skills。它们帮助你在开始前和 agent 对齐,并深入思考你要做的变更。每次想做变更时都值得使用。

#2: Agent 太啰嗦

With a ubiquitous language, conversations among developers and expressions of the code are all derived from the same domain model.

Eric Evans, Domain-Driven-Design

问题:项目开始时,开发者和真正使用软件的人(domain experts)通常说着不同语言。

我在 agents 身上也感受到同样张力。Agents 往往被丢进一个项目,然后被要求边做边弄懂术语。于是它们用 20 个词解释本来 1 个词就够的东西。

解决方式是 shared language。它是一份帮助 agents 解码项目术语的文档。

示例

这是我 course-video-manager repo 中的一个 CONTEXT.md 示例。哪一个更容易读?

  • BEFORE: "There's a problem when a lesson inside a section of a course is made 'real' (i.e. given a spot in the file system)"
  • AFTER: "There's a problem with the materialization cascade"

这种简洁性会在一次又一次 session 中持续回报。

这已经内置在 /grill-with-docs 中。它是一场 grilling session,同时帮助你和 AI 建立 shared language,并把难解释的决策记录到 ADR 中。

很难解释这件事有多强。它可能是这个 repo 里最酷的技术之一。试试看就知道。

[!TIP] Shared language 除了减少啰嗦,还有很多其他好处:

  • 变量、函数和文件命名更一致,因为都使用 shared language
  • 因此 agent 更容易浏览 codebase
  • Agent 也会 花更少 tokens 思考,因为它能使用更简洁的语言

#3: 代码跑不起来

"Always take small, deliberate steps. The rate of feedback is your speed limit. Never take on a task that’s too big."

David Thomas & Andrew Hunt, The Pragmatic Programmer

问题:假设你和 agent 已经对要构建什么达成一致。那如果 agent 仍然产出一堆不能用的东西呢?

这时要看你的 feedback loops。没有对生成代码真实运行情况的反馈,agent 就是在盲飞。

解决方式:你需要常规的一组 feedback loops:static types、browser access 和 automated tests。

对 automated tests 来说,red-green-refactor 循环非常关键。Agent 先写一个失败测试,再修到测试通过。这能给 agent 稳定反馈,最终得到更好的代码。

我做了一个可以放进任何项目的 /tdd skill。它鼓励 red-green-refactor,并给 agent 足够多关于好测试和坏测试的指导。

调试方面,我也做了一个 /diagnosing-bugs skill,把最佳调试实践包装成一个纪律化、逐阶段把关的循环。

#4: 我们做出了 Ball Of Mud

"Invest in the design of the system every day."

Kent Beck, Extreme Programming Explained

"The best modules are deep. They allow a lot of functionality to be accessed through a simple interface."

John Ousterhout, A Philosophy Of Software Design

问题:大多数用 agents 构建的应用都复杂且难以修改。因为 agents 能极大加速编码,它们也会以空前速度加速软件熵增。Codebase 会变得越来越复杂。

解决方式是 AI-powered development 的一种新办法:关心代码设计。

这些 skills 的每一层都内置了这种思路:

更重要的是,/improve-codebase-architecture 会扫描 codebase 中的 deepening opportunities,把候选项交到你手上。我建议每隔几天就在你的 codebase 上跑一次。它是一次 survey,不是 rescue:在一个真正老旧的 codebase 上它能找出真实的候选项,但不会替你把 mud 解开。

Summary

软件工程基本功比以往任何时候都更重要。这些 skills 是我把这些基本功压缩成可重复实践的一次尝试,目标是帮你交付职业生涯中最好的应用。

Reference

这些 skills 按一个维度区分:谁能调用它们。User-invoked skills 只有在你输入名称时才能触达(例如 /grill-me);它们的工作是编排。Model-invoked skills 可以由你调用,也可以在任务匹配时由 agent 自动触达;它们承载可复用纪律。User-invoked skill 可以调用 model-invoked skills,但不能调用另一个 user-invoked skill。

Engineering

我每天用于代码工作的 skills。

User-invoked

Model-invoked

Productivity

通用工作流工具,不限于代码。

User-invoked

Model-invoked

Misc

本地保留但很少使用的工具。

User-invoked

Model-invoked

mattpocock-skills-zh-CN (vinvcn/mattpocock-skills-zh-CN)

Searching Database…

What is this?This is a Simplified Chinese localization of mattpocock/skills, a collection of Agent Skills for coding agents like Claude Code and Codex that help with software engineering practices (TDD, code review, spec writing, architecture review, etc).
Is this a rewritten toolset or just a translation?It is a faithful translation: natural-language docs and skill instructions were translated into Chinese, but directory names, skill names, commands, code blocks, paths and tool identifiers were kept unchanged so installation and runtime behavior aren't broken.
How do I install these skills?Run the skills.sh installer, pick which skills to install and which coding agents to target (be sure to also select /setup-matt-pocock-skills), then run /setup-matt-pocock-skills inside your agent to configure the issue tracker, triage labels and docs location.
Which coding agents can I use these skills with?The skills.sh installer supports Claude Code, Codex, and other harnesses compatible with the Agent Skills format; Claude Code additionally has a native plugin installation path, but there is no native Codex plugin yet.
Does this repo stay in sync with the upstream project?It syncs by refreshing content from upstream mattpocock/skills, not by mirroring upstream's Git history or repository management state, and the latest translation pass was done by Claude and merged by the maintainer via PR.
Who benefits most from the Chinese version?Chinese-native developers get lower concept-conversion overhead, and models optimized for Chinese interaction or Chinese-heavy training data fit the localized prompts and skill instructions more naturally, avoiding mixed-language ambiguity.
What is the difference between installing via skills.sh and via the Claude Code plugin?skills.sh copies editable skill files into your project so you can tweak and own them, while the plugin installs a managed read-only bundle that updates automatically with new releases. The README warns against installing both, since each skill would end up duplicated.
What kinds of skills are included?Engineering skills like grill-with-docs, triage, tdd, code-review and implement for day-to-day coding work; Productivity skills like grill-me, handoff and teach for general workflows; and a small Misc set of rarely-used tools such as git-guardrails-claude-code.
What problems were these skills designed to fix?They target four recurring agent failure modes: agents misunderstanding what you actually want, agents being overly verbose, agents producing code that doesn't run, and codebases degrading into unmanageable 'balls of mud' as agents speed up development.
Is this an official Matt Pocock project?No — it is a community-maintained localization repository that tracks the original mattpocock/skills content and translates it into Simplified Chinese, keeping all functional identifiers untouched.
Creator
vinvcn
Size
1 MB
Stars
5K
Age
5mo
Commits · 90 Days