Agent Skills
› mattpocock/skills
mattpocock/skills
GitHub基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索API选项并选出最优解。
Install All Skills
npx skills add mattpocock/skills --all -g -y
Skills in Collection (48)
基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索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导航能力。
设计或改进模块接口
寻找深度优化机会
决定代码接缝位置
提升代码可测试性或AI可读性
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
扫描代码库以识别架构摩擦和深化机会，生成可视化HTML报告。通过分析模块深度、接口复杂度和耦合度，提出重构建议以提升可测试性和AI导航性，辅助优化代码结构。
需要分析代码库架构问题
希望获得重构以改善模块深度和可测试性的建议
寻找代码中的架构摩擦点
npx skills add mattpocock/skills --skill improve-codebase-architecture -g -y
用于构建一次性原型以验证设计问题。根据需求分为逻辑状态模型验证和UI界面探索两个分支，强调快速运行、无持久化及事后清理，旨在低成本确认方案可行性。
需要验证状态模型或逻辑是否合理
探索不同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 冲突
Git rebase 冲突
npx skills add mattpocock/skills --skill resolving-merge-conflicts -g -y
用于初始化仓库的工程技能配置，自动检测并设置问题追踪器、分类标签及领域文档布局。通过探索现有状态并与用户确认，为后续工程技能提供标准化的上下文环境。
首次使用工程技能前需要配置仓库
需要统一问题追踪和文档结构
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
提供测试驱动开发(TDD)的最佳实践指南，涵盖红绿循环、测试规范、接缝选择及反模式识别。用于指导用户以测试优先的方式构建功能或修复缺陷，确保测试的鲁棒性与可维护性。
用户希望先写测试后实现代码
提及红-绿-重构流程
需要编写集成测试
npx skills add mattpocock/skills --skill tdd -g -y
基于对话上下文和代码库理解，自动生成项目规范文档并发布至问题追踪器。无需访谈用户，直接综合已有信息生成包含问题、解决方案、用户故事及测试决策的结构化规格说明。
需要生成功能规格说明书
将讨论内容转化为结构化文档并归档
npx skills add mattpocock/skills --skill to-spec -g -y
将计划、规范或对话拆解为可追踪的垂直切片工单，明确依赖关系并支持发布到跟踪器。
用户要求将需求拆分为多个任务
需要规划开发步骤和依赖关系
npx skills add mattpocock/skills --skill to-tickets -g -y
用于自动化管理项目Issue和PR的分诊流程。通过状态机对问题进行分类、验证并生成Agent就绪简报，协助维护者高效处理待办事项，涵盖从初步评估到分配给Agent或人类执行的全生命周期管理。
需要查看未分诊或需关注的问题列表
指定问题或PR的状态变更请求
询问哪些任务已准备好由Agent接手
npx skills add mattpocock/skills --skill triage -g -y
用于将大型复杂任务拆解为问题追踪器上的决策工单，通过规划路线图明确后续步骤，适用于超出单次会话范围的模糊需求场景。
需求过于庞大无法在一次会话中完成
目标路径不清晰需要制定计划
需要将工作分解为多个决策点
npx skills add mattpocock/skills --skill wayfinder -g -y
生成交互式bash向导脚本，引导用户完成手动配置基础设施、设置凭证或CI密钥等繁琐步骤。适用于一次性迁移或第三方服务配置，通过标准化流程捕获值并写入.env或GitHub Secrets，确保操作准确无误。
需要引导人类完成手动配置步骤
设置凭证或CI/CD密钥
执行一次性数据迁移或割接
npx skills add mattpocock/skills --skill wizard -g -y
通过多轮迭代构建设计树，每轮询问当前前沿决策并推荐答案。自动调用子代理获取事实而非询问用户，直至所有分支确认，达成共同理解。
需要系统性梳理复杂设计决策
需要通过交互式问答建立项目共识
npx skills add mattpocock/skills --skill batch-grill-me -g -y
将当前对话生成交接摘要并启动后台代理继续工作，支持命名、技能推荐及敏感信息脱敏。
需要中断当前会话并将任务转移给新代理
启动后台异步任务
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
基于用户提供的原始素材，通过交互式“选择-your-own-adventure”方式逐步撰写文章。先确立受众前提知识，再轮流提供并确认内容片段，确保概念层层铺垫，直至完成整篇文章。
用户提供包含原始材料的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 命令，防止误操作。支持项目级或全局安装，提供脚本部署、设置合并及功能验证步骤。
用户希望阻止危险的 git 操作
需要添加 git 安全钩子
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 校验及修复错误，确保代码库符合命名规范和文件要求。
用户想要生成练习题目录结构
需要创建练习题存根文件
设置新课程章节结构
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
通过多轮问答对用户计划或决策进行压力测试，构建设计树并逐步澄清需求。适用于用户希望验证想法、梳理逻辑或需要深度对话以达成共识的场景。
stress-test their thinking
uses any 'grill' trigger phrases
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编写文档的规范，涵盖技能、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
提供PR Body撰写模板，指导使用图表、Diff和Mermaid等可视化方式清晰展示代码变更逻辑、控制流及影响范围，辅助高效沟通。
需要撰写Pull Request描述
整理代码变更的视觉化表达
npx skills add mattpocock/skills --skill pr -g -y
对编码会话进行回顾，分析导航、自动化检查、编码标准等方面的问题，提出改进建议以优化未来运行环境。
用户要求对编码会话进行回顾
需要分析会话日志并提出环境改进建议
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
