Agent Skills
› mattpocock/skills
mattpocock/skills
GitHub基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索API选项并选出最优解。
Install All Skills
npx skills add mattpocock/skills --all -g -y
Skills in Collection (47)
基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索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
智能路由技能，用于根据用户需求匹配最合适的开发流程。涵盖从创意构思、原型验证到多会话分票实施及代码审查的完整链路，辅助Agent选择正确的工作路径。
用户不确定该使用哪个技能或工作流
需要规划从想法到交付的整体开发路径
npx skills add mattpocock/skills --skill ask-matt -g -y
对代码变更进行双轴审查：标准合规性与需求实现度。通过并行子代理对比指定起点至HEAD的Diff，检查编码规范及Issue/Spec一致性，输出综合报告。
用户要求审查分支、PR或自某点以来的变更
用户明确提及 'review' 或 'review since X'
npx skills add mattpocock/skills --skill code-review -g -y
提供模块设计共享词汇与原则，指导构建高内聚、低耦合的深度模块。用于优化接口设计、划分模块边界、提升代码可测试性与AI导航能力，促进复用与维护。
设计或重构模块接口
决定模块边界（Seam）位置
提升代码可测试性
统一代码库设计术语
npx skills add mattpocock/skills --skill codebase-design -g -y
用于诊断复杂Bug和性能回退的技能。核心在于构建紧密的反馈循环，通过测试、脚本或二分法等手段快速定位问题根源，并强调输出时的敏感信息脱敏处理。
用户要求诊断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
扫描代码库以发现架构摩擦并提出深化重构机会，旨在提升可测试性和AI导航能力。通过探索热点模块，使用特定设计词汇生成HTML报告供用户选择执行。
需要分析代码库架构问题
寻找重构以提升可测试性
评估模块深度与耦合度
npx skills add mattpocock/skills --skill improve-codebase-architecture -g -y
构建一次性原型以验证设计问题，支持逻辑状态模型或UI界面探索。通过生成可快速运行的代码片段，帮助用户直观检查设计合理性，并在验证后清理或归档决策。
验证状态模型或逻辑是否合理
探索UI界面设计方案
npx skills add mattpocock/skills --skill prototype -g -y
启动后台代理，针对官方文档、源码等权威一手来源进行深入调查，并将调查结果整理为带有引用的 Markdown 文件存入仓库。适用于用户需要背景调研、收集 API 事实或委托阅读任务时。
需要对特定主题进行深度研究
收集官方文档或 API 的事实信息
委托后台代理完成阅读和资料整理工作
npx skills add mattpocock/skills --skill research -g -y
解决 Git merge 或 rebase 过程中的冲突。包括分析冲突根源、保留双方意图并合理取舍、修复自动化检查失败问题，最终完成合并或变基提交。
Git merge 冲突
Git rebase 冲突
npx skills add mattpocock/skills --skill resolving-merge-conflicts -g -y
用于初始化工程技能所需的仓库配置，包括问题追踪器、分类标签和领域文档布局。通过探索仓库状态并与用户确认，自动设置 GitHub/GitLab/本地 Markdown 等 Issue 追踪方式及上下文文档结构。
首次使用工程技能前需要初始化仓库配置
需要设置或更新项目的 Issue 追踪、Triage 标签和 Domain Docs 结构
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
提供TDD实践指南，涵盖红绿循环规则、优质测试标准、接缝选择及反模式规避。指导用户通过公共接口验证行为，确保测试可维护性，并在编码前确认测试范围。
用户希望以测试驱动方式开发功能或修复bug
提及“红-绿-重构”流程
需要编写集成测试
npx skills add mattpocock/skills --skill tdd -g -y
该技能用于基于当前对话上下文和代码库理解，自动生成项目需求规格说明书（Spec），并直接发布到项目问题跟踪器。它强调无需额外访谈，而是通过综合已有信息来提炼需求、定义用户故事及测试策略。
需要生成需求规格文档
将讨论内容转化为正式Spec并发布至Issue Tracker
npx skills add mattpocock/skills --skill to-spec -g -y
将计划、规范或对话拆解为可独立验证的追踪子弹式工单，定义阻塞依赖并发布至问题追踪器，支持垂直切片与宽重构策略。
用户要求将需求拆分为任务
用户提供计划或规格说明书需分解
需要生成带依赖关系的工单列表
npx skills add mattpocock/skills --skill to-tickets -g -y
自动化管理项目问题与PR的三态流转，包括分类、状态更新及生成Agent就绪简报。
需要整理或查看待处理的问题/PR列表
手动指定将某个Issue或PR移动到特定状态
询问哪些任务已准备好由Agent执行
npx skills add mattpocock/skills --skill triage -g -y
Wayfinder用于规划超出单次会话的大型任务。通过创建共享地图（Issue Tracker）分解决策点，逐一解决以明确路径，侧重规划而非执行，适用于复杂工作的前期梳理。
面对模糊且庞大的目标需要拆解
需要将大型工作分解为可管理的决策任务
npx skills add mattpocock/skills --skill wayfinder -g -y
生成交互式Bash向导脚本，引导人类完成手动配置、凭证设置或一次性迁移等繁琐且需人工介入的步骤。通过标准化模板提供进度显示和确认机制，确保流程清晰可靠。
需要引导用户手动配置基础设施
设置第三方服务凭据或CI密钥
执行一次性数据迁移或服务割接
npx skills add mattpocock/skills --skill wizard -g -y
通过多轮迭代构建设计树，每轮询问当前前沿决策并推荐答案。自动调用子代理获取事实而非询问用户，直至所有分支确认，达成共同理解。
需要系统性梳理复杂设计决策
需要通过交互式问答建立项目共识
npx skills add mattpocock/skills --skill batch-grill-me -g -y
生成会话交接摘要并启动后台Agent继续工作。自动提取关键信息，建议后续技能，脱敏敏感数据，通过claude CLI命令在后台创建新会话，实现任务无缝移交。
需要暂停当前对话并将任务移交给其他Agent
希望在不中断主会话的情况下启动后台持续任务
npx skills add mattpocock/skills --skill claude-handoff -g -y
通过迭代式问答挖掘用户重复性任务模式，定义触发器和检查点，生成标准化的工作流规范文件。
需要自动化重复性任务时
设计新的工作流规范时
npx skills add mattpocock/skills --skill loop-me -g -y
自动在TypeScript仓库中配置dependency-cruiser，强制执行深度模块规范。通过限制包内外部仅能通过根目录入口文件访问，隐藏子文件夹实现细节，并禁止依赖循环，从而优化代码结构与可维护性。
用户希望在TypeScript项目中实施严格的模块化架构
需要自动化配置依赖边界检查以防止深层导入和循环依赖
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
基于原始素材，通过“节拍”式互动引导用户选择路径，逐步撰写文章。确保概念按逻辑顺序铺垫（Grounding），实现交互式内容创作。
用户提供Markdown格式的原始素材
需要以互动方式生成或续写文章
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安全钩子
要求在Claude Code中阻止git push或reset
npx skills add mattpocock/skills --skill git-guardrails-claude-code -g -y
将测试文件中的类型断言（as）迁移至 @total-typescript/shoehorn，提供 fromPartial/fromAny 等类型安全替代方案，简化测试数据构造。
用户提到 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、lint-staged 和 Prettier，集成类型检查与测试脚本到 pre-commit 钩子中，确保代码提交前格式规范且通过基础验证。
用户希望添加 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
这是一个用于多会话教学的技能，通过维护任务、资源、学习记录和课程文件，帮助用户系统性地掌握新技能或概念，强调长期记忆与流利度的平衡。
用户请求教授新知识或技能
开启跨会话的学习项目
npx skills add mattpocock/skills --skill teach -g -y
将用户无法独立回答的决策转化为结构化问卷，通过访谈确定收件人及所需信息，生成Markdown文档以填补知识缺口。
需要向他人收集特定决策或事实信息
用户缺乏某些上下文需通过问卷获取
npx skills add mattpocock/skills --skill to-questionnaire -g -y
当对话上下文丢失或无法理解时，要求对方重新陈述，使用简化技术英语和领域通用语言提供背景信息。
对话中断或上下文缺失
对当前进展感到困惑
npx skills add mattpocock/skills --skill wait-what -g -y
指导如何编写 Agent 消费文档（如 Skill、AGENTS.md）的指南，涵盖上下文指针优化、认知与上下文负载管理及信息层级构建。
创建或编辑 Agent Skill
修改 AGENTS.md 或 CLAUDE.md
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
根据需求规范及任务图，协调多个子代理并行实现代码，处理合并、审查与修复，最终生成完整的 Pull Request。
需要根据规格说明书编写完整功能代码
需要并行执行多个开发任务以加速实现
需要自动化创建和更新 Pull Request
npx skills add mattpocock/skills --skill implement-spec -g -y
对编码会话进行回顾，分析导航、自动化检查、编码标准等方面的问题，提出改进建议以优化未来Agent运行效率。
用户要求对编码会话进行回顾
需要评估和改进Agent环境
npx skills add mattpocock/skills --skill retro -g -y
通过深度问答打磨设计方案，并在过程中生成架构决策记录(ADR)和术语表，辅助设计优化与文档沉淀。
需要审查或完善系统设计/方案时
需要梳理领域模型并生成相关文档时
npx skills add mattpocock/skills --skill grill-with-docs -g -y
通过高强度模拟面试或质询，帮助用户打磨和优化设计方案与计划，提升其严谨性与可行性。
需要优化设计方案
准备方案评审或答辩
npx skills add mattpocock/skills --skill grill-me -g -y
