一句话定位：TypeScript 名师 Matt Pocock 把自己的.agents目录直接开源——
27 个"小、可组合、随便改"的工程技能，专治编码 Agent 的四种常见翻车。
一、核心档案
| 项 | 内容 |
|---|---|
| 仓库 | github.com/mattpocock/skills |
| 作者 | Matt Pocock（Total TypeScript / AI Hero 创始人，Newsletter 约 6 万订阅） |
| 安装 | Claude Code 插件 ｜ Codex 插件 ｜ 通用 npx skills@latest add mattpocock/skills |
| 首次配置 | 在 Agent 内跑 /setup-matt-pocock-skills（每仓库一次：选 issue tracker、triage 标签、文档目录） |
| 体量 | 187 个文件、约 8,900 行，几乎全是 Markdown |
| 安全扫描 | 无密钥、无可疑代码、无二进制、无安装脚本；仅 changelog 提到一个外部域名 |
它治的四种病
| # | 病症 | 药方 |
|---|---|---|
| 1 | Agent 做出来的不是我要的 | /grill-me、/grill-with-docs——让 Agent 反过来拷问你，把开放问题全部问死 |
| 2 | Agent 太啰嗦 | 共享语言机制：维护 GLOSSARY.md，把术语统一，token 消耗随之下降 |
| 3 | 代码跑不起来 | 红-绿-重构的 TDD 回路（先写失败测试）；静态类型、浏览器、自动化测试三件套 |
| 4 | 设计越堆越乱 | 从对话产出 spec → tickets；按 spec 与编码规范双向 review diff；扫描可简化点 |
设计哲学（官方原话大意）：GSD、BMAD、Spec-Kit 这类方法用"接管流程"来帮你，
代价是你失去了控制权，流程本身出 bug 还很难查。这些技能刻意做得小、易改、可组合，不绑定任何模型。
二、关键数据（快照 2026-10-11）
| 指标 | 数值 | 来源 |
|---|---|---|
| Stars | 281,876 | aibestskill |
| Stars 口径 | 280.8K / 282,596 | mrtechking ｜ Trending Today（三源一致，可信） |
| Forks | 23,618 | aibestskill / mrtechking |
| 周新增 | +9,897 ★/周 | aibestskill 扫描窗口 |
| 最近更新 | 2026-10-08 / 10-09 | mrtechking ｜ aibestskill |
28 万星是本库目前最高的项目，且三源数值高度一致——数据可信度较高。
三、真问题·硬伤 vs 建议
真问题 / 硬伤
- "星标 ≠ 质量"。它实质是一套 Markdown 指令集，28 万星里有大量是"收藏即学废"的被动星标。
必须自己通读再决定用哪几条，不能因为星多就整套装。
- 安装方式会重复：插件安装会自动更新；
npx skills是复制文件、需手动更新。
两种都装 = 每个技能出现两次（README 明示）。
- 生态绑定：最顺的路径是 Claude Code / Codex 插件体系，跨 Agent 的通用性有限。
git-guardrails-claude-code会改你的 Claude Code 设置（写入阻止git push、reset --hard的脚本）——
是安全特性，但属于"动你环境"的行为，需知情。
建议 / 观察
- 对 TextFlow 的直接借鉴价值高：
- "小、可组合、可改"的定位——正是老爷自研
feilu-writer/novel-checker的同类思路； - 共享语言（GLOSSARY.md） ——这条对 TextFlow 尤其值钱：本地 Ollama 模型窗口小，
统一术语能实打实降低 token 消耗、提升输出稳定性；
- "问死开放问题再动手"——可移植为写作前的大纲拷问节点。
- 可考虑把它当技能库结构范本，而非直接安装使用。
四、评分
| 维度 | 评分 | 说明 |
|---|---|---|
| 传播热度 | ⭐ 10/10 | 28 万星，本库最高，且增长稳定 |
| 工程完成度 | ⭐ 8/10 | 结构克制、可读性强、安全扫描干净；但本质是指令集 |
| 业务相关性 | ⭐ 7/10 | 不解决网文/漫剧本身，但对 TextFlow 技能体系有范式价值 |
| 收藏观察价值 | ⭐ 9/10 | "技能库该怎么组织"的最佳样本之一 |
综合均分 8.5 / 10
五、锚点清单
- 已验证：MIT 许可、Shell、187 文件约 8,900 行、27 个技能、
三种安装方式与"重复安装"警告、/setup-matt-pocock-skills 配置流程、
独立安全扫描结论（无风险）、三源星标一致
- 待核实：精确 Star（281,876 / 280.8K / 282,596，差异在正常波动范围内）
- 未表态 / 缺失：无（此项目信息披露相对充分）
六、给老爷的判断
不装，但一定要读。 它对老爷的用处不在"用"，在"看"——
共享语言（GLOSSARY）那一条，建议直接搬进 TextFlow。 本地小模型最缺的就是术语一致性，
这条能省 token、稳输出，性价比最高。