Agent Skills
› mattpocock/skills
mattpocock/skills
GitHub基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索API选项并选出最优解。
Install All Skills
npx skills add mattpocock/skills --all -g -y
Skills in Collection (52)
Showing top 50 of 52 by quality score. Use the install list command or open individual skills for the rest.
基于“设计两次”理念，通过并行子代理生成多个截然不同的接口设计方案。涵盖需求收集、多方案生成、展示对比及综合优化，旨在帮助用户探索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
对代码变更进行双维度审查：标准合规性与需求实现度。通过并行子代理分别评估编码规范遵循情况及是否忠实实现原始Issue/Spec，并汇总报告结果。
用户请求审查分支、PR或特定提交范围的代码变更
用户指定从某固定点（如commit、tag）开始进行代码审查
npx skills add mattpocock/skills --skill code-review -g -y
提供深层模块设计的共享词汇与原则，用于指导接口设计、代码重构及提升可测试性。适用于定义模块边界、优化接口复杂度及改善代码可维护性。
设计或改进模块接口
寻找代码深化机会
决定模块接缝位置
提升代码可测试性或AI导航能力
npx skills add mattpocock/skills --skill codebase-design -g -y
用于诊断复杂Bug和性能回归的技能，强调构建紧密的反馈循环以定位问题。触发场景包括用户要求诊断、报告系统故障或性能缓慢时。
用户说'diagnose'或'debug this'
报告系统损坏/抛出异常/失败/变慢
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
根据规格说明书和任务图，协调子代理并行实现功能。通过探索、编码、合并及代码审查流程，将需求转化为集成分支上的完整代码并更新工单状态。
用户要求根据规格说明书实现功能
需要解析任务依赖关系并执行多步开发流程
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 文档及技术细节
希望将阅读和资料搜集工作委托给后台代理
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
配置工程技能所需的仓库环境，包括问题追踪器、分类标签及领域文档布局。通过探索仓库现状并与用户确认，初始化 GitHub/GitLab/本地等配置，为后续技能运行做准备。
需要初始化仓库以使用其他工程技能
配置 Issue Tracker 和 Triage 标签
npx skills add mattpocock/skills --skill setup-matt-pocock-skills -g -y
提供测试驱动开发(TDD)的指导原则，涵盖红绿重构循环、良好测试的定义、接缝选择及反模式识别。用于指导用户以测试优先的方式构建功能或修复缺陷。
用户希望以测试优先方式构建功能
用户提到“红-绿-重构”流程
用户需要编写集成测试
npx skills add mattpocock/skills --skill tdd -g -y
该技能用于基于现有对话和代码库上下文自动生成需求规格说明书（Spec），无需额外访谈。它通过探索仓库、定义测试边界，并依据模板撰写包含问题陈述、用户故事及实现决策的文档，最终发布至项目问题追踪器。
需要将当前讨论内容转化为正式的需求规格说明
需要为即将开发的功能编写标准化的 Spec 文档
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列表
将特定Issue/PR移动到指定状态
npx skills add mattpocock/skills --skill triage -g -y
Wayfinder 用于规划超出单次会话的大规模任务。它将工作分解为 Issue Tracker 上的决策票据，通过逐步解决关键决策来理清路线，默认侧重规划而非执行，确保目标清晰后再移交实施。
需要规划复杂且庞大的开发任务
当前目标模糊需拆解为具体决策点
任务规模超过单次 Agent 会话处理能力
npx skills add mattpocock/skills --skill wayfinder -g -y
生成交互式bash向导，引导用户完成需手动操作的繁琐步骤，如配置基础设施、设置凭证或CI密钥。适用于代理无法自动执行、需人类介入的场景，确保流程清晰且可复用。
需要人工操作才能完成的配置任务
设置敏感凭证或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 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
该技能用于根据原始素材撰写文章。通过迭代式交互，引导用户选择内容路径，确保概念逐步铺垫（Grounding），并逐段生成和保存文章，实现结构化的内容创作流程。
用户提供Markdown格式的原始素材要求写作
需要结构化、交互式地辅助长文或教程创作
npx skills add mattpocock/skills --skill writing-beats -g -y
用于写作探索阶段的技能，通过对话挖掘未结构化素材片段。支持自定义文件路径，自动追加内容至Markdown文件，定义片段类型与格式规范，旨在丰富创作空间而不涉及结构规划。
用户需要收集写作灵感或素材
用户希望进行无结构的头脑风暴
用户要求记录零散的写作想法
npx skills add mattpocock/skills --skill writing-fragments -g -y
将原始素材转化为结构清晰的文章。通过确立读者基础、提供多种开篇选项，并逐段引导式写作，确保概念逻辑连贯（Grounding），最终生成独立的文章文件。
用户要求将零散笔记或草稿整理成文章
用户提供原始素材请求撰写结构化内容
npx skills add mattpocock/skills --skill writing-shape -g -y
配置 Claude Code 钩子以拦截并阻止危险 git 命令（如 push、reset --hard），防止误操作导致数据丢失，提供项目级或全局的安全防护机制。
用户希望阻止危险的 git 操作
需要为 Claude Code 添加 git 安全钩子
用户想限制 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 检查并提交 Git。
用户需要创建新的课程章节或练习模块
用户希望生成练习存根文件并验证格式规范
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
通过构建设计树和分轮提问，对用户计划或决策进行压力测试。自动探查事实并推荐答案，引导用户确认共同理解，直至所有分支被访问。
用户希望压力测试想法
使用 'grill' 触发短语
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
提供面向 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（Pull Request）正文的标准化 Markdown 模板，指导如何编写包含摘要、证据和合并风险评估的结构化描述。
撰写 Pull Request 说明
生成代码变更文档
npx skills add mattpocock/skills --skill pr -g -y
对编码会话进行回顾，分析导航、自动化检查、编码标准等改进点，优化代理环境以提升未来运行效率。
用户要求对编码会话进行回顾
分析代理执行过程中的环境与流程改进机会
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
