mattpocock / skills

#15

156,53913,470+973 todayShell

View on GitHub

Skills for Real Engineers. Straight from my .claude directory.

💡 Use Cases

这个项目最适合AI辅助开发场景，通过预制技能将需求讨论、Bug排查、代码设计和Git安全等常见工作流自动化，减少手动操作和决策盲区。

从讨论到PRD自动化

Problem: 团队讨论完需求后，需要手动整理PRD并创建GitHub Issue，过程繁琐且容易遗漏细节。

Solution: 使用to-prd技能，自动将当前对话上下文综合成PRD并直接提交为GitHub Issue，无需额外访谈。

Example: 你和团队在Slack/Claude里聊完一个新功能，运行to-prd，几秒后一个结构化的PRD Issue就出现在仓库里。

Bug根源分析与修复计划

Problem: 遇到复杂Bug时，手动排查代码耗时费力，且修复方案容易遗漏边界情况。

Solution: 使用triage-issue技能，自动探索代码库定位根因，并生成包含TDD修复计划的GitHub Issue。

Example: 用户反馈登录超时，运行triage-issue，它会分析相关代码，找到会话管理模块的竞态条件，并给出带测试用例的修复步骤。

安全防护危险Git操作

Problem: 开发者误执行git push --force或git reset --hard导致代码丢失，尤其在多人协作时风险极高。

Solution: 使用git-guardrails-claude-code技能，在Claude Code中设置钩子，拦截并阻止危险命令执行。

Example: 配置后，当有人输入git push --force时，Claude Code会弹出警告并拒绝执行，直到手动确认。

模块接口多方案设计

Problem: 设计模块接口时容易陷入单一思路，缺乏对比和权衡，导致后期返工。

Solution: 使用design-an-interface技能，并行生成多个截然不同的接口设计方案，供团队评估选择。

Example: 设计支付模块API时，运行design-an-interface，它会同时输出RESTful、GraphQL和事件驱动三种方案，附带优缺点分析。

📊 Project Info

Language: Shell
Stars: ⭐ 156,539
Forks: 13,470
Today: +973
Ranking: #15
Collection: Overall
Trending Date: July 4, 2026
Last Push: 7/3/2026

🏷️ Topics

Shell技能目录AI辅助开发项目管理可扩展开发者全栈工程师

📸 Screenshots

5分钟快速开始：mattpocock/skills 智能体技能集合

快速克隆并配置技能目录，在 Claude 等 AI 助手中立即使用预设技能。

🖥️ OS

macOSLinux

⚙️ Runtime

Git2.x

🔧 Tools

Claude Code 或兼容 AI 助手— 执行技能

📝 Steps

克隆仓库

将技能集合克隆到本地。

克隆仓库

$ git clone https://github.com/mattpocock/skills.git

✓Expected: 显示克隆进度，完成后当前目录下出现 skills 文件夹。

💡确保网络畅通，若速度慢可使用代理。

进入目录并查看结构

进入 skills 目录，确认技能文件存在。

列出技能文件

$ cd skills && ls

✓Expected: 看到类似 to-prd, tdd, grill-me 等文件夹或 .md 文件。

💡每个技能对应一个文件夹，内含说明和脚本。

配置 AI 助手使用技能

将 skills 目录路径告知你的 AI 助手（如 Claude Code），或复制技能内容到对话中。

获取当前绝对路径

$ echo 'skills 目录路径: '$(pwd)

✓Expected: 输出类似 /home/user/skills 的路径。

💡在 Claude Code 中，可使用 /load 命令加载技能文件。

运行第一个技能：to-prd

使用 to-prd 技能将当前对话转化为 PRD 并提交为 GitHub Issue。

查看技能使用说明

$ cat skills/to-prd/instructions.md

✓Expected: 显示 to-prd 技能的详细使用步骤。

💡确保已设置 GitHub 令牌（GH_TOKEN）以自动创建 Issue。

✅ 验证成功

成功加载技能并看到 to-prd 的说明文件。

✓skills 目录存在且包含多个技能文件夹
✓能够查看技能说明文件内容

⚡ Quick Tips

使用技能文件通常为 .md 格式，可直接复制内容到 AI 对话中。

配置部分技能需要 GitHub 令牌，请提前设置环境变量 GH_TOKEN。

学习建议先阅读每个技能文件夹内的 README 或 instructions.md。

🔍 Troubleshooting

❓ 克隆失败（网络问题）

→ 尝试使用代理或镜像站点，如 git clone https://ghproxy.com/https://github.com/mattpocock/skills.git

❓ AI 助手无法识别技能

→ 确保将技能文件内容直接粘贴到对话中，或使用支持文件加载的助手（如 Claude Code 的 /load 命令）

❓ GitHub Issue 创建失败

→ 检查 GH_TOKEN 是否设置正确，且具有 repo 权限。运行 export GH_TOKEN=your_token 设置。

🎯 Next Steps

尝试 grill-me 技能

模拟面试，梳理决策树。

尝试 tdd 技能

进行红-绿-重构测试驱动开发循环。

自定义技能

参考 write-a-skill 技能创建自己的技能。

Difficulty

初级

Est. Time

1-2天

Target Audience

有一定编程基础、希望系统化提升AI辅助开发效率的全栈工程师或技术团队，尤其是使用Claude Code、Codex等AI编码代理的开发者。

🎯 What You'll Learn

学会安装和配置mattpocock/skills技能集合，掌握核心技能（如/grill-me、/tdd、/to-prd、/diagnose）的用法，能通过AI代理高效完成需求对齐、测试驱动开发、代码诊断和架构优化。

📋 Prerequisites

Shell终端基础了解

需要知道如何打开终端、执行命令、查看输出，因为项目安装和配置都通过Shell脚本完成。

Git基础了解

需要了解Git的基本概念（如提交、分支、Issue），因为部分技能会创建GitHub Issue或管理代码。

AI编码代理使用经验了解(optional)

项目是为Claude Code、Codex等AI编码代理设计的，需要你至少使用过其中一种，熟悉其基本交互方式。

📚 Resources

必看

项目README

项目的主要文档，包含安装、配置、所有技能的详细说明和FAQ。

🗺️ Learning Phases

环境准备与安装

⏱ 30分钟

克隆项目仓库

打开终端，执行 git clone https://github.com/mattpocock/skills.git 将项目克隆到本地。

💡确保你的网络能正常访问GitHub。

运行安装脚本

进入项目目录，运行 skills.sh 安装脚本。根据提示选择你想要安装的技能和目标AI代理。

💡安装脚本是交互式的，请仔细阅读每一步的提示。如果遇到权限问题，尝试 chmod +x skills.sh 赋予执行权限。

初始化配置

在AI代理中运行 /setup-matt-pocock-skills 命令，按照提示选择Issue追踪器（如GitHub）、标签类型和文档保存位置。

💡配置只需执行一次，后续在新仓库使用时需要重新运行此命令。

快速入门：掌握核心技能

⏱ 3-4小时

学习需求对齐技能：/grill-me 和 /grill-with-docs

在AI代理中运行 /grill-me 命令，模拟一个简单的功能需求（如“添加用户登录功能”），观察AI如何通过提问帮你梳理需求。然后尝试 /grill-with-docs，体验如何建立共享语言（CONTEXT.md）。

💡这是最常用的技能，建议在每个新功能开发前都使用一次。注意观察AI提问的深度和逻辑。

学习测试驱动开发技能：/tdd

在一个简单的项目中运行 /tdd 命令，按照AI引导完成一个红-绿-重构循环。先让AI写一个失败的测试，然后修复它，最后重构代码。

💡如果项目没有测试框架，AI会自动建议安装。建议从最简单的功能开始，比如一个加法函数。

学习文档生成技能：/to-prd

在AI代理中与AI讨论一个功能需求（如“添加搜索功能”），然后运行 /to-prd 命令，观察AI如何将对话内容转化为产品需求文档并提交为Issue。

💡确保在运行前已经与AI充分讨论了需求的细节。生成的PRD会直接提交到你配置的Issue追踪器。

学习诊断技能：/diagnose

故意在代码中制造一个bug（如逻辑错误），运行 /diagnose 命令，观察AI如何通过“重现-最小化-假设-验证-修复-回归测试”的循环来定位和修复问题。

💡这个技能特别适合处理难以复现的bug。请确保你的代码有测试用例，以便进行回归测试。

进阶实践：组合使用与定制

⏱ 2-3小时

组合使用技能完成一个完整任务

选择一个中等复杂度的功能（如“添加用户评论模块”），依次使用 /grill-with-docs（需求对齐）→ /to-prd（生成文档）→ /tdd（开发实现）→ /diagnose（调试）完成全流程。

💡注意观察每个技能之间的衔接，特别是共享语言（CONTEXT.md）如何帮助后续步骤更高效。

学习代码架构优化技能：/improve-codebase-architecture

在一个已有代码库中运行 /improve-codebase-architecture 命令，观察AI如何分析代码结构并提出改进建议。

💡建议在项目开发几天后运行，让AI帮助你发现代码中的“泥球”并逐步优化。

学习创建自定义技能：/write-a-skill

运行 /write-a-skill 命令，按照AI引导创建一个简单的自定义技能（如“/format-code”用于自动格式化代码）。

💡自定义技能可以复用已有的技能结构，建议先阅读项目中的示例技能文件。

⚠️ Common Mistakes

❌ 跳过配置步骤，直接使用技能

✅ 必须先在AI代理中运行 /setup-matt-pocock-skills 完成配置，否则技能无法正常工作。配置只需一次，但每个新仓库都需要重新运行。

❌ 在不合适的场景使用技能

✅ 例如，/grill-me 用于非代码需求对齐，/grill-with-docs 用于需要文档化的场景。仔细阅读每个技能的描述，选择正确的工具。

❌ 期望技能能自动解决所有问题

✅ 这些技能是辅助工具，不是银弹。它们提供流程引导和最佳实践，但最终决策和代码质量仍然取决于你。保持批判性思维，必要时手动干预。

❌ 忽略共享语言（CONTEXT.md）的维护

✅ 共享语言是减少冗长和提升效率的关键。每次使用 /grill-with-docs 后，确保更新 CONTEXT.md。如果发现术语不一致，及时修正。

❌ 在大型变更前不使用 /grill-me 或 /grill-with-docs

✅ 这是最常见的错误。每次开始一个新功能或大的修改前，务必使用需求对齐技能，否则很容易出现“AI没做你想要的事”的情况。

🚀 Next Steps

学完基础后，可以尝试：1）将技能集成到你的CI/CD流程中，实现自动化测试和文档生成；2）根据团队需求，使用 /write-a-skill 创建更多自定义技能；3）深入研究每个技能的源代码，理解其实现原理，并贡献改进；4）探索其他类似项目（如GSD、BMAD、Spec-Kit），对比不同方法论；5）关注作者的新闻通讯，获取最新技能和最佳实践。