Agent Skills
› mattpocock/skills
mattpocock/skills
GitHub基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索API选项并选出最优解。
Install All Skills
npx skills add mattpocock/skills --all -g -y
Skills in Collection (45)
基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索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
对代码变更进行双维度审查：编码规范符合度与需求规格一致性。通过并行子代理对比指定基准点与HEAD的差异，并汇总结果。
用户请求审查分支、PR或工作进度
用户指定'review since X'场景
npx skills add mattpocock/skills --skill code-review -g -y
提供深度模块设计的统一词汇与原则，帮助设计接口、确定分离点、提升代码可测试性与AI导航能力。
设计或改进模块接口
寻找代码深化机会
决定代码分离点位置
提升代码可测试性或AI导航性
npx skills add mattpocock/skills --skill codebase-design -g -y
用于诊断复杂Bug和性能回退的标准化流程。核心在于构建高确定性的反馈循环，通过测试、脚本或二分法快速定位问题根源。包含敏感信息脱敏及非确定性Bug处理策略。
用户请求诊断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，定期运行类型检查和测试，完成后进行代码审查并提交到当前分支。
需要实现新功能或修复bug
根据Spec或Ticket进行编码开发
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合并或变基冲突时，通过审查历史、PR及意图来源，合理保留双方逻辑并解决冲突，随后运行自动化检查修复问题并完成提交。
Git merge conflict occurs
Git rebase conflict occurs
npx skills add mattpocock/skills --skill resolving-merge-conflicts -g -y
用于配置仓库以适配工程技能集，包括初始化Issue追踪器、定义Triage标签及设置领域文档布局。
首次使用前配置仓库
需要建立Issue追踪和文档规范
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
提供测试驱动开发(TDD)的最佳实践指南，涵盖红绿重构循环、公共接口测试边界、反模式识别及垂直切片执行规则，旨在确保编写高质量且可维护的测试。
用户希望以测试优先方式构建功能或修复bug
提及红绿重构流程
需要编写集成测试
npx skills add mattpocock/skills --skill tdd -g -y
将对话上下文和代码库理解综合为需求规格说明书（Spec），并自动发布至项目问题追踪器。该技能无需用户面试，直接基于已有信息生成包含问题陈述、解决方案、用户故事及测试决策的结构化文档。
需要将讨论转化为正式的需求规格文档
准备将功能提案发布到项目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-ready 简报。支持按自然语言指令查询待处理项或手动调整状态，辅助维护者高效分流任务。
用户请求查看需关注的 Issue/PR
指定 Issue 或 PR 的状态变更
询问可交由 Agent 处理的任务
npx skills add mattpocock/skills --skill triage -g -y
用于处理超出单次会话范围的复杂模糊任务。通过在 Issue Tracker 创建共享地图和决策票据，逐步厘清方案直至目标明确，侧重于规划而非执行具体构建。
任务规模大且目标模糊
需要多步骤决策规划
无法在单次会话中完成的工作
npx skills add mattpocock/skills --skill wayfinder -g -y
生成交互式 Bash 向导脚本，引导人类完成基础设施配置、凭证设置或一次性迁移等繁琐手动操作。自动处理 URL 打开、值捕获和环境变量写入，提供分步进度和确认机制，适用于 Agent 无法直接执行的步骤。
需要引导用户进行复杂的手动配置流程
设置第三方服务凭证或 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
通过迭代式提问（Grilling）引导用户明确工作流需求，定义触发器、检查点等规范，并将最终结果保存为工作流规格文件。
需要定义或梳理新的自动化工作流
需要细化现有工作流的执行细节
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
将原始素材转化为结构化文章，通过逐段引导用户选择写作路径。需先确立受众前置知识，随后每次提供2-3个候选段落供选择并写入文件，确保概念逻辑连贯，直至完成整篇文章。
用户提供包含原始素材的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 的 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
通过多轮问答压力测试用户的计划或决策，构建设计树并逐步澄清依赖关系。自动获取事实，引导用户做出选择，直至达成共同理解。
stress-test their thinking
'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
指导如何为Agent编写高质量文档（如Skill、AGENTS.md），涵盖上下文指针优化、加载成本管理及信息层级结构，旨在提升Agent对指令的理解与执行可靠性。
创建或编辑Agent技能文件
修改AGENTS.md或CLAUDE.md等全局配置文件
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
通过持续追问（Grilling）和领域建模来优化计划或设计，并在过程中生成架构决策记录（ADR）和术语表等文档。
需要优化系统设计或方案时
需要创建 ADR 或构建领域模型时
npx skills add mattpocock/skills --skill grill-with-docs -g -y
通过严格的提问和质疑来打磨计划或设计方案，帮助用户发现逻辑漏洞并优化决策。
需要审视和优化现有计划
希望设计受到严格挑战以完善细节
npx skills add mattpocock/skills --skill grill-me -g -y
当对话出现理解偏差或上下文丢失时，要求对方使用简化技术英语和通用语言重新阐述背景与意图，以澄清当前状态。
对话出现误解
上下文信息缺失
npx skills add mattpocock/skills --skill wait-what -g -y
