mattpocock-skills-zh-cn

这是 mattpocock/skills 的简体中文本地化版本，为 Claude Code、Codex 等 coding agents 提供一组作者日常真实工程工作使用的 agent skills，强调小而可改、可组合，而非接管整个开发流程的方法论框架。 本地化动机与策略： - 中文说明对中文母语开发者可减少概念转换成本；对以中文交互或中文语料优化的模型，中文 prompt 更贴合中文上下文，减少中英混杂带来的歧义。 - 翻译采用 skill-guided content localization：只翻译自然语言说明，保留目录名、skill name、frontmatter key、命令、代码块、路径、URL、包/工具/API 标识等，以免破坏安装与运行行为。 - 仓库按内容刷新方式同步上游，不同步上游 Git 历史或仓库管理状态；最近一次同步翻译由 Claude（Anthropic）执行并经维护者通过 PR 合入 main，维护规则记录在 .skills/translate-skill/SKILL.md。 安装方式（三选一，勿重复安装）： 1. skills.sh 安装器：运行 npx skills@latest add vinvcn/mattpocock-skills-zh-CN，选择要安装的 skills 与目标 coding agents。该方式会把 skills 复制进项目，便于修改和定制。 2. Claude Code 插件：运行 /plugin marketplace add vinvcn/mattpocock-skills-zh-CN 与 /plugin install mattpocock-skills@mattpocock，以受管理的只读 bundle 安装，随新版本统一更新，适合只想直接使用并跟进更新的用户。 3. DeepSeek Harness（dsh）：以 dsh plugin --profile web add @vinvcn/dsh-mattpocock-skills-zh 安装为插件，安装后以 /zh- 加技能名的方式调用，例如 /zh-grilling。 首次安装需选择 /setup-matt-pocock-skills 并在 agent 中运行一次，用于配置 issue tracker（GitHub、Linear 或本地文件）、triage 使用的 labels 以及 docs 保存位置。 设计理念：作者针对 coding agents 的常见失败模式设计了对应技能： - 需求错位：通过 grilling session（/grill-me、/grill-with-docs）让 agent 在动手前详细追问，对齐意图。 - 表述啰嗦：通过 shared language 文档（CONTEXT.md）帮助 agent 解码项目术语，使命名更一致、浏览代码更容易、思考更省 token。 - 代码跑不起来：强调 feedback loops（静态类型、浏览器访问、自动化测试），/tdd 推动 red-green-refactor 循环，/diagnosing-bugs 提供纪律化、逐阶段把关的调试循环。 - 架构腐化：/to-spec 在写 spec 前追问准备改动哪些模块；/improve-codebase-architecture 扫描 codebase 中的 deepening opportunities 并生成可视化 HTML 报告，定位为定期 survey 而非 rescue。 技能按“谁能调用”分为两类：user-invoked（需用户输入名称触发，负责编排，可调用 model-invoked 技能但不能调用另一个 user-invoked 技能）与 model-invoked（可被用户调用，也可在任务匹配时由 agent 自动触发，承载可复用纪律）。 Engineering（工程类）： - User-invoked：ask-matt（本仓库技能路由）、grill-with-docs（追问式访谈并维护 CONTEXT.md 与 ADR）、triage（以 triage roles 状态机推进 issue）、improve-codebase-architecture、setup-matt-pocock-skills、to-spec（把对话整理成 spec 并发布到 issue tracker）、to-tickets（把计划拆成带阻塞关系的 tracer-bullet tickets）、wayfinder（把大块工作规划成 issue tracker 上的 decision tickets 共享地图）、implement（按 spec/ticket 实现，在约定 seams 驱动 /tdd 并以 /code-review 收尾）。 - Model-invoked：prototype（构建一次性原型，可产出单文件 HTML 或多个 UI 变体）、diagnosing-bugs、research（对照高可信一手来源调研并保存带引用的 Markdown）、tdd、domain-modeling、codebase-design（deep modules 设计纪律与词汇）、code-review（Standards 与 Spec 双轴、并行子代理评审）、resolving-merge-conflicts（逐 hunk 解决冲突并追溯各方意图，不使用 --abort）、wizard（生成交互式 bash 向导，引导人工完成基础设施配置、credentials、CI secrets、一次性迁移等步骤）。 Productivity（通用工作流，不限于代码）： - User-invoked：grill-me、handoff（把对话压缩成交接文档）、teach（以当前目录为有状态教学工作区跨会话教学）、to-questionnaire（把决策变成 Markdown 问卷交由能回答的人填写）、wait-what（补全缺失上下文并用平实语言重述消息）。 - Model-invoked：grilling（可复用访谈原语，支撑 grill-me、grill-with-docs、triage、wayfinder、improve-codebase-architecture）、writing-for-agents（为 agents 编写文档，如 AGENTS.md/CLAUDE.md）。 Misc（本地保留但少用）：git-guardrails-claude-code（用 hooks 在 push、reset --hard、clean 等危险 git 命令执行前拦截）、migrate-to-shoehorn（把测试文件中的 as 类型断言迁移到 @total-typescript/shoehorn）、scaffold-exercises（生成含 sections、problems、solutions、explainers 的练习目录）、setup-pre-commit（配置 Husky pre-commit hooks，集成 lint-staged、Prettier、类型检查与测试）。