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或分支审查场景。
请求审查分支或PR
指定起点审查变更
询问代码是否符合标准或需求
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
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
启动后台代理，针对用户问题查阅官方文档、源码等权威一手资料进行调研，并将结果整理为引用来源的 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 或 Domain Docs
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
提供测试驱动开发（TDD）规范，指导用户通过红绿重构循环编写高质量测试。涵盖良好测试定义、接缝选择、反模式识别及循环规则，强调基于公共接口验证行为并确认测试范围。
用户希望以测试优先方式构建功能或修复 bug
提及 'red-green-refactor' 流程
需要编写集成测试
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就绪简报。支持自动查询待处理项、分配角色标签及状态转换，辅助维护者高效追踪项目进展。
需要分类或更新Issue/PR状态
查询待处理的Issue或外部PR
生成Agent就绪简报
npx skills add mattpocock/skills --skill triage -g -y
Wayfinder用于规划超出单次会话范围的大型任务。它通过在问题追踪器上创建共享地图和决策票，逐步解决关键决策以明确执行路径，而非直接执行构建，旨在理清复杂工作的方向。
面对过于庞大、无法在一次会话中完成的任务
工作路径模糊，需要拆解为一系列决策以明确下一步行动
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命令启动后台任务。
需要中断当前会话并将工作移交其他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
配置 Claude Code 钩子以拦截并阻止危险 Git 命令（如 push、reset --hard），防止误操作。通过安装脚本和修改 settings.json 实现项目级或全局级的安全保护。
用户希望防止破坏性 git 操作
需要添加 git 安全钩子
要求在 Claude Code 中阻止 git push/reset
npx skills add mattpocock/skills --skill git-guardrails-claude-code -g -y
指导将测试文件中的 TypeScript as 类型断言迁移至 @total-typescript/shoehorn，通过 fromPartial 和 fromAny 实现类型安全的部分数据传递。
用户提及 shoehorn
需要替换测试中的 as 断言
需要处理部分测试数据
npx skills add mattpocock/skills --skill migrate-to-shoehorn -g -y
根据计划自动创建符合规范的练习目录结构，包含问题、解答和解释文件，生成基础 readme 并运行 lint 校验确保通过。
用户要求搭建新的课程章节或练习集
需要批量生成练习题的骨架代码和目录
npx skills add mattpocock/skills --skill scaffold-exercises -g -y
自动配置前端仓库的 Git 预提交钩子，集成 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
通过迭代提问压力测试用户计划或决策，构建设计树并梳理依赖关系。自动获取事实，等待用户确认关键决策，直至达成共享理解。
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
用于在上下文理解不清时，要求以简化技术英语和通用语言重新阐述问题。支持多仓库上下文映射，确保沟通准确。
用户表述模糊或跳跃
需要澄清当前对话状态
npx skills add mattpocock/skills --skill wait-what -g -y
指导如何为AI Agent编写高质量文档（如Skill、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）和术语表等文档。
需要评审设计方案
需要完善技术文档
npx skills add mattpocock/skills --skill grill-with-docs -g -y
通过严格的模拟面试或提问，帮助用户打磨和优化计划或设计方案。
需要优化计划
需要完善设计
npx skills add mattpocock/skills --skill grill-me -g -y
