agent-skills-zh

中文开发者的 Agent Skills 集合，也是我自己的日常工具箱。共 23 个 Skill，分三类：core 是我用得最勤、愿意背书推荐的核心工作流（13 个），extend 是核心之外的额外补充（8 个），personal 绑定我自己的环境（2 个）。推荐全部安装（core + extend 共 21 个）。每个 Skill 都得纠正一个 Agent 真实反复犯的毛病，否则不收录。

为什么这样收

Skill 集合越火，收录越多。但装进 Agent 目录的每个 Skill 都参与模型选择：越多越不准，职责重叠的还会互相抢调用。所以收录标准卡得很死（见下），整套仓库收敛到 23 个互不重叠的 Skill——这个体量全部安装也安全（自设上限：单个 Agent 宿主同时安装不超过 22 个），不需要再取舍。

这个项目做过 mattpocock/skills 的完整本地化，正经用了一段时间。我的结论：那套完整方法论（访谈 → 规格 → 工单 → 实现 → 审查）对跨会话的大项目有效，但对日常改动太重，几行的修改不该拉动整条流水线——所以 0.10.0 把它整体请出了仓库，跨会话接力由 handoff 承担。模型在变强，Skill 的价值也从「教模型怎么做」变成「在关键节点纠正它的特定倾向」。

收录标准只有三条：

1. 从 Agent 真实反复犯的失败出发，找到能纠正它的最小指令；
2. 保留证据和可观察的结果，删掉仪式；
3. 每个核心 Skill 能一句话说清它纠正哪个失败，说不出来的不进核心层。

核心工作流

| Skill | 什么时候用 | 你得到什么 | | --- | --- | --- | | ask-marvin | 不知道这批 Skill 里该用哪个 | 按任务类型和目标产物，推荐一条由多个 Skill 组成的执行顺序 | | grilling | 计划里还有几个真正需要你拍板的选择 | 按轮次问完当前能问的整批决策：用结构化提问工具逐轮问完并附推荐答案，事实由 Agent 自己查；收敛后输出摘要并确认去向 | | to-checklist | 方案已确认，要落成可执行、可接力的文档 | 分批、带 checkbox 的本地执行清单（.plans/，归 gitignore），实现时逐批勾选 | | implement | 需求和验收已经明确，可以写代码 | 按确认的范围实现，过程跑测试和类型检查，完成后审查提交 | | tdd | 要新增或修改可观察的行为 | 一次一个行为的红绿循环：先红、再绿、再重构 | | debug | 缺陷偶发、原因不明，或性能回退 | 先建立稳定暴露问题的信号，再用证据定位根因，不靠猜 | | code-review | 一批改动开发完了 | 规范与需求符合性的双轴检查 | | research | 需要查清官方 API、框架行为或工具限制 | 带来源的一手调研报告，存进仓库 | | prototype | 讨论说不清，需要实物验证 | 可运行的一次性原型，回答具体设计问题 | | frontend-craft | 要设计、实现、重构或审查生产级前端界面 | 先判定 surface mode 并输出 Design Read，按需加载深层规则，完成后跑有界验证循环 | | handoff | 会话太长，或要交给新会话继续 | 脱敏后的接力文档，新会话读取后续上 | | wrap-up | 工作要结束时 | 承诺的结果已验证、现场已清理、真实最终状态的报告 | | craft-skill | 要创建或改进一个 Skill | 用 Call / Steer / Earn 三约束审查：找对触发、引导到真正完成、每个 token 都挣得位置 |

典型的一天：

grilling（把决策问完）
  → to-checklist（大方案落盘成执行清单；小改动跳过）
  → implement + tdd（实现并逐行为验证）
  → debug（出问题：先复现，再修）
  → code-review（提交前审查）
  → wrap-up（收尾：验证承诺、清理现场）
跨会话时用 handoff 接力；research、prototype 按需随时插入

这些 Skill 大多是模型调用型：description 里写了触发场景，用日常语言说「排查一下」「收尾」就能命中，不用背命令。场景流程详见 docs/workflows.md。

extend 里还有 8 个额外 Skill：架构体检、深模块设计、工程护栏、合并冲突解决、交互向导、教学、即时重讲、Agent 文档写作；另有 2 个绑定我个人环境的 Skill 放在 personal。完整手册见 docs/skills-guide.md。

安装

需要 Node.js 20.11+：

npm install -g agent-skills-zh
agent-skills-zh

交互式选择平台、范围和安装模式：「全部安装」（core + extend 共 19 个，推荐）或「自定义安装」（逐个勾选，带一句话简介）。Claude Code 用户也可以直接装插件，内容同样是核心 12 个：

/plugin marketplace add iZiTTMarvin/agent-skills-zh
/plugin install agent-skills-zh@izittmarvin

支持 Claude Code、Codex、Cursor、OpenCode、Factory Droid 等 12 个平台。平台目录、完整参数、更新方式见 docs/installation.md。

来源与致谢

起源于 Matt Pocock 的 mattpocock/skills：多数稳定 Skill 以其 885e2ca 基线为底本完成行为级本地化，保留原始 MIT 版权声明（ATTRIBUTION.md）。上游更新经人工评估后决定吸收、调整或放弃，不会自动同步。

分层思路和取舍标准参考了 Astro Skills：Skill 的价值在于一条小指令能可靠地改变一个重要行为，而不在于说得更多。逐 Skill 的参考关系：wrap-up 的行为骨架受其同名 Skill 启发；grilling 的负例边界、歧义入树门槛与视觉决策指针参考其 shape；debug 的 description 借鉴其同名 Skill 的关键约束；craft-skill 以其同名 Skill 为底本完成本地化。to-checklist 的产物形态参考 Superpowers 的 writing-plans，改为本地 gitignore 文档、批次粒度与 checkbox 即进度，不做强制串联。

参与维护见 docs/development.md，版本记录见 CHANGELOG.md。

License

MIT