[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75488":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":14,"starSnapshotCount":14,"syncStatus":28,"lastSyncTime":29,"discoverSource":30},75488,"mattpocock-skills-zh-CN","vinvcn\u002Fmattpocock-skills-zh-CN","vinvcn","这是 mattpocock\u002Fskills 的简体中文本地化版本。",null,"JavaScript",518,58,56,0,61,103,461,183,9.31,"MIT License",false,"main",true,[],"2026-06-12 02:03:34","# Matt Pocock Agent Skills 中文版\n\n## 为什么需要这个中文版？\n\n- 更好适配中文大语言模型\n- 方便中文母语开发者\n- 方便接入中文开发流程\n\n## 原版技能包括\n\n给 Claude Code \u002F Codex \u002F AI coding agents 用的工程化工作流。\n\n不是 prompt 合集，不是 vibe coding。它帮你在真实项目里做：\n\n- 需求澄清：[`\u002Fgrill-with-docs`](.\u002Fskills\u002Fengineering\u002Fgrill-with-docs\u002FSKILL.md)\n- TDD 闭环：[`\u002Ftdd`](.\u002Fskills\u002Fengineering\u002Ftdd\u002FSKILL.md)\n- Bug 诊断：[`\u002Fdiagnose`](.\u002Fskills\u002Fengineering\u002Fdiagnose\u002FSKILL.md)\n- PRD 与 issue 拆分：[`\u002Fto-prd`](.\u002Fskills\u002Fengineering\u002Fto-prd\u002FSKILL.md)、[`\u002Fto-issues`](.\u002Fskills\u002Fengineering\u002Fto-issues\u002FSKILL.md)\n- 架构改善：[`\u002Fimprove-codebase-architecture`](.\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md)\n\n## 30 秒安装\n\n```bash\nnpx skills@latest add vinvcn\u002Fmattpocock-skills-zh-CN\n```\n\n选择你想安装的 skills，以及要安装到哪些 coding agents。首次安装时请确保选择 [`\u002Fsetup-matt-pocock-skills`](.\u002Fskills\u002Fengineering\u002Fsetup-matt-pocock-skills\u002FSKILL.md)，然后在 agent 中运行它来完成 issue tracker、labels 和 docs 目录配置。\n\n[![skills.sh](https:\u002F\u002Fskills.sh\u002Fb\u002Fvinvcn\u002Fmattpocock-skills-zh-CN)](https:\u002F\u002Fskills.sh\u002Fvinvcn\u002Fmattpocock-skills-zh-CN)\n\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fwww.aihero.dev\u002Fs\u002Fskills-newsletter\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fres.cloudinary.com\u002Ftotal-typescript\u002Fimage\u002Fupload\u002Fv1777382277\u002Fskills-repo-dark_2x.png\">\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fres.cloudinary.com\u002Ftotal-typescript\u002Fimage\u002Fupload\u002Fv1777382277\u002Fskill-repo-light_2x.png\">\n      \u003Cimg alt=\"Skills\" src=\"https:\u002F\u002Fres.cloudinary.com\u002Ftotal-typescript\u002Fimage\u002Fupload\u002Fv1777382277\u002Fskill-repo-light_2x.png\" width=\"369\">\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## 关于这个中文版\n\n这是 [`mattpocock\u002Fskills`](https:\u002F\u002Fgithub.com\u002Fmattpocock\u002Fskills) 的简体中文本地化版本。文档和技能说明已翻译；目录名、技能名、命令、代码块、路径和工具标识保持不变，以免破坏安装和运行行为。\n\n中文版本不只是为了阅读方便。对中文母语用户来说，中文说明能减少概念转换成本；对以中文为主要交互语言或中文语料优化的模型来说，中文 prompt 和 skill instructions 也更容易贴合中文上下文，减少中英混杂带来的歧义。\n\n本仓库按内容刷新方式同步上游，不同步上游 Git 历史或仓库管理状态。维护规则见 [`.skills\u002Ftranslate-skill\u002FSKILL.md`](.\u002F.skills\u002Ftranslate-skill\u002FSKILL.md)。\n\n本仓库的最近一次同步翻译由 OpenAI Codex（GPT-5 coding agent）执行，并由仓库维护者通过提交记录纳入 `main`。翻译策略是 **skill-guided content localization**：把上游 `mattpocock\u002Fskills` 当作英文内容来源，只翻译自然语言说明，保留目录名、skill name、frontmatter key、命令、代码块、路径、URL、package\u002Ftool\u002FAPI identifiers 和行为关键 labels。用户可见的安装路径统一保持为 `vinvcn\u002Fmattpocock-skills-zh-CN`。\n\nskills.sh 的排行榜基于 CLI 的匿名安装遥测；因此这些页面适合作为实时热度参考，数字以页面显示为准。\n\n使用与热度参考：\n\n- 中文版 skills.sh 页面：[`vinvcn\u002Fmattpocock-skills-zh-CN`](https:\u002F\u002Fskills.sh\u002Fvinvcn\u002Fmattpocock-skills-zh-CN)\n- 上游 skills.sh 页面：[`mattpocock\u002Fskills`](https:\u002F\u002Fskills.sh\u002Fmattpocock\u002Fskills)\n- skills.sh 总榜与排行榜：[skills.sh](https:\u002F\u002Fskills.sh\u002F)\n- skills.sh 安装与 registry 说明：[skills.sh docs](https:\u002F\u002Fskills.sh\u002Fdocs)\n- 上游 newsletter 社区入口：[AI Hero Skills Newsletter](https:\u002F\u002Fwww.aihero.dev\u002Fs\u002Fskills-newsletter)\n\n## 发布记录与验证\n\n### 发布记录\n\n- 2026-05-15：同步上游 `mattpocock\u002Fskills@e74f006`，本地提交 `c323a74`。收紧 `CONTEXT.md` glossary 边界，并更新 `prototype` 的设计细化表述。\n- 2026-05-11：同步上游 `mattpocock\u002Fskills@9f2e0bd`，本地提交 `210cbac`。将 `handoff` 提升到 productivity，新增 `review` 草稿，并更新 writing skills。\n- 2026-05-09：同步上游 `mattpocock\u002Fskills@733d312`，本地提交 `c9fe120`。新增 `prototype` 与 `in-progress` 内容的中文翻译，并更新公开 skill 索引。\n\n### 最新 main 验证\n\n针对 `mattpocock\u002Fskills@e74f006` 的同步结果：\n\n- [x] `node scripts\u002Fcheck-translation.mjs` 通过。\n- [x] 公开 skill 索引一致：`engineering\u002F`、`productivity\u002F`、`misc\u002F` 已同步到顶层 README 和 `.claude-plugin\u002Fplugin.json`，`personal\u002F`、`in-progress\u002F`、`deprecated\u002F` 未进入 plugin。\n- [x] 上游 in-scope 文件完整：没有缺失上游文件，也没有 stale translated upstream files。\n- [x] 60 个共同 Markdown 文件的保护性检查通过：frontmatter `name` 未漂移，frontmatter key 未缺失，fenced code blocks 平衡。\n- [x] `git diff --check` 和 `git diff --cached --check` 通过。\n- [x] README 同步记录指向最新上游 `e74f006`，并记录本地同步提交 `c323a74`。\n- [x] 行为关键扫描未发现旧安装路径或旧 skill 路径，例如旧的 `vinvcn` 短仓库路径、已移除的 triage skill 名、已移除的 domain-model 相对路径等。\n- [!] `node scripts\u002Faudit-english.mjs` 仍会列出大量英文内容；这些主要是保留的 identifiers、命令、示例、触发词和工程术语，作为人工复核队列，不作为阻塞项。\n\n## 原版 README 翻译\n\n我每天用于真实工程工作的 agent skills，不是 vibe coding。\n\n开发真实应用很难。GSD、BMAD、Spec-Kit 这类方法试图通过接管流程来帮你。但它们在接管流程的同时，也拿走了你的控制权，并让流程里的 bug 更难解决。\n\n这些 skills 被设计得小、易改、可组合。它们适用于任何模型，背后是数十年的工程经验。你可以 hack 它们，让它们变成自己的东西。\n\n如果你想跟进这些 skills 的更新，以及我后续创建的新 skill，可以加入大约 60,000 名开发者订阅的 newsletter：\n\n[订阅 Newsletter](https:\u002F\u002Fwww.aihero.dev\u002Fs\u002Fskills-newsletter)\n\n### Quickstart（30 秒 setup）\n\n1. 运行 skills.sh installer：\n\n```bash\nnpx skills@latest add vinvcn\u002Fmattpocock-skills-zh-CN\n```\n\n2. 选择你想安装的 skills，以及要安装到哪些 coding agents。**确保选择 `\u002Fsetup-matt-pocock-skills`**。\n\n3. 在你的 agent 中运行 `\u002Fsetup-matt-pocock-skills`。它会：\n   - 询问你要使用哪个 issue tracker（GitHub、Linear 或 local files）\n   - 询问你 triage issues 时使用哪些 labels（`\u002Ftriage` 会使用这些 labels）\n   - 询问要把创建的 docs 保存到哪里\n\n4. 完成后即可开始使用。\n\n### 为什么这些 Skills 存在\n\n我创建这些 skills，是为了解决我在 Claude Code、Codex 和其他 coding agents 中反复看到的常见失败模式。\n\n#### #1: Agent 没有做我想要的东西\n\n> \"No-one knows exactly what they want\"\n>\n> David Thomas & Andrew Hunt, [The Pragmatic Programmer](https:\u002F\u002Fwww.amazon.co.uk\u002FPragmatic-Programmer-Anniversary-Journey-Mastery\u002Fdp\u002FB0833F1T3V)\n\n**问题**：软件开发中最常见的失败模式是 misalignment。你以为开发者理解了你想要什么；等看到做出来的东西，才发现对方完全没理解。\n\nAI 时代也是一样。你和 agent 之间存在沟通缺口。修复方式是一次 **grilling session**，让 agent 针对你要构建的东西提出详细问题。\n\n**解决方式**是使用：\n\n- [`\u002Fgrill-me`](.\u002Fskills\u002Fproductivity\u002Fgrill-me\u002FSKILL.md) — 用于非代码场景\n- [`\u002Fgrill-with-docs`](.\u002Fskills\u002Fengineering\u002Fgrill-with-docs\u002FSKILL.md) — 与 [`\u002Fgrill-me`](.\u002Fskills\u002Fproductivity\u002Fgrill-me\u002FSKILL.md) 类似，但会加入更多文档能力（见下文）\n\n这些是我最常用的 skills。它们帮助你在开始前和 agent 对齐，并深入思考你要做的变更。每次想做变更时都值得使用。\n\n#### #2: Agent 太啰嗦\n\n> With a ubiquitous language, conversations among developers and expressions of the code are all derived from the same domain model.\n>\n> Eric Evans, [Domain-Driven-Design](https:\u002F\u002Fwww.amazon.co.uk\u002FDomain-Driven-Design-Tackling-Complexity-Software\u002Fdp\u002F0321125215)\n\n**问题**：项目开始时，开发者和真正使用软件的人（domain experts）通常说着不同语言。\n\n我在 agents 身上也感受到同样张力。Agents 往往被丢进一个项目，然后被要求边做边弄懂术语。于是它们用 20 个词解释本来 1 个词就够的东西。\n\n**解决方式**是 shared language。它是一份帮助 agents 解码项目术语的文档。\n\n\u003Cdetails>\n\u003Csummary>\n示例\n\u003C\u002Fsummary>\n\n这是我 `course-video-manager` repo 中的一个 [`CONTEXT.md`](https:\u002F\u002Fgithub.com\u002Fmattpocock\u002Fcourse-video-manager\u002Fblob\u002F076a5a7a182db0fe1e62971dd7a68bcadf010f1c\u002FCONTEXT.md) 示例。哪一个更容易读？\n\n- **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)\"\n- **AFTER**: \"There's a problem with the materialization cascade\"\n\n这种简洁性会在一次又一次 session 中持续回报。\n\n\u003C\u002Fdetails>\n\n这已经内置在 [`\u002Fgrill-with-docs`](.\u002Fskills\u002Fengineering\u002Fgrill-with-docs\u002FSKILL.md) 中。它是一场 grilling session，同时帮助你和 AI 建立 shared language，并把难解释的决策记录到 ADR 中。\n\n很难解释这件事有多强。它可能是这个 repo 里最酷的技术之一。试试看就知道。\n\n> [!TIP]\n> Shared language 除了减少啰嗦，还有很多其他好处：\n>\n> - **变量、函数和文件命名更一致**，因为都使用 shared language\n> - 因此 **agent 更容易浏览 codebase**\n> - Agent 也会 **花更少 tokens 思考**，因为它能使用更简洁的语言\n\n#### #3: 代码跑不起来\n\n> \"Always take small, deliberate steps. The rate of feedback is your speed limit. Never take on a task that’s too big.\"\n>\n> David Thomas & Andrew Hunt, [The Pragmatic Programmer](https:\u002F\u002Fwww.amazon.co.uk\u002FPragmatic-Programmer-Anniversary-Journey-Mastery\u002Fdp\u002FB0833F1T3V)\n\n**问题**：假设你和 agent 已经对要构建什么达成一致。那如果 agent 仍然产出一堆不能用的东西呢？\n\n这时要看你的 feedback loops。没有对生成代码真实运行情况的反馈，agent 就是在盲飞。\n\n**解决方式**：你需要常规的一组 feedback loops：static types、browser access 和 automated tests。\n\n对 automated tests 来说，red-green-refactor 循环非常关键。Agent 先写一个失败测试，再修到测试通过。这能给 agent 稳定反馈，最终得到更好的代码。\n\n我做了一个可以放进任何项目的 **[`\u002Ftdd`](.\u002Fskills\u002Fengineering\u002Ftdd\u002FSKILL.md) skill**。它鼓励 red-green-refactor，并给 agent 足够多关于好测试和坏测试的指导。\n\n调试方面，我也做了一个 **[`\u002Fdiagnose`](.\u002Fskills\u002Fengineering\u002Fdiagnose\u002FSKILL.md)** skill，把最佳调试实践包装成一个简单循环。\n\n#### #4: 我们做出了 Ball Of Mud\n\n> \"Invest in the design of the system _every day_.\"\n>\n> Kent Beck, [Extreme Programming Explained](https:\u002F\u002Fwww.amazon.co.uk\u002FExtreme-Programming-Explained-Embrace-Change\u002Fdp\u002F0321278658)\n\n> \"The best modules are deep. They allow a lot of functionality to be accessed through a simple interface.\"\n>\n> John Ousterhout, [A Philosophy Of Software Design](https:\u002F\u002Fwww.amazon.co.uk\u002FPhilosophy-Software-Design-2nd\u002Fdp\u002F173210221X)\n\n**问题**：大多数用 agents 构建的应用都复杂且难以修改。因为 agents 能极大加速编码，它们也会以空前速度加速软件熵增。Codebase 会变得越来越复杂。\n\n**解决方式**是 AI-powered development 的一种新办法：关心代码设计。\n\n这些 skills 的每一层都内置了这种思路：\n\n- [`\u002Fto-prd`](.\u002Fskills\u002Fengineering\u002Fto-prd\u002FSKILL.md) 会在创建 PRD 前追问你要触碰哪些 modules\n- [`\u002Fzoom-out`](.\u002Fskills\u002Fengineering\u002Fzoom-out\u002FSKILL.md) 会要求 agent 从整个系统的上下文解释代码\n\n更重要的是，[`\u002Fimprove-codebase-architecture`](.\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md) 能帮助你拯救已经变成 ball of mud 的 codebase。我建议每隔几天就在你的 codebase 上跑一次。\n\n#### Summary\n\n软件工程基本功比以往任何时候都更重要。这些 skills 是我把这些基本功压缩成可重复实践的一次尝试，目标是帮你交付职业生涯中最好的应用。\n\n### Reference\n\n#### Engineering\n\n我每天用于代码工作的 skills。\n\n- **[diagnose](.\u002Fskills\u002Fengineering\u002Fdiagnose\u002FSKILL.md)** — 面向棘手 bug 和性能回退的纪律化诊断循环：reproduce → minimise → hypothesise → instrument → fix → regression-test。\n- **[grill-with-docs](.\u002Fskills\u002Fengineering\u002Fgrill-with-docs\u002FSKILL.md)** — 对照现有 domain model 挑战你的计划，收紧术语，并在决策成形时内联更新 `CONTEXT.md` 和 ADR。\n- **[triage](.\u002Fskills\u002Fengineering\u002Ftriage\u002FSKILL.md)** — 通过 triage roles state machine 分诊 issues。\n- **[improve-codebase-architecture](.\u002Fskills\u002Fengineering\u002Fimprove-codebase-architecture\u002FSKILL.md)** — 根据 `CONTEXT.md` 中的 domain language 和 `docs\u002Fadr\u002F` 中的决策，发现 codebase 中可以 deepen 的机会。\n- **[setup-matt-pocock-skills](.\u002Fskills\u002Fengineering\u002Fsetup-matt-pocock-skills\u002FSKILL.md)** — 搭建其他 engineering skills 会消费的每仓库配置：issue tracker、triage label vocabulary 和 domain doc layout。首次使用 `to-issues`、`to-prd`、`triage`、`diagnose`、`tdd`、`improve-codebase-architecture` 或 `zoom-out` 前运行一次。\n- **[tdd](.\u002Fskills\u002Fengineering\u002Ftdd\u002FSKILL.md)** — 使用 red-green-refactor 循环做 test-driven development。一次一个 vertical slice 地构建功能或修 bug。\n- **[to-issues](.\u002Fskills\u002Fengineering\u002Fto-issues\u002FSKILL.md)** — 使用 vertical slices，把任意计划、spec 或 PRD 拆成可独立领取的 issue tracker issues。\n- **[to-prd](.\u002Fskills\u002Fengineering\u002Fto-prd\u002FSKILL.md)** — 将当前对话上下文整理成 PRD，并发布到项目 issue tracker。不做访谈，只综合已经讨论过的内容。\n- **[zoom-out](.\u002Fskills\u002Fengineering\u002Fzoom-out\u002FSKILL.md)** — 让 agent zoom out，对不熟悉的代码区域给出更广的上下文或更高层视角。\n- **[prototype](.\u002Fskills\u002Fengineering\u002Fprototype\u002FSKILL.md)** — 在承诺方案前构建 throwaway prototype 来细化设计：可以是用于 state\u002Fbusiness-logic 问题的可运行终端 app，也可以是在同一路由上切换的多种 UI 变体。\n\n#### Productivity\n\n通用工作流工具，不限于代码。\n\n- **[caveman](.\u002Fskills\u002Fproductivity\u002Fcaveman\u002FSKILL.md)** — 超压缩沟通模式。去掉废话但保留完整技术准确性，token 使用量约减少 75%。\n- **[grill-me](.\u002Fskills\u002Fproductivity\u002Fgrill-me\u002FSKILL.md)** — 围绕计划或设计持续追问，直到决策树的每个分支都被解决。\n- **[handoff](.\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md)** — 将当前对话压缩成 handoff document，让另一个 agent 可以继续工作。\n- **[write-a-skill](.\u002Fskills\u002Fproductivity\u002Fwrite-a-skill\u002FSKILL.md)** — 用正确结构、progressive disclosure 和 bundled resources 创建新的 skills。\n\n#### Misc\n\n我保留但很少使用的工具。\n\n- **[git-guardrails-claude-code](.\u002Fskills\u002Fmisc\u002Fgit-guardrails-claude-code\u002FSKILL.md)** — 设置 Claude Code hooks，在危险 git 命令（push、reset --hard、clean 等）执行前阻止它们。\n- **[migrate-to-shoehorn](.\u002Fskills\u002Fmisc\u002Fmigrate-to-shoehorn\u002FSKILL.md)** — 将测试文件中的 `as` 类型断言迁移到 @total-typescript\u002Fshoehorn。\n- **[scaffold-exercises](.\u002Fskills\u002Fmisc\u002Fscaffold-exercises\u002FSKILL.md)** — 创建包含 sections、problems、solutions 和 explainers 的练习目录结构。\n- **[setup-pre-commit](.\u002Fskills\u002Fmisc\u002Fsetup-pre-commit\u002FSKILL.md)** — 设置 Husky pre-commit hooks，集成 lint-staged、Prettier、type checking 和 tests。\n","这个项目是 mattpocock\u002Fskills 的简体中文本地化版本，旨在为中文开发者提供更适合的工程化工作流工具。其核心功能包括需求澄清、TDD 闭环、Bug 诊断、PRD 与 issue 拆分以及架构改善等，专为 Claude Code、Codex 和其他 AI 编码代理设计。通过这些技能，开发者可以在真实项目中高效完成各种任务。项目采用 JavaScript 开发，并遵循 MIT 许可协议。适合需要在中文环境中进行开发工作的团队和个人使用，能够有效降低语言转换成本，提高工作效率。",2,"2026-06-11 03:52:56","CREATED_QUERY"]