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
智能路由助手，根据用户场景推荐最合适的技能或流程。涵盖从创意构思、原型验证到多阶段开发及代码审查的全链路路径，帮助用户在复杂技能库中快速定位执行方案。
不确定该使用哪个开发技能时
需要规划从想法到交付的整体工作流时
npx skills add mattpocock/skills --skill ask-matt -g -y
对代码变更进行双轴审查：检查是否符合编码规范及实现是否匹配需求。通过并行子代理分别评估标准和规格，聚合结果并报告差异。
用户要求审查分支或PR
用户询问自某固定点以来的变更
npx skills add mattpocock/skills --skill code-review -g -y
提供深层模块设计的共享词汇与原则，规范接口、实现及接缝等术语，旨在提升代码的可测试性、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
npx skills add mattpocock/skills --skill domain-modeling -g -y
根据规范或工单实现功能，优先使用TDD，定期运行类型检查和测试，完成后进行代码审查并提交到当前分支。
用户提供了具体功能规格说明
需要根据工单列表进行开发实现
npx skills add mattpocock/skills --skill implement -g -y
扫描代码库以识别架构摩擦和深化机会，生成可视化 HTML 报告。通过分析模块深度、耦合度和可测试性，提出重构建议，旨在提升代码的可测试性和 AI 导航能力。
需要评估代码库架构质量
寻找重构或模块化改进机会
分析代码深层耦合与接口设计
npx skills add mattpocock/skills --skill improve-codebase-architecture -g -y
用于构建一次性原型以验证设计问题。通过逻辑或UI分支快速生成可运行代码，帮助非开发人员探索状态模型或界面布局，验证后清理并记录结论。
验证状态模型或逻辑是否正确
探索UI设计方案
npx skills add mattpocock/skills --skill prototype -g -y
启动后台代理调查问题，基于官方文档、源码等第一手权威来源进行调研，并将结果整理为引用明确的Markdown文件存入仓库。
用户需要对某个主题进行深入调研
需要收集文档或API事实信息
需要将阅读和资料搜集工作委托给后台代理
npx skills add mattpocock/skills --skill research -g -y
用于解决 Git 合并或变基过程中的冲突。通过检查历史与意图，保留双方逻辑或按目标取舍，不发明新行为且强制完成而非中止。随后运行自动化检查修复问题，最后提交或继续变基流程。
Git merge 冲突
Git rebase 冲突
npx skills add mattpocock/skills --skill resolving-merge-conflicts -g -y
初始化仓库的工程技能配置，包括问题追踪器、分类标签和领域文档结构。通过探索仓库状态并与用户确认，为后续工程技能提供必要的基础设施支持。
首次使用工程技能前需要初始化仓库
需要设置或修复 Issue Tracker、Triage Labels 或 Domain Docs 配置
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
TDD技能指导红绿重构循环，定义好测试标准、接口边界（Seams）及反模式，强调通过公共接口验证行为而非实现细节，确保测试具备可维护性和业务价值。
用户希望以测试优先方式构建功能或修复bug
提及红-绿-重构流程
需要编写集成测试
npx skills add mattpocock/skills --skill tdd -g -y
基于对话上下文和代码库理解，自动生成结构化需求规格说明书并发布至项目问题跟踪器。无需额外访谈，直接综合已有信息生成包含问题、解决方案、用户故事及测试决策的规范文档。
需要快速将讨论转化为正式需求文档
准备发布功能规格到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就绪简报。
需要整理或审查Issue/PR状态时
询问哪些任务等待处理或已准备好由Agent执行时
npx skills add mattpocock/skills --skill triage -g -y
用于将大型模糊任务拆解为共享决策地图，通过逐一解决待办问题来明确实施路径。默认侧重规划而非执行，适用于复杂工作的前期梳理与路线制定。
任务规模超出单次会话处理能力
需求或路径不明确需要拆解规划
需要将复杂工作转化为可执行的决策清单
npx skills add mattpocock/skills --skill wayfinder -g -y
生成交互式 Bash 向导脚本，引导人类完成手动配置基础设施、设置凭证或执行一次性迁移等繁琐步骤。
需要人工介入的复杂手动流程
首次环境配置或第三方服务对接
一次性数据迁移或状态切换
npx skills add mattpocock/skills --skill wizard -g -y
通过多轮迭代构建设计树，每轮询问当前前沿决策并推荐答案。自动调用子代理获取事实而非询问用户，直至所有分支确认，达成共同理解。
需要系统性梳理复杂设计决策
需要通过交互式问答建立项目共识
npx skills add mattpocock/skills --skill batch-grill-me -g -y
生成会话交接摘要并启动后台代理以继续工作。该技能用于将当前对话上下文整理为提示，传递给新的后台 Agent，支持敏感信息脱敏、建议技能推荐及参数定制，实现无缝任务移交。
需要中断当前对话并将工作移交给新代理时
用户请求启动后台任务或分派后续工作时
npx skills add mattpocock/skills --skill claude-handoff -g -y
通过交互式追问明确用户需求，生成可执行的自动化工作流规范。聚焦识别生活与工作循环，定义触发器、检查点及推送策略，确保规范完备以便直接实现。
用户希望构建或优化自动化流程
需要梳理重复性任务并转化为工作流
npx skills add mattpocock/skills --skill loop-me -g -y
将 dependency-cruiser 集成至 TypeScript 仓库，配置规则强制包结构为深层模块。限制外部仅能访问入口文件，隐藏子目录实现，禁止循环依赖，确保模块化边界清晰。
需要规范 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
基于用户提供的原始素材，采用互动式“选择你自己的冒险”流程，逐步撰写文章。先确立读者前置知识，再提供候选段落供用户选择，每次仅写入一个段落并更新已掌握概念列表，直至完成整篇文章。
用户提供包含原始素材的 Markdown 文件
需要结构化地撰写长篇文章或教程
npx skills add mattpocock/skills --skill writing-beats -g -y
用于写作前期的灵感探索，通过对话挖掘零散片段并追加至Markdown文件。不构建结构，旨在收集可读的原始素材，如金句、观点或隐喻，为后续结构化写作积累内容。
用户需要头脑风暴或收集写作素材
用户希望记录未成形的想法或灵感碎片
npx skills add mattpocock/skills --skill writing-fragments -g -y
将原始素材（如碎片、非结构化文本或转录稿）塑造为文章。通过阅读素材、确立读者前置知识、生成多个开篇选项供选择，并按段落逐步构建内容，同时严格管理概念引入顺序以确保逻辑连贯。
用户提供包含原始素材的Markdown文件
需要将杂乱信息整理并撰写成结构化的文章
npx skills add mattpocock/skills --skill writing-shape -g -y
通过配置PreToolUse钩子拦截并阻止危险的Git命令（如push、reset --hard等），防止误操作导致代码丢失或分支被删，提供项目级和全局级安全保护方案。
用户希望阻止破坏性git操作
需要添加git安全钩子
请求在Claude Code中限制git push或reset权限
npx skills add mattpocock/skills --skill git-guardrails-claude-code -g -y
将测试文件中的 TypeScript as 类型断言迁移至 @total-typescript/shoehorn，以支持部分数据传递和类型安全，提升测试代码质量。
用户提及 shoehorn
希望替换测试中的 as 断言
需要生成部分测试数据
npx skills add mattpocock/skills --skill migrate-to-shoehorn -g -y
用于根据计划自动创建符合规范的练习题目录结构，包含问题、解答和说明文件夹，生成基础文件并运行 lint 校验以确保通过。
用户希望搭建新的课程章节或练习集
需要批量生成练习题的骨架代码或占位符
npx skills add mattpocock/skills --skill scaffold-exercises -g -y
用于在仓库中配置 Husky、lint-staged 和 Prettier，实现提交前自动格式化、类型检查和测试。
用户希望添加预提交钩子
需要设置 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
用于在对话中断或误解时，要求重新提供上下文。强制使用ASD-STE100简化技术英语及领域通用语言，确保沟通清晰准确，适用于代码审查或开发协作中的澄清场景。
对话出现歧义
需要澄清上下文
要求简化技术表达
npx skills add mattpocock/skills --skill wait-what -g -y
指导如何为AI Agent编写高效文档（如SKILL.md、AGENTS.md），涵盖上下文指针优化、认知与上下文负载管理及信息层级构建，以提升Agent执行的可预测性和可靠性。
创建或编辑Agent技能文件
修改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
基于规格说明和任务图，协调多个子代理并行实现代码。通过探索、分支管理、并发实施、合并及代码审查，最终生成完整的PR，最大化开发效率与并发度。
需要实现完整的功能规格说明
将任务分解为有依赖关系的任务图并执行
npx skills add mattpocock/skills --skill implement-spec -g -y
对编码会话进行回顾，分析导航、自动化检查、编码标准等问题，提出改进建议以优化未来 Agent 运行效率。
用户要求对编码会话进行回顾
需要分析并改进 Agent 环境配置
npx skills add mattpocock/skills --skill retro -g -y
通过严格的问答形式打磨设计方案，并同步生成架构决策记录（ADR）和术语表等文档，提升设计质量与可追溯性。
需要评审或优化系统设计/方案时
希望在设计过程中自动生成 ADR 和术语表时
npx skills add mattpocock/skills --skill grill-with-docs -g -y
通过严格的模拟面试或问答环节，帮助用户打磨和优化计划或设计方案，提升其逻辑严密性和可行性。
需要优化设计方案的场景
希望提前发现计划漏洞的场景
npx skills add mattpocock/skills --skill grill-me -g -y
