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
对代码变更进行双维度审查：标准合规性与需求实现度。通过并行子代理分别检查编码规范与原始Spec，聚合输出审查结果，适用于PR、分支或WIP变更评审。
用户请求审查分支或PR
用户要求对比自某提交以来的变更
用户提及review
npx skills add mattpocock/skills --skill code-review -g -y
提供模块化设计词汇与原则，指导定义接口、实现与接缝，旨在通过深层模块提升代码可测试性、复用性及维护效率。
设计或改进模块接口
重构代码以提高可测试性
确定模块边界与接缝位置
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导航能力。
需要分析代码库架构缺陷
寻求重构以改善模块深度和可测试性
npx skills add mattpocock/skills --skill improve-codebase-architecture -g -y
用于构建一次性原型以验证设计假设，包括逻辑状态模型或UI界面。通过分支策略生成HTML文件或多种UI变体，强调快速运行、无持久化及状态可视化，旨在低成本探索方案并沉淀决策。
用户希望验证状态模型或业务逻辑是否合理
用户需要探索或对比不同的UI设计方案
npx skills add mattpocock/skills --skill prototype -g -y
启动后台代理，针对官方文档、源码等权威一手来源深入调研特定问题或API事实，并将结论整理为带有引用来源的Markdown文件保存至仓库中。
需要调研某个技术主题
收集文档或API事实
委托后台代理进行阅读和资料搜集
npx skills add mattpocock/skills --skill research -g -y
用于解决 Git 合并或变基过程中的冲突。通过检查状态、分析变更意图、保留双方逻辑并修复自动化检查失败，最终完成提交或继续变基，确保代码正确合并。
Git 合并冲突
Git 变基冲突
npx skills add mattpocock/skills --skill resolving-merge-conflicts -g -y
配置仓库的工程技能基础设置，包括初始化问题追踪器、定义分类标签词汇及领域文档布局。作为其他工程技能使用前的前置准备步骤。
首次使用工程技能前需配置仓库
需要建立或更新问题追踪与文档规范
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
TDD技能指导测试驱动开发流程，强调通过公共接口验证行为而非实现细节。涵盖良好测试标准、Seam选择、反模式识别及红绿重构循环规则，确保测试具备可维护性并聚焦关键路径。
用户希望以测试优先方式构建功能或修复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时
查看待处理事项列表时
npx skills add mattpocock/skills --skill triage -g -y
用于处理超出单次会话范围的复杂工作，通过创建共享决策地图并逐一解决决策工单来规划路径。默认执行规划而非直接开发，直至目标清晰后移交执行。
任务规模过大无法在单次会话中完成
需要制定详细计划或分解决策而非直接编码
项目初期方向不明确需要梳理路径
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，使新实例能无缝续接工作。自动脱敏敏感信息，推荐后续技能，支持自定义名称与上下文参数。
需要暂停当前任务并移交背景执行时
用户请求将工作转移给新的 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
基于原始素材，以互动式“选择你自己的冒险”风格逐步撰写文章。通过确立先决条件和概念铺垫，引导用户选择路径，逐段生成内容并保存至文件。
用户提供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
通过配置 PreToolUse 钩子拦截并阻止危险的 Git 命令（如 push、reset --hard），防止误操作。支持按项目或全局范围安装，提供脚本定制与验证步骤，增强 Claude Code 使用安全性。
用户希望阻止危险 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
用于自动生成符合规范的练习目录结构，包含问题、解答和解释文件，确保通过代码检查并正确提交。
用户需要创建新的课程章节或练习集
用户希望生成练习存根（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
通过多轮追问压力测试用户计划或决策，构建设计树并梳理依赖关系。自动查找事实，等待用户确认以达成共享理解。
stress-test their thinking
uses any 'grill' trigger phrases
npx skills add mattpocock/skills --skill grilling -g -y
将当前对话压缩为交接文档，供新代理继续工作。保存至系统临时目录，包含建议技能列表，引用而非复制现有工件，并脱敏敏感信息。
需要中断当前会话并将上下文传递给其他代理
用户请求生成工作交接或状态同步文档
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读取文档的可靠性与效率。
创建或编辑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
该技能用于根据规格说明和任务图，协调多个子代理并行实现代码。它管理分支、PR创建、并发开发、合并及代码审查流程，旨在高效完成完整的规格实现。
需要根据规格说明生成代码实现
需要自动化执行包含依赖关系的多步骤开发任务
npx skills add mattpocock/skills --skill implement-spec -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
