Agent Skills
› mattpocock/skills
mattpocock/skills
GitHub基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索API选项并选出最优解。
安装全部 Skills
npx skills add mattpocock/skills --all -g -y
集合内 Skills (52)
按质量分展示前 50 个（共 52 个），完整列表请用安装命令预览或逐个打开详情。
基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索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
该技能用于代码审查，通过并行子代理从规范符合度和编码标准两个维度评估变更。支持指定固定点进行差异分析，自动识别需求文档和代码规范，并基于Fowler异味基准提供改进建议。
用户请求审查分支或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
用于构建和精炼项目领域模型，通过挑战术语、澄清模糊语言、设计边界场景及交叉验证代码，动态更新GLOSSARY.md和ADR，确保领域语义精确一致。
讨论代码库术语定义
编写或编辑 GLOSSARY.md
记录或编辑架构决策记录 ADR
npx skills add mattpocock/skills --skill domain-modeling -g -y
根据规格说明书和任务图，协调多个子代理并行实现功能。通过探索、编码、合并及代码审查流程，将需求转化为集成分支上的完整代码实现。
用户要求根据 Spec 和 Tickets 实现功能
需要自动化执行复杂的开发任务流
npx skills add mattpocock/skills --skill implement-spec -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 事实、查阅技术文档或委托背景研究任务时。
用户需要对特定主题进行调研
用户需要收集文档或 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
初始化仓库以适配工程技能集，通过探索现有配置（如 Issue 追踪、标签体系、领域文档），引导用户确认并生成标准化的脚手架设置。
首次使用工程技能前需初始化仓库
需要配置 Issue 追踪器或领域文档结构
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
提供测试驱动开发(TDD)的最佳实践指南，涵盖红绿重构循环、良好测试的定义、Seam边界选择及反模式识别，指导用户编写高质量、行为导向的集成与单元测试。
用户希望先写测试后实现功能
提及 red-green-refactor 流程
需要构建或修复集成测试
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的自动化分类与状态流转。根据Bug或增强请求进行归类，通过状态机将任务推进至待处理、需信息、就绪Agent或人工阶段，并生成Agent可用的简报，实现需求的高效分流与处理。
用户询问需要关注的Issue或PR
指定Issue或PR编号要求处理
要求移动Issue到特定状态
查询可被Agent接手的工作
npx skills add mattpocock/skills --skill triage -g -y
用于规划超出单次会话的大型任务，通过在 Issue Tracker 上创建共享地图和决策票来梳理路径。默认侧重规划而非执行，将模糊需求转化为清晰的决策序列，直至目标明确。
任务规模过大，无法在单个 Agent 会话中完成
需求模糊，需要先制定计划或明确决策再执行
npx skills add mattpocock/skills --skill wayfinder -g -y
生成交互式Bash向导脚本，引导人类完成手动配置、凭证设置或一次性迁移等繁琐步骤。适用于基础设施预配、CI密钥配置及第三方仪表板操作，通过标准化模板实现分步确认与数据捕获。
需要引导用户手动完成复杂的初始化配置
涉及敏感凭证（如API Key）的获取与写入
执行一次性数据迁移或服务切换
指导不熟悉第三方平台界面的操作流程
npx skills add mattpocock/skills --skill wizard -g -y
通过多轮迭代构建设计树，每轮询问当前前沿决策并推荐答案。自动调用子代理获取事实而非询问用户，直至所有分支确认，达成共同理解。
需要系统性梳理复杂设计决策
需要通过交互式问答建立项目共识
npx skills add mattpocock/skills --skill batch-grill-me -g -y
作为首席参谋协调子代理执行长期目标，通过Wiki维护跨会话知识并制定策略。支持多任务并行与上下文隔离。
需要协调多个子代理完成复杂长期任务
希望建立持久化知识库以积累团队经验
npx skills add mattpocock/skills --skill chief-of-staff -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，强制实施深模块架构。通过配置规则限制外部仅能访问包入口文件，隐藏子目录实现，禁止循环依赖，确保清晰的模块边界和接口规范。
需要为 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
辅助用户将原始素材转化为结构化文章。通过确立前置知识、逐步生成并确认内容节拍，实现交互式写作流程，确保概念逻辑连贯且读者易于理解。
需要撰写长篇文章或教程
希望以互动方式构建内容结构
整理杂乱素材为有序文章
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），防止误操作。支持按项目或全局范围安装，提供脚本部署、配置合并及验证步骤。
用户希望阻止危险的 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
用于创建符合规范的练习目录结构，包含问题、解答和解释模块。自动处理命名、生成存根文件并执行 lint 验证，确保通过代码检查后提交。
用户要求创建练习题或课程章节结构
需要初始化 exercise 目录并生成 stub
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
通过多轮问答构建决策树，对用户的计划或想法进行压力测试和深度挖掘。Agent负责探索事实并引导用户确认决策，直至达成共享理解，确保思维严谨性。
希望压力测试思考
使用 'grill' 触发词
npx skills add mattpocock/skills --skill grilling -g -y
将当前对话内容压缩为交接文档，保存至系统临时目录。包含建议技能列表、引用现有工件路径并脱敏敏感信息，帮助新代理无缝延续工作。
需要暂停当前任务并将上下文传递给其他 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
指导如何为 Agent 编写文档（如 Skill、AGENTS.md），涵盖上下文指针优化、认知/上下文负载管理及信息层级结构，旨在提升指令遵循的可靠性与效率。
创建或编辑 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 正文撰写模板，指导使用图表、Diff 和伪代码展示变更摘要、证据及合并风险，规范 Pull Request 的描述结构与可视化表达方式。
需要撰写或优化 Pull Request 描述
整理代码变更的视觉化表达
npx skills add mattpocock/skills --skill pr -g -y
对编码会话进行回顾，分析导航、自动化检查、编码标准等改进点，优化未来 Agent 运行环境。
用户要求进行代码会话回顾
需要分析 Agent 表现并建议环境改进
npx skills add mattpocock/skills --skill retro -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
