Agent Skills
› mattpocock/skills
mattpocock/skills
GitHub基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索API选项并选出最优解。
Install All Skills
npx skills add mattpocock/skills --all -g -y
Skills in Collection (45)
基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索API选项并选出最优解。
用户希望设计API或模块接口
用户想要探索不同的接口选项
用户要求比较模块形状
用户提到 'design it twice'
npx skills add mattpocock/skills --skill design-an-interface -g -y
交互式QA会话，用户对话式报告问题，Agent后台探索代码库获取上下文，澄清细节后直接创建符合领域语言且面向用户的GitHub Issue。
用户想要报告bug或问题
用户希望进行对话式QA
用户提及'QA session'
npx skills add mattpocock/skills --skill qa -g -y
通过用户访谈深入分析重构需求，探索代码库现状并制定详细的重构方案。将任务拆解为微小的安全提交步骤，最终生成包含问题陈述、解决方案及测试决策的GitHub Issue，确保重构过程可控且可验证。
用户希望创建详细的重构计划
需要制定重构RFC文档
要求将大型重构分解为安全的增量步骤
npx skills add mattpocock/skills --skill request-refactor-plan -g -y
从对话中提取领域术语，消除歧义并定义规范词汇，生成UBIQUITOUS_LANGUAGE.md文件。适用于用户需要统一领域语言、构建术语表或提及DDD相关概念时。
用户想要定义领域术语
用户希望构建术语表
用户提及领域模型
用户提及DDD
npx skills add mattpocock/skills --skill ubiquitous-language -g -y
技能路由器，引导用户根据场景选择正确的开发流程。涵盖从创意构思、原型验证到多阶段实施及代码审查的完整路径，优化上下文管理并协调各子技能协作。
需要规划功能实现路径
在多个技能间切换决策
确定是否进行原型设计
分解复杂任务为可执行票据
npx skills add mattpocock/skills --skill ask-matt -g -y
对代码变更进行双维度审查：编码规范符合度与需求规格一致性。通过并行子代理对比指定基准点与HEAD的差异，并汇总结果。
用户请求审查分支、PR或工作进度
用户指定'review since X'场景
npx skills add mattpocock/skills --skill code-review -g -y
提供设计深层模块的共享词汇与原则，定义模块、接口、实现等核心概念，指导通过小接口隐藏复杂逻辑以提升代码可测试性、AI导航性及维护效率。
设计或改进模块接口
寻找代码深化机会
决定模块边界位置
提升代码可测试性或AI可读性
npx skills add mattpocock/skills --skill codebase-design -g -y
针对顽固Bug和性能回归的诊断技能。核心在于构建紧密的反馈循环（如失败测试、脚本、二分法等），通过红绿信号快速定位问题根源，并强调数据脱敏与循环优化。
用户要求诊断或调试问题
报告系统故障、崩溃、报错或性能变慢
npx skills add mattpocock/skills --skill diagnosing-bugs -g -y
用于构建和精炼项目领域模型，挑战术语歧义，编写或编辑 CONTEXT.md 及 ADR 文档，确保业务概念与代码实现一致。
讨论代码库术语
编写或编辑 CONTEXT.md
记录或编辑 ADR
npx skills add mattpocock/skills --skill domain-modeling -g -y
根据规格或工单实现功能，遵循TDD流程，定期运行类型检查和测试，完成后执行代码审查并提交至当前分支。
用户要求根据需求文档实现新功能
需要处理具体的开发任务或工单
npx skills add mattpocock/skills --skill implement -g -y
扫描代码库以识别架构摩擦，利用特定设计词汇分析浅层模块，生成可视化HTML报告并提出重构建议，旨在提升代码的可测试性和AI可导航性。
需要优化代码架构时
希望识别并重构浅层模块以提升可测试性时
寻求提高代码库AI可导航性的场景
npx skills add mattpocock/skills --skill improve-codebase-architecture -g -y
构建一次性原型以验证设计问题，包括逻辑状态模型或UI界面。支持生成可交互HTML文件或运行脚本，强调快速试错、无持久化及结果归档。
需要验证状态机或业务逻辑是否正确
探索不同UI设计方案或视觉呈现效果
npx skills add mattpocock/skills --skill prototype -g -y
启动后台代理，基于官方文档、源码等一手权威来源调查特定问题或收集API事实，并将结果整理为Markdown文件存入仓库，适用于需要背景调研的场景。
用户希望研究某个主题
需要收集文档或API事实
委托后台代理进行阅读和资料搜集
npx skills add mattpocock/skills --skill research -g -y
用于解决 Git merge 或 rebase 过程中的冲突。通过检查冲突文件、理解变更意图、保留双方逻辑并修复自动化检查失败的问题，最终完成合并或变基操作。
Git merge conflict
Git rebase conflict
npx skills add mattpocock/skills --skill resolving-merge-conflicts -g -y
用于配置仓库以适配工程技能集，包括初始化Issue追踪器、定义Triage标签及设置领域文档布局。
首次使用前配置仓库
需要建立Issue追踪和文档规范
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
提供测试驱动开发（TDD）规范，指导如何编写高质量单元测试、识别测试边界及避免反模式。适用于用户要求先写测试、遵循红绿重构循环或需要集成测试的场景。
用户希望以测试优先方式构建功能或修复bug
提及红-绿-重构循环
需要编写集成测试
npx skills add mattpocock/skills --skill tdd -g -y
将对话上下文和代码库理解综合为需求规格说明书（Spec），并自动发布至项目问题追踪器。该技能无需用户面试，直接基于已有信息生成包含问题陈述、解决方案、用户故事及测试决策的结构化文档。
需要将讨论转化为正式的需求规格文档
准备将功能提案发布到项目issue tracker
npx skills add mattpocock/skills --skill to-spec -g -y
将计划、规范或对话拆解为垂直切片的追踪子弹工单，声明依赖关系并发布至跟踪器。支持代码库探索与用户确认迭代。
需要将需求或规划拆分为具体开发任务时
生成具有依赖关系的工单列表时
npx skills add mattpocock/skills --skill to-tickets -g -y
自动化项目 Issue 和 PR 的分诊流程，通过状态机进行分类、验证并生成 Agent 就绪简报。支持查询待处理项、状态流转及冲突检测，确保任务准确分配给 Agent 或人类开发者。
需要整理或分类 GitHub Issue/PR
查询待处理的 Issue 或 PR
将 Issue 标记为特定状态（如 ready-for-agent）
npx skills add mattpocock/skills --skill triage -g -y
Wayfinder用于规划超出单次会话的大型任务。它在Issue Tracker上创建共享地图和决策票，逐步解决关键问题以明确路径，侧重于规划而非执行。
面对庞大且模糊的任务需要拆解规划
需要将复杂工作分解为可管理的决策步骤
npx skills add mattpocock/skills --skill wayfinder -g -y
生成交互式 Bash 向导脚本，引导用户完成基础设施配置、凭证设置或一次性迁移等需人工参与的手动步骤。
需要引导人类手动操作复杂流程
配置基础设施或CI/CD密钥
执行一次性数据迁移
npx skills add mattpocock/skills --skill wizard -g -y
通过多轮迭代构建设计树，每轮询问当前前沿决策并推荐答案。自动调用子代理获取事实而非询问用户，直至所有分支确认，达成共同理解。
需要系统性梳理复杂设计决策
需要通过交互式问答建立项目共识
npx skills add mattpocock/skills --skill batch-grill-me -g -y
将当前对话生成摘要并启动后台Agent继续工作。自动脱敏敏感信息，引用现有文档避免重复，建议后续技能调用方式，通过claude命令无缝交接任务上下文。
需要中断当前会话但保留进度
将复杂任务拆分给独立后台进程执行
npx skills add mattpocock/skills --skill claude-handoff -g -y
通过多轮问答引导用户定义工作流规范，识别生活循环模式并生成结构化说明文件。
需要设计或优化自动化工作流
希望梳理个人重复性任务模式
npx skills add mattpocock/skills --skill loop-me -g -y
在TypeScript仓库中配置dependency-cruiser，强制实施深度模块架构。通过规则限制包间仅能通过入口文件访问，隐藏子文件夹实现，禁止循环依赖，确保清晰的模块边界与接口规范。
需要规范TS多包仓库的模块结构
希望强制实施入口点访问控制
防止深层导入和循环依赖
npx skills add mattpocock/skills --skill setup-ts-deep-modules -g -y
将用户无法独自解答的决策转化为调查表。通过确认收件人身份及所需信息，生成结构化的Markdown问卷，精准填补认知差距，帮助收集关键决策依据。
需要向他人收集特定信息或决策建议
面临无法独立解决的复杂问题需借助外部知识
npx skills add mattpocock/skills --skill to-questionnaire -g -y
生成交互式 Bash 向导，引导用户完成繁琐的手动流程（如第三方配置、迁移或状态转换）。通过打开 URL、捕获值、确认步骤并写入 .env 或 GitHub Secrets，提供带进度和剩余时间的友好 UX。
需要手动配置第三方服务
执行一次性数据迁移
进行项目状态 A 到 B 的转换
重复性高且易错的人工操作流程
npx skills add mattpocock/skills --skill wizard -g -y
基于原始素材进行交互式文章创作。通过确立先决条件和概念铺垫，引导用户选择叙事路径，逐段生成内容并实时写入文件，确保逻辑连贯与读者理解。
需要撰写长篇文章或教程
希望以互动方式构建内容结构
提供原始素材要求整理成文
npx skills add mattpocock/skills --skill writing-beats -g -y
用于写作探索阶段，通过对话挖掘原始写作片段。不关注结构或大纲，而是收集句子、观点、轶事等异构内容并追加至 Markdown 文件，为后续结构化写作积累素材。
用户希望进行头脑风暴或收集写作灵感
用户需要整理零散的笔记和想法
npx skills add mattpocock/skills --skill writing-fragments -g -y
将原始材料（如碎片、未结构化文本或转录稿）塑造为完整文章。通过确定前提、选择开头并逐段构建内容，确保概念先入为主，最终生成独立的文章文档。
用户希望将零散笔记或草稿整理成正式文章
用户提供原始素材并要求进行写作和结构塑造
npx skills add mattpocock/skills --skill writing-shape -g -y
为Claude Code配置PreToolUse钩子，拦截并阻止git push、reset --hard等危险操作，提供项目级或全局级的Git安全保护机制。
用户希望防止破坏性git操作
需要添加git安全钩子
要求阻止git push或reset
npx skills add mattpocock/skills --skill git-guardrails-claude-code -g -y
将测试文件中的 as 类型断言迁移至 @total-typescript/shoehorn，提供 fromPartial、fromAny 等类型安全替代方案，简化测试数据构造并提升 TypeScript 类型检查准确性。
用户提到 shoehorn
需要替换测试代码中的 as 断言
需要处理部分测试数据
npx skills add mattpocock/skills --skill migrate-to-shoehorn -g -y
用于根据计划自动生成符合规范的练习题目录结构，包含问题、解答和解释文件，并执行 lint 检查以确保合规。
用户需要创建新的练习章节或课程部分
用户希望生成练习题存根（stubs）
npx skills add mattpocock/skills --skill scaffold-exercises -g -y
用于在项目中配置 Husky pre-commit 钩子，集成 lint-staged、Prettier 格式化及类型检查/测试。自动检测包管理器并初始化相关配置，确保提交前代码质量。
用户希望添加 pre-commit hooks
需要设置 Husky
配置 lint-staged
添加提交时的格式化和类型检查
npx skills add mattpocock/skills --skill setup-pre-commit -g -y
用于编辑和改进文章草稿，通过重构章节、提升清晰度和精简文本来优化内容。在用户提出编辑、修订或改善文章需求时触发。
用户希望编辑文章
用户希望改进文章草稿
用户希望提升文章清晰度
npx skills add mattpocock/skills --skill edit-article -g -y
用于在Obsidian知识库中搜索、创建和管理笔记。支持按文件名或内容查找，创建符合命名规范的笔记并添加双向链接，以及通过反向链接和索引笔记发现相关内容。
用户需要查找特定关键词的笔记
用户希望创建新的知识笔记
用户想要整理或组织现有笔记结构
用户需要查找与某主题相关的笔记
npx skills add mattpocock/skills --skill obsidian-vault -g -y
通过追问和构建决策树，对用户计划或想法进行压力测试。以轮次方式询问当前可决断的问题并提供建议，自动查找事实，直至达成共同理解。
用户希望压力测试其思考
用户使用 'grill' 相关触发短语
npx skills add mattpocock/skills --skill grilling -g -y
将当前对话压缩为交接文档，供新 Agent 继续工作。保存至系统临时目录，包含建议技能列表，引用而非复制已有工件，并脱敏敏感信息。
需要暂停或切换 Agent 时
整理对话上下文以便后续处理
npx skills add mattpocock/skills --skill handoff -g -y
用于指导AI在多会话中系统性地教授用户新技能或概念。通过维护教学目标、参考资料、学习记录和课程文件，构建结构化的工作区以支持长期学习和知识内化。
用户请求学习新知识
用户希望掌握某项技能
npx skills add mattpocock/skills --skill teach -g -y
将用户无法独立解决的决策转化为结构化问卷，通过询问收件人角色与所需信息，生成Markdown文档以填补知识缺口。
用户面临需他人提供信息的决策
需要向特定人员收集异步反馈或数据
npx skills add mattpocock/skills --skill to-questionnaire -g -y
提供面向Agent文档（如Skill、AGENTS.md）的写作规范，涵盖上下文指针优化、负载管理及信息层级构建，旨在提升Agent读取效率与执行可靠性。
创建或编辑Agent Skill
修改AGENTS.md或CLAUDE.md
编写Agent消费的技术文档
npx skills add mattpocock/skills --skill writing-for-agents -g -y
指导如何编写高可预测性的 Agent Skill，涵盖模型调用与用户调用的权衡、描述精简原则及信息层级结构，旨在通过确定性流程优化 Agent 行为。
需要编写或优化 Agent 技能文档
希望提升 Agent 执行过程的确定性和可预测性
学习 Skill 的描述撰写与信息分层技巧
npx skills add mattpocock/skills --skill writing-great-skills -g -y
通过持续提问打磨计划或设计，并同步生成架构决策记录(ADR)和术语表。需分两次调用 Skill 工具分别执行 grilling 和 domain-modeling。
需要深入审视和优化系统设计时
需要完善技术文档如 ADR 和术语表时
npx skills add mattpocock/skills --skill grill-with-docs -g -y
通过严格的面试式提问，帮助用户打磨和优化计划或设计方案。
需要批判性审视设计或计划
寻求对方案的深度挑战与优化建议
npx skills add mattpocock/skills --skill grill-me -g -y
当对话出现理解偏差或上下文丢失时，要求对方使用简化技术英语和通用语言重新阐述背景与意图，以澄清当前状态。
对话出现误解
上下文信息缺失
npx skills add mattpocock/skills --skill wait-what -g -y
