mattpocock/skills
一套可复用的提示词剧本,防止Claude Code等AI编程代理跑偏
mattpocock/skills是一组指导Claude Code、Codex等AI编程代理的'技能'文件,让它们在写代码前先反问你需求、在项目中统一术语、执行测试驱动开发循环,并定期检查代码库架构。每个技能都是小巧、可编辑的指令文档,而不是一个笨重的一体化框架。安装方式可以是作为Claude Code插件整体接入,也可以通过skills.sh安装器把文件直接复制进项目自由修改。
它做什么
- 针对AI编程代理常见的四类问题:没理解你到底想要什么、回答过于啰嗦、写出的代码其实跑不通、代码库随时间变成一团乱麻。
- /grill-me和/grill-with-docs技能会让代理在动手写代码前先反复追问你的计划,/grill-with-docs还会同步维护一份名为CONTEXT.md的共享术语文档和ADR(架构决策记录),使代理的表达随时间变得更简洁准确。
- /tdd技能强制执行先写失败测试再修复的red-green-refactor循环,让代理获得稳定反馈而不是瞎猜,/diagnosing-bugs则提供一套按阶段推进的规范化调试流程。
- /improve-codebase-architecture会扫描代码库,找出可以'加深'简化设计的机会点,并生成HTML报告展示,作者说明这只是一个排查工具,并不会自动帮你理顺一个真正老旧混乱的代码库。
- 技能分为需要用户手动输入调用的'user-invoked'(如/triage、/to-spec)和代理可根据任务自动调用的'model-invoked'(如tdd、code-review)两类;安装方式可选自动更新、只读的Claude Code插件,或通过skills.sh CLI把文件复制成可编辑的本地文件。
为什么重要
随着AI编程代理在日常开发中的分量越来越重,一套轻量、不依赖特定模型、又能让代理保持对齐和纪律性的方法,比那种夺走开发者控制权的重型AI框架更有价值。该仓库获得224352颗星,已成为经验丰富的工程师展示自己如何实际组织AI代理工作流的实用参考。
本仓库术语
- Claude Code插件 · 整体安装进Anthropic编程代理Claude Code、可自动更新的只读扩展包
- skills.sh · 把技能文件直接复制进项目、供用户自行编辑的安装工具
- red-green-refactor · 先写失败测试(red)、再让测试通过(green)、最后整理代码(refactor)的测试驱动开发流程
- ADR · 记录设计决策及其理由的文档格式(架构决策记录)
- CONTEXT.md · 整理项目专有术语和领域概念,帮助代理与人类使用同一套语言交流的文档
仓库简介（英文）
Skills for Real Engineers. Straight from my .agents directory.
在 GitHub 打开热门仓库
- cathrynlavery/diagram-design让AI编程工具画出杂志排版质感图表,而不是千篇一律的圆角方框
- public-apis/public-apis一份由社区维护的免费API大全仓库
- semantica-agi/semantica一个让AI智能体的决策可追溯、可审计的开源图谱基础设施
- cactus-compute/needle一个14MB的AI模型,让手机和可穿戴设备无需联网就能调用工具
- unslothai/unsloth一款让你在自己电脑上运行和训练AI模型的桌面应用，无需写代码
- macro-inc/macro把邮件、聊天、文档、任务和CRM互相链接、共享同一份AI团队记忆的一体化办公平台
- harry0703/MoneyPrinterTurbo只需一个主题或关键词，就能自动生成配好文案、素材、字幕和音乐的完整短视频的开源工具
- basecamp/omarchyDHH打造的、开箱即用且风格统一的Linux发行版