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…

Что это такое?Это локализация mattpocock/skills на упрощённый китайский — набор Agent Skills для кодинг-агентов вроде Claude Code и Codex, помогающих с практиками разработки ПО (TDD, ревью кода, написание спецификаций, ревью архитектуры и т.д.).
Это переписанный набор инструментов или просто перевод?Это точный перевод: документация на естественном языке и инструкции навыков переведены на китайский, но имена каталогов, названия навыков, команды, блоки кода, пути и идентификаторы инструментов оставлены без изменений, чтобы установка и поведение во время работы не сломались.
Как установить эти навыки?Запустите установщик skills.sh, выберите, какие навыки установить и для каких кодинг-агентов (обязательно отметьте и /setup-matt-pocock-skills), затем выполните /setup-matt-pocock-skills внутри вашего агента, чтобы настроить трекер задач, метки триажа и расположение документации.
С какими кодинг-агентами можно использовать эти навыки?Установщик skills.sh поддерживает Claude Code, Codex и другие оболочки, совместимые с форматом Agent Skills; у Claude Code дополнительно есть путь нативной установки плагина, а вот нативного плагина для Codex пока нет.
Этот репозиторий синхронизируется с исходным проектом?Он синхронизируется, обновляя контент из исходного mattpocock/skills, а не зеркалируя Git-историю или состояние управления репозиторием апстрима; последний проход перевода выполнил Claude, а мейнтейнер влил его через PR.
Кому больше всего полезна китайская версия?Разработчики, для которых китайский родной, получают меньшие накладные расходы на перевод концепций, а модели, оптимизированные под общение на китайском или обученные в основном на китайских данных, естественнее работают с локализованными промптами и инструкциями навыков, избегая двусмысленности смешанных языков.
В чём разница между установкой через skills.sh и через плагин Claude Code?skills.sh копирует редактируемые файлы навыков в ваш проект, так что вы можете их править и владеть ими, а плагин устанавливает управляемый read-only бандл, обновляющийся автоматически с новыми релизами. README предупреждает: не устанавливайте и то и другое, иначе каждый навык окажется продублирован.
Какие виды навыков входят?Инженерные навыки вроде grill-with-docs, triage, tdd, code-review и implement для повседневной работы с кодом; навыки продуктивности вроде grill-me, handoff и teach для общих сценариев; и небольшой набор Misc из редко используемых инструментов вроде git-guardrails-claude-code.
Какие проблемы были призваны решить эти навыки?Они нацелены на четыре повторяющихся режима сбоя агентов: агент неправильно понимает, чего вы на самом деле хотите; агент излишне многословен; агент выдаёт неработающий код; и кодовая база деградирует в неуправляемый «клубок грязи» по мере ускорения разработки агентами.
Это официальный проект Мэтта Пкока?Нет — это поддерживаемый сообществом репозиторий локализации, который следит за исходным контентом mattpocock/skills и переводит его на упрощённый китайский, оставляя нетронутыми все функциональные идентификаторы.
Creator
vinvcn
Size
1 MB
Stars
5K
Age
5mo
Commits · 90 Days