Playwright MCP Skill

Claude代码的超级强大扩展

](https://github.com/sponsors/MarcelRoozekrans)

扩展技能 超级大国 套件，为web应用程序开发提供质量门、开发工作流技能和项目生命周期管理。它包括十一项技能：

• 回归检验 --使用 微软Playwright MCP服务器，将现有的测试套件执行与人工智能驱动的视觉和功能浏览器测试相结合。
• 推前审查 --一种结构化的分支审查，在计划遵守、代码质量、提交卫生和回归测试方面与基础分支和关卡不同，产生通过/失败的判断，并对失败制定优先补救计划。
• 重构分析 --复杂重构的传递性影响分析。在编写实施计划之前，映射所有受影响的文件，对破坏性更改和外观更改进行分类，识别风险，并生成具有检查点边界的安全执行顺序。
• 决策跟踪器 --使用持续的跨领域决策跟踪 长期记忆MCP在头脑风暴和规划过程中自动提取架构决策、约定和约束，将其持久化到语义长期记忆中，并在会话开始和子代理调度时回忆起来，以防止决策失忆症。
• 压缩内存 --压缩自然语言内存文件(CLAUDE.md, STATE.md, ROADMAP.md，项目注释）以保存每次会话回放的输入令牌。纯粹的标记技巧——保留代码块、URL、文件路径、前体、标题、表和列表结构的字节精确性；将原始文件备份到 FILE.original.md 在每次压缩之前。通过以下方式选择加入 project-orchestration:plan-roadmap；由自动调用 pause-work.灵感来自 穴居人压缩术 （麻省理工学院），但在没有Python工具链的情况下重新实现。
• 罗斯林编码透镜集成 --超级大国集成 Roslyn CodeLens 情报。强制使用24语义。NET代码分析工具（代替Grep/Glob和 dotnet build)涵盖所有超能力技能——头脑风暴、重构分析、编写计划、执行计划、子代理驱动开发、系统调试、TDD、验证、代码审查和预推审查。
• memorylens集成 --超级大国集成 记忆镜头 内存分析。增强 systematic-debugging 与。NET内存快照分析、泄漏检测以及修复验证前后。直接触发“内存泄漏”、“OOM”、“GC压力高”。非惰性。NET项目。
• 项目编排 --GSD启发了大型多会话项目的项目生命周期管理。Brownfield代码库映射、里程碑跟踪、阶段管理、会话暂停/恢复、里程碑审计、发布周期管理和 start-next-phase 机械地链接头脑风暴的路由中心→ 撰写计划→ 执行下一个未完成阶段的计划。
• ui工作流 --前端设计合同和视觉审计。在实施前端阶段之前生成结构化的UI设计合同(ui-phase)并在之后进行视觉审计(ui-review)使用三层评分：合同遵守、反斜率扫描和5维批评。
• ui设计系统 --在前端实现之前生成一个完整的设计系统。三种模式： 精选的 （从70个供应商提供的真实世界参考中挑选——条纹、线性、Vercel、Notion、苹果、Figma、Supabase、Cursor、Claude……）， 引导的 （7个问题），或 快 （内联单层）。包括5个手动调整的OKLch设计说明和一个防斜坡检查表。自动检测JOIN、React、Vue、Astro堆栈。输出 docs/design/MASTER.md.
• 小队 --持久的AI代理团队（负责人、后端工程师、前端工程师、测试人员、Scribe） 并行发送 Task 子代理 在头脑风暴和规划工作流程期间。每个专家都在一个孤立的上下文窗口中运行，有自己的章程和一级历史，因此他们不能依赖彼此的推理。按角色 history.md 文件在会议中积累了特定于项目的知识；分层上下文查找（语义搜索→ grep → 最近的历史）使每个子代理的快速精简。

______________________________________________________________________

回归测试技能

调用时，Claude遵循一个结构化的4阶段流程：

1. 发现 --扫描项目中现有的测试框架（Playwright、Cypress、Jest、Vitest、Mocha、Karma）、测试文件、路由定义和应用程序URL。

1. 现有测试执行 --运行任何发现的测试套件并捕获通过/失败/跳过结果。记录故障，但不会阻止下一阶段。

1. 基于浏览器的测试 --使用Playwright MCP工具：

- 浏览每个发现的页面 - 处理身份验证（检测到登录表单时提示输入凭据） - 检查控制台错误和失败的网络请求 - 使用验证元素可见性和内容 browser_verify_* 断言工具 - 以3种视口尺寸（台式机1920x1080、平板电脑768x1024、移动设备375x812）截取屏幕截图 - 使用Claude的视觉评估每个屏幕截图的布局、间距、排版、颜色/对比度、响应性、视觉完整性和整体抛光度

1. 报告 --生成带有时间戳的标记报告，其中包含嵌入式屏幕截图、逐页调查结果和优先推荐。还会在对话中打印一个简洁的摘要。

用法

通过询问克劳德来调用该技能：

• “回归测试我的web应用程序 http://localhost:3000"
• “对此应用程序运行可视化回归检查”
• “在部署之前对UI进行冒烟测试”
• /regression-test

输出

该技能产生：

• 截图 保存到 docs/regression-screenshots/YYYY-MM-DD-HHmm/ 文件名如下 home-desktop.png, dashboard-mobile-full.png
• Markdown报告 保存到 docs/regression-report-YYYY-MM-DD-HHmm.md 包含汇总表、现有测试结果、逐页发现和建议
• 对话摘要 总体状态、问题计数和前3项发现

______________________________________________________________________

推前审查技巧

预推送审查技能提供了一个全面、结构化的分支审查，可以在推送代码或创建拉取请求之前运行。它审查了四个维度上的每一个变化，并得出明确的通过或失败的结论。

它的作用

审查涵盖四个方面：

1. 计划遵守情况 --验证计划中的工作是否已完成，以及是否有任何计划外的工作悄悄进入。将差异与中发现的计划文档进行比较 docs/plans/.
2. 代码质量 --根据7条代码质量规则审查差异：安全性（OWASP Top 10）、YAGNI/过度工程、调试/临时代码、死代码/未使用的导入、错误处理、命名/可读性和测试覆盖率。
3. 承诺卫生 --检查提交的机密、大文件、意外文件（node_modules、构建工件）、合并冲突标记和提交消息质量。
4. 回归测试 --运行现有的测试套件，并可选择通过回归测试技能调用基于浏览器的回归测试。

六个阶段

判决逻辑

在FAIL时，报告包括一个优先补救计划，其中包含特定的文件/行引用、建议的修复和工作量估算。

用法

通过询问克劳德来调用该技能：

• “在我推之前查看此分支”
• “运行推送前质量检查”
• “这家分行准备好进行公关了吗？”
• /pre-push-review

输出

该技能产生：

• Markdown报告 保存到 docs/pre-push-review-YYYY-MM-DD-HHmm.md 带有标题指标、每个阶段的发现和补救计划（在失败时）
• 对话摘要 包括判决、问题计数、前三大发现和报告路径

______________________________________________________________________

重构分析技巧

调用时，Claude遵循一个结构化的7阶段流程：

1. 范围定义 --阅读设计文档，识别所有重构目标（类、函数、模块、文件），对重构类型进行分类（重命名、移动、提取、内联、更改接口、架构），并与用户确认。

1. 直接依赖关系映射 --在代码库中搜索对每个目标的所有直接引用：导入、类型注释、函数调用、配置引用、基于字符串的引用和测试文件引用。

1. 传递闭包 --通过检查每个受影响文件的公共接口是否更改，扩展到直接依赖之外。如果是这样，则将这些导出视为新目标，并重复搜索，直到没有发现新文件。

1. 影响分类 --将每个受影响的文件分类为“中断”（将在没有更改的情况下失败）、“需要更新”（功能不正确）、“测试影响”（测试需要更新）或“外观”（可选清理）。

1. 风险识别 --标记动态引用、跨境影响、循环依赖、高扇入节点、隐式耦合、运行时注册、外部消费者和序列化状态。

1. 安全执行令 --生成具有检查点边界的拓扑排序的变更组序列，可以在其中运行测试和进行提交。

1. 输出 --生成带有时间戳的降价影响分析文档，其中包含摘要指标、Graphviz依赖关系图、带注释的文件列表、风险登记簿和执行顺序。然后过渡到写计划。

用法

通过询问克劳德来调用该技能：

• “分析此重构的影响”
• “如果我重命名此模块，哪些文件会受到影响？”
• “在开始之前，请运行重构影响分析”
• /refactor-analysis

输出

该技能产生：

• 影响分析文件 保存到 docs/plans/YYYY-MM-DD--impact-analysis.md 具有汇总表、依赖关系图、带注释的文件列表、风险寄存器和执行顺序
• 对话摘要 使用重构类型，按分类、最高风险和文档路径统计受影响的文件数

______________________________________________________________________

决策跟踪技能

决策跟踪技能提供了持久的跨领域决策跟踪，与超级头脑风暴和规划工作流程相结合。它使用 长期记忆MCP 作为其持久层。

它的作用

该技能以两种模式运行：

1. 召回 --在会话开始时，搜索长期记忆中标记为当前项目的决策，并按类别（架构、约定、特定任务）分组显示。

1. 提取 --在头脑风暴、制定计划和重构分析过程中，会自动识别跨领域决策，并使用适当的标签、类型和重要性级别将其保存到长期记忆中。

决策类别

子代理集成

当子代理驱动的开发调度并行代理时，该技能使用语义搜索将2-3个最相关的决策注入每个代理的提示中——保持上下文集中，而不是用每个决策淹没代理。

优雅降级

如果没有安装LongtermMemory MCP，该技能仍然可以识别决策并将其嵌入计划文档中。它提示用户安装LongtermMemory MCP以实现跨会话持久性。

用法

该技能在超能力工作流程中自动激活。不需要显式调用。您也可以直接调用它：

• /decision-tracker

______________________________________________________________________

Roslyn CodeLens集成技能

roslyn codelens集成技能增强了头脑风暴和语义重构分析。NET代码智能 罗斯林编码透镜 MCP工具可用。它会自动激活，无需显式调用。

它的作用

该技能使用语义Roslyn查询升级了基于文本的代码搜索：

• 头脑风暴期间： 呼叫 get_project_dependencies 对于解决方案架构， get_symbol_context 对于请求中提到的类型， find_implementations 和 find_callers 在实际代码中澄清问题，以及 get_di_registrations / find_reflection_usage 在提出方法时。

• 重构分析期间： 将Grep替换为 find_callers 和 find_implementations 在阶段2（依赖关系映射）中，使用 get_type_hierarchy 和 get_project_dependencies 对于阶段3（传递闭包），并添加 find_reflection_usage 第5阶段（风险识别）捕捉隐藏的动态耦合。

优雅降级

如果roslyn codelens MCP工具不可用，则该技能完全无效。头脑风暴和重构分析回归到他们基于Grep/Glob的标准方法，没有错误或警告。

______________________________________________________________________

记忆镜头集成技能

memorylens整合技能增强 superpowers:systematic-debugging 与。NET内存分析 memorylens mcp 工具可用。它会自动激活——不需要显式调用——并直接在用户短语上触发，如“内存泄漏”、“OOM”、“高GC压力”或“进程内存不断增长”。

它的作用

内存分析被注入到两个调试阶段：

• 第一阶段——根本原因调查： ensure_dotmemory 验证dotMemory CLI， list_processes 找到目标。NET进程， snapshot 在不停止进程的情况下捕获内存状态，以及 analyze 运行10规则引擎（ML001-ML010），涵盖事件处理程序泄漏、静态集合增长、未解决的可处置项、LOH碎片、热路径分配、关闭保留等。
• 第3阶段——假设检验： compare_snapshots 验证所提出的修复是否确实降低了保留率——以可配置的延迟和差异增长、新类型和保留字节捕获两个快照。“看起来正确”但不移动快照的修复被拒绝。

该技能还将其规则知识应用于 superpowers:brainstorming 上。NET项目——在编写代码之前，将内存风险模式（事件订阅、静态缓存、IDisposable所有权、大缓冲区）标记为设计问题。

优雅降级

如果MemoryLens MCP工具不可用，则该技能完全无效。系统调试退回到标准假设检验，没有错误或警告。

用法

当系统调试开始时，该技能会自动激活。NET进程。您也可以直接调用它：

• “调查中的内存泄漏 OrderService"
• “生产中的OOM，快照工人”
• “身份验证修复后的配置文件内存”
• /memorylens-integration

______________________________________________________________________

项目编排技能

项目编排技能为大型多会话项目提供了受GSD启发的项目生命周期管理。它环绕着超级大国的工作流程，而没有取代它——在头脑风暴、计划和执行的基础上增加了导航和状态持久性。

子技能

状态文件

所有状态都存储在 docs/planning/ 在项目根目录（commit或gitignore——由您选择）：

• docs/planning/ROADMAP.md --所有具有完成状态的里程碑和阶段
• docs/planning/MILESTONE.md --当前活动里程碑定义和完成定义
• docs/planning/STATE.md --会话切换文件由以下人员编写 pause-work，阅读者 resume-work

用法

该技能在会话上下文中自动激活。您也可以直接调用它：

• “我们在项目中处于什么位置？”→ progress
• “今天我受够了”→ pause-work
• “从上次会话恢复”→ resume-work
• “添加身份验证阶段”→ add-phase
• “验证里程碑1是否完成”→ audit-milestone
• /project-orchestration

幸存的对话压缩

当长会话被自动压缩时（VS Code Copilot Chat、长Claude Code会话等），生成的摘要通常包含一个带有代码级指令的“延续计划”。 代理将这些视为用户指令，并绕过工作流 --没有 STATE.md 阅读，无计划检查，直接实施。看 问题#77.

该技能的难度包括一个压缩后训练部分，该部分将压缩称为显性 resume-work 触发并指示代理将压缩摘要视为建议而非权威。为了可靠地点火：

• 保持 docs/planning/STATE.md 电流。 pause-work 写它； complete-phase 和 complete-milestone 保持RODMAP/MILESTONE的最新状态，这样STATE.md的漂移就不会超过活动阶段。
• 参考计划文件，而不是在摘要中内联代码级步骤。 当您生成手动会话摘要或交接单时，请选择 Continue from docs/superpowers/plans/2026-05-04-m7.md step 3 结束 fix the auth method to handle null tokens.参考>召回。
• 如果使用自动压缩的主机（VS Code Copilot Chat是最严重的违规者），压缩后的第一条消息应该是 resume --这很明显 resume-work 直接触发，避开任何压缩摘要启发式。

______________________________________________________________________

压缩记忆技能

压缩内存技能压缩自然语言内存文件，以保存每次Claude Code会话重放的输入令牌，同时保留下游消费者（技能或人类）可能键入的每个字节。

这是 输入令牌压缩输出风格的“穴居人演讲”显然不在范围内——它将与该套件中产生结构化工件的所有其他技能相抗衡。

它的作用

调用时，该技能：

1. 确认 该文件是可压缩的（允许扩展名，不在denylist上，小于50kB，每个文件没有 compress: skip 选择退出）
2. 备份 原始到 .original.md （仅在第一次压缩时，后续运行不会影响备份）
3. 压缩 按照“删除/替换”规则的散文——删除文章、填充词、寒暄、含糊其辞、连接绒毛；用较短的对等词替换冗长的措辞
4. 保留字节精确值： 围栏代码块、缩进代码块、内联代码跨度、URL和markdown链接、文件路径、shell命令、环境变量、版本号、日期、frontmatter块、markdown表、标题和列表嵌套
5. 结构验证 --代码块、标题、URL、表格的计数必须与输入匹配；前体字节相等；代码块字节相等
6. 从备份中恢复 如果验证失败（没有部分损坏）
7. 报告 用户的大小增量

Denylist（硬编码，不可配置）

该技能用于操作：

• docs/plans/** --按字面意思阅读计划文件 executing-plans, subagent-driven-development
• *ui-contract* --UI合同审核人 ui-workflow:ui-review
• *impact-analysis* --用细致入微的风险登记散文重构影响分析
• *-design.md --头脑风暴设计文件
• *-review-*.md --预推审核报告和UI审核
• MILESTONE.md --仅在里程碑转换时重写
• *.original.md --备份文件（从不压缩，从不覆盖）
• 什么都没有 .md 或 .txt，或大于50kB

这些文件是 技能之间的契约压缩它们会破坏下游消费者。

通过项目编排选择加入

该技能是可选择的 project-orchestration:plan-roadmap，询问用户是否启用压缩。答案作为YAML frontmatter保留在 docs/planning/ROADMAP.md:

---
compress_memory: enabled
---

当启用时， pause-work 调用 compress-memory 上 STATE.md 写完之后（和 ROADMAP.md 自上次提交以来发生了变化）。压缩故障会被记录下来，永远不会被阻止 pause-work --即使压缩中断，地方政府仍然是真相的来源。

将字段翻转为 disabled （或删除它）在后续操作中停止自动压缩 pause-work 跑。

手动使用

无论选择加入设置如何，该技能始终可以手动使用：

• `/compress-memory

`

• “compress STATE.md”
• “收缩CLAUDE.md”
• “压缩此内存文件”

输出

• 修改文件 --输入文件被压缩版本就地覆盖
• 备份 — .original.md 包含原始的第一个写入副本（例如。 docs/planning/STATE.md → docs/planning/STATE.original.md)
• 对话报告 --尺寸增量(Before / After / Saved)以及备份路径

先决条件

不需要额外的工具。在活动的Claude Code对话中运行——没有Python，没有额外的MCP服务器。

归因

______________________________________________________________________

UI工作流技能

ui工作流技能提供了两种互补的功能，弥补了前端工作中的设计实现差距。

子技能

ui-phase --在实现前端阶段之前运行。生成一份结构化的UI设计合同，包括：

• 设计系统标记（颜色、排版、间距、组件库）
• 包含道具API、变体和交互状态的组件库存
• 桌面（≥1280px）、平板电脑（768–1279px）和移动设备（\` → 策划模式
• “让它看起来像线性”→ 策划模式（从引导模式到中间流切换）
• “创建设计系统”→ 引导模式（7个问题）
• ui-design-system: → 快速模式
• /ui-design-system

输出

技能产生 docs/design/MASTER.md --一个包含所有令牌、模式、堆栈特定实现片段和（在策划模式下）偏差跟踪的单一真理源设计系统文档。

先决条件

不需要额外的工具。

______________________________________________________________________

小队技能

Squad在您的Claude Code会话中创建持久的AI代理团队。小队没有将克劳德视为一名助理，而是派遣了五名专家——主管、后端工程师、前端工程师、测试人员和抄写员——作为 平行 Task 子代理 他们积极参与超级工作流程，并在会议中更加明智地对待你的项目。

运作原理

每位专家都在 孤立的 Task 子代理上下文窗口 --而不是作为上下文中的角色。当一个问题被发送给一个或多个专家时：

1. 路由 --对战 routing.md 确定相关专家——可能不止一位。
2. 按专家分层查找 --提取该专家最相关的部分 history.md:

1. 语义搜索 （长期内存MCP）--最快的跨会话 1. 格雷普历史 --关键字与历史文件匹配 1. 近代史 --仅最后50行 1. 完整历史加载 --最后手段 1. 仅限包机 --还没有历史记录

1. 并行调度 --所有相关专家都以 Task 电话 在一条助理消息中，这会导致Claude Code同时将它们扇出。每个子代理的提示都有相同的四块形状：章程+最近的项目历史记录+路由问题+响应规则（前缀为角色的表情符号+名称，在适用时引用历史记录，标记 [new-decision] 为了 squad-sync).
2. 整合 --当所有子代理返回时，主对话将以稳定的顺序显示其前缀响应（Lead、Backend、Frontend、Tester、Scribe）。对于需要单一答案的工作流(writing-plans 审查， pre-push-review 判决， plan-roadmap 然后，Lead作为最终子代理被分派，之前的输出作为输入。

作为单独的子代理进行调度（而不是内联语音交换）的要点是 隔离专家们真的看不到对方的推理，所以第二个永远不会依赖于第一个。

代理

工作流集成

• 头脑风暴 --多专业澄清问题并行派遣所有相关专家 Task 消息；主对话呈现前缀响应
• 撰写计划 --计划起草后，测试员+抄写员并行派遣；这两个发现合并成一个 ## Squad Review 部分
• 子代理驱动开发 --小队用角色特定的一级历史丰富了每个任务子代理的提示（与小队自己的调度正交——两者可以并行运行）
• 推前审查 --第2阶段（抄写员/决策）和第3阶段（测试人员/风险）在证据收集过程中并行调度
• 项目编排 — squad-sync 汽车点火 pause-work. plan-roadmap 同时派遣所有五名专家进行路线图范围透视，然后Lead进行综合
• 调度并行代理 --较低级别的超能力控制如何构建多呼叫消息；小队的路由层决定 *哪个* 专家，技能主宰一切 *怎么* 呼叫已发出

自动学习

在会话结束时，后台代理提取学习内容，并将注明日期的条目附加到每个代理的条目中 history.md --不需要提示。经过几次会话后，代理知道您的身份验证模式、命名约定、风险区域等。指示下属用以下符号标记新的项目决策 [new-decision] 所以 squad-sync 可以可靠地拾取它们。

用法

• “初始化我的小队”→ squad-init
• “我的团队里有谁？”→ squad-status
• @backend how does our auth work? → squad-ask
• “小队同步”→ squad-sync （手动检查点）
• /squad

输出

小队制作并维护：

• ~/.claude/squad/agents/{name}/history.md --全球代理智慧
• .squad/agents/{name}/history.md --项目特定知识
• .squad/decisions.md --共享团队决策日志

安装

claude plugin install squad

不需要MCP服务器。可选安装 longterm-memory 对于第1层中的语义搜索：

claude plugin install longterm-memory

______________________________________________________________________

生态系统

超级大国扩展是整个超级大国扩展生态系统的单一入口点。一次安装即可获取核心超能力技能和所有配套插件：

MCP描述压缩（可选，未捆绑）

如果MCP工具描述使您的上下文窗口膨胀，特别是Playwright的上下文窗口，它很大-- caveman-shrink 是一个Node中间件，它封装任何MCP服务器并在启动时压缩工具描述。它故意不捆绑在这个套件中，因为它是MCP运行时基础设施，而不是克劳德代码技能。这两个压缩项目位于不同的层： compress-memory （此套件）压缩磁盘上的持久文件； caveman-shrink （单独）压缩内存中的每个会话MCP描述。单独安装 npm install -g caveman-shrink 如果相关。

GitHub副本支持

这些技能也可以通过以下方式与GitHub Copilot一起使用 副驾驶技能桥 --一个VS Code扩展，可以发现Claude市场技能，将其转换为与Copilot兼容的提示/指令文件，并导入MCP服务器配置。将此仓库添加为市场源，网桥将可传递地解决所有依赖关系。

______________________________________________________________________

多提供商支持

真理的来源是共享的 plugins//skills//SKILL.md 树 markdown文件。每个受支持的编码代理线束都有一个清单，位于 repo根指向相同的文件。技能内容不变 每条线束；只有安全带如何装载它们。

多态性 hooks/session-start 脚本 通过环境变量检测哪个线束正在运行它(CURSOR_PLUGIN_ROOT, CLAUDE_PLUGIN_ROOT, COPILOT_CLI)并发出JSON形状 线束预期(additional_context 对于光标， hookSpecificOutput 对于Claude Code，顶级 additionalContext 适用于SDK标准主机 包括Copilot CLI）。 hooks/run-hook.cmd 是 在Windows主机上路由到Git Bash的Windows多语言包装器。

是什么 不 支持

老实说：VS代码副驾驶聊天(.github/copilot-instructions.md), Copilot Workspace、Aider、Continue和Windsurf是 不 有针对性的 通过这些表现。对于VS Code Copilot Chat，请使用 分开 副驾驶技能桥 如上所述，它将克劳德的市场技能转化为Copilot 项目级别的指令/提示文件。

注意事项

• **Cursor/Codex/Gemini/Copilot CLI/OpenCode集成是

尽最大努力。** 图案改编自 obra/superpowers （麻省理工学院）。在将其用于生产之前，请在您的环境中进行验证 工作——其中一些线束的底层插件格式是 仍在发展。

• 不 using-superpowers-extensions 引导技能。 这间套房

背上小猪 obra/superpowers 用于训练元技能 代理通过技能工具调用技能。安装 obra/superpowers 此外（它已经是一种市场依赖性 此回购）。

• 70个自主设计系统 在...之下

plugins/ui-design-system/skills/ui-design-system/design-systems/ 带着每一条安全带旅行——它们都是明确的标记，每一条都是安全带 读他们。

模式归因

这里的多提供者机制直接改编自 obra/superpowers （麻省理工学院）。他们的 会话开始挂钩是我们的模型；他们的安全带清单 模式使一个共享的markdown树能够以本机方式加载 每个主机。区别：我们是一个有11个插件的市场（与 他们的单一插件布局），因此我们的清单针对的是 通过以下方式解决技能问题的repo根 ./plugins/.

______________________________________________________________________

安装

选项A：作为Claude代码插件安装（推荐）

直接从GitHub安装——这个命令将超级能力核心技能、LongtermMemory MCP和roslyn codelens MCP作为可传递依赖项引入：

claude install gh:MarcelRoozekrans/superpowers-extensions

然后从市场上安装所需的插件：

# Install all extension skills
claude plugin install regression-test
claude plugin install pre-push-review
claude plugin install refactor-analysis
claude plugin install decision-tracker
claude plugin install roslyn-codelens-integration
claude plugin install memorylens-integration
claude plugin install project-orchestration
claude plugin install ui-workflow
claude plugin install ui-design-system
claude plugin install squad
claude plugin install compress-memory

回归测试插件自动配置Playwright MCP服务器 --caps=testing预推审查插件只需要git，不需要额外的MCP服务器来进行核心审查。

选项B：从本地克隆安装

克隆存储库并作为本地市场安装：

git clone https://github.com/MarcelRoozekrans/superpowers-extensions.git
claude install /path/to/superpowers-extensions

# Install one or more plugins
claude plugin install regression-test
claude plugin install pre-push-review

# Install the refactor analysis skill
claude plugin install refactor-analysis

选项C：手动安装

如果您更喜欢手动设置：

1.添加Playwright MCP服务器（回归测试需要，推送前审查可选）：

claude mcp add playwright -- npx @playwright/mcp@latest --caps=testing

这 --caps=testing 标志启用断言工具(browser_verify_*, browser_generate_locator)在功能检查期间使用。

2.复制技能档案：

# Windows -- regression-test
xcopy /E /I plugins\regression-test\skills\regression-test %USERPROFILE%\.claude\skills\regression-test

# Windows -- pre-push-review
xcopy /E /I plugins\pre-push-review\skills\pre-push-review %USERPROFILE%\.claude\skills\pre-push-review

# macOS / Linux -- regression-test
cp -r plugins/regression-test/skills/regression-test ~/.claude/skills/regression-test

# macOS / Linux -- pre-push-review
cp -r plugins/pre-push-review/skills/pre-push-review ~/.claude/skills/pre-push-review

# Windows -- refactor-analysis
xcopy /E /I plugins\refactor-analysis\skills\refactor-analysis %USERPROFILE%\.claude\skills\refactor-analysis

# macOS / Linux -- refactor-analysis
cp -r plugins/refactor-analysis/skills/refactor-analysis ~/.claude/skills/refactor-analysis

# Windows -- decision-tracker
xcopy /E /I plugins\decision-tracker\skills\decision-tracker %USERPROFILE%\.claude\skills\decision-tracker

# macOS / Linux -- decision-tracker
cp -r plugins/decision-tracker/skills/decision-tracker ~/.claude/skills/decision-tracker

# Windows -- roslyn-codelens-integration
xcopy /E /I plugins\roslyn-codelens-integration\skills\roslyn-codelens-integration %USERPROFILE%\.claude\skills\roslyn-codelens-integration

# macOS / Linux -- roslyn-codelens-integration
cp -r plugins/roslyn-codelens-integration/skills/roslyn-codelens-integration ~/.claude/skills/roslyn-codelens-integration

# Windows -- memorylens-integration
xcopy /E /I plugins\memorylens-integration\skills\memorylens-integration %USERPROFILE%\.claude\skills\memorylens-integration

# macOS / Linux -- memorylens-integration
cp -r plugins/memorylens-integration/skills/memorylens-integration ~/.claude/skills/memorylens-integration

# Windows -- project-orchestration
xcopy /E /I plugins\project-orchestration\skills\project-orchestration %USERPROFILE%\.claude\skills\project-orchestration

# macOS / Linux -- project-orchestration
cp -r plugins/project-orchestration/skills/project-orchestration ~/.claude/skills/project-orchestration

# Windows -- ui-workflow
xcopy /E /I plugins\ui-workflow\skills\ui-workflow %USERPROFILE%\.claude\skills\ui-workflow

# macOS / Linux -- ui-workflow
cp -r plugins/ui-workflow/skills/ui-workflow ~/.claude/skills/ui-workflow

# Windows -- ui-design-system
xcopy /E /I plugins\ui-design-system\skills\ui-design-system %USERPROFILE%\.claude\skills\ui-design-system

# macOS / Linux -- ui-design-system
cp -r plugins/ui-design-system/skills/ui-design-system ~/.claude/skills/ui-design-system

# Windows -- compress-memory
xcopy /E /I plugins\compress-memory\skills\compress-memory %USERPROFILE%\.claude\skills\compress-memory

# macOS / Linux -- compress-memory
cp -r plugins/compress-memory/skills/compress-memory ~/.claude/skills/compress-memory

注： 某些插件需要配套的MCP服务器。分别安装它们：

• 决策跟踪器： claude mcp add longterm-memory -- npx -y longterm-memory-mcp
• 罗斯林编码镜头集成： dotnet tool install -g roslyn-codelens-mcp && claude mcp add roslyn-codelens -- roslyn-codelens-mcp
• memorylens集成： dotnet tool install -g memorylens-mcp && claude mcp add memorylens -- memorylens-mcp

可选剧作家旗帜

# Headed mode (see the browser window)
claude mcp add playwright -- npx @playwright/mcp@latest --caps=testing --headless=false

# All capabilities (testing + PDF export + vision-based coordinates)
claude mcp add playwright -- npx @playwright/mcp@latest --caps=testing,pdf,vision

验证安装

在Claude Code中，当您键入时，技能应该出现 /regression-test, /pre-push-review, /refactor-analysis, /decision-tracker, /roslyn-codelens-integration, /memorylens-integration, /project-orchestration, /ui-workflow, /ui-design-system，或 /squad，或者当您要求Claude执行回归测试、推送前审查、重构影响分析、决策跟踪时。NET代码图分析。NET内存分析、项目生命周期管理、UI设计合同工作、设计系统生成或激活您的代理团队。

______________________________________________________________________

开发工作流程

这些技能是用来作曲的。以下是不同开发场景的标准工作流程，显示了要调用哪些技能以及调用顺序。

启动新项目

当你开始和克劳德一起做项目时，运行一次：

1. squad-init          — set up your persistent agent team
2. project-orchestration map-codebase  — brownfield analysis (existing projects only)
3. decision-tracker    — runs automatically once brainstorming starts

之后，每次训练开始时，克劳德都会回顾之前的决定和球队加载代理的历史。你不需要重新解释你的架构、惯例或之前的选择。

______________________________________________________________________

标准功能开发

构建新功能的核心循环：

brainstorming          → explore the idea, squad answers domain questions
writing-plans          → detailed task plan with file paths and TDD steps
subagent-driven-development  → parallel execution with review between tasks
pre-push-review        → PASS/FAIL gate before push or PR

在实践中：

"Let's build [feature]"        → triggers brainstorming (squad participates)
"Write a plan for this"        → triggers writing-plans (Tester + Scribe review it)
"Execute the plan"             → triggers subagent-driven-development
"Review before I push"         → triggers pre-push-review

______________________________________________________________________

重构现有代码

当更改涉及许多文件或跨越建筑边界时：

refactor-analysis      → transitive impact analysis, safe execution order
writing-plans          → implementation plan scoped to the impact analysis
subagent-driven-development  → parallel execution per change group
pre-push-review        → PASS/FAIL gate

为了。NET代码库 roslyn-codelens-integration 安装后，重构分析会自动使用Roslyn语义查询而不是grep——捕获文本搜索遗漏的动态引用和基于反射的耦合。

在实践中：

"Analyze the impact of renaming X"  → triggers refactor-analysis
"Write a plan based on this"        → triggers writing-plans
"Execute it"                        → triggers subagent-driven-development

______________________________________________________________________

前端开发

在构建或重新设计UI时：

ui-design-system       → generate design tokens and component patterns (once per project)
                         curated mode: pick from 70 vendored references (Stripe, Linear, …)
                         guided mode: 7 questions
                         quick mode: inline one-liner
ui-workflow ui-phase   → generate UI contract before implementing each frontend phase
[implement the phase]  → subagent-driven-development executes the contract
ui-workflow ui-review  → 3-layer audit: contract adherence + anti-slop scan + 5-dim critique
                         verdict is the worst of the three

在实践中：

"Make it look like Linear"                   → ui-design-system curated mode
"Generate a design system for this project"  → ui-design-system guided mode
"Design the UI for this phase"               → ui-workflow ui-phase
"Execute"                                    → subagent-driven-development
"Review the UI"                              → ui-workflow ui-review

______________________________________________________________________

多会话项目

对于跨越多个工作会议和里程碑的更大努力：

project-orchestration map-codebase   → understand the existing codebase
project-orchestration progress       → "where are we?" at each session start
[standard feature/refactor workflows per phase]
project-orchestration pause-work     → checkpoint state + auto squad-sync
project-orchestration resume-work    → restore context at next session
project-orchestration audit-milestone → verify definition of done
project-orchestration complete-milestone → tag release, archive milestone

小队+项目编排： pause-work 自动触发 squad-sync，因此代理历史保持最新，无需任何额外步骤。

______________________________________________________________________

漏洞修复

用于诊断和修复意外行为：

systematic-debugging   → structured root cause analysis before touching code
[fix + TDD]            → write failing test, fix, verify green
pre-push-review        → gate before push

为了。NET内存泄漏具体如下：

systematic-debugging   → identifies memory as the concern
memorylens-integration → snapshot before and after, compare, confirm fix

______________________________________________________________________

技能构成概览

丰富技能（小队、决策跟踪器、roslyn codelens集成）在出现时会自动激活，无需明确调用。

______________________________________________________________________

项目结构

superpowers-extensions/
├── .claude-plugin/
│   └── marketplace.json                    # Marketplace catalog (all plugins)
├── .github/
│   └── workflows/
│       ├── lint.yml                        # markdownlint + commitlint on PR
│       ├── refresh-design-systems.yml      # Weekly auto-refresh of vendored catalog
│       └── release-please.yml              # Release automation
├── scripts/
│   └── refresh-design-systems.sh           # Atomic, idempotent catalog refresh
├── plugins/
│   ├── regression-test/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json                 # Plugin metadata
│   │   ├── .mcp.json                       # Playwright MCP server config
│   │   └── skills/
│   │       └── regression-test/
│   │           ├── SKILL.md                # Main skill -- 4-phase workflow
│   │           ├── visual-criteria.md      # Visual evaluation rubric (7 criteria)
│   │           └── test-framework-detection.md  # Framework & route detection
│   ├── pre-push-review/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json                 # Plugin metadata
│   │   └── skills/
│   │       └── pre-push-review/
│   │           ├── SKILL.md                # Main skill -- 6-phase workflow
│   │           ├── code-quality-rules.md   # 7 code quality review rules
│   │           └── commit-hygiene-rules.md # Commit hygiene checks
│   ├── refactor-analysis/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json                 # Plugin metadata
│   │   └── skills/
│   │       └── refactor-analysis/
│   │           ├── SKILL.md                # Main skill -- 7-phase workflow
│   │           └── reference-types.md      # Reference types catalog
│   ├── decision-tracker/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── decision-tracker/
│   │           └── SKILL.md
│   ├── roslyn-codelens-integration/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── roslyn-codelens-integration/
│   │           └── SKILL.md
│   ├── memorylens-integration/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── memorylens-integration/
│   │           └── SKILL.md                # Phase 1 + Phase 3 augmentation for systematic-debugging
│   ├── project-orchestration/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── project-orchestration/
│   │           ├── SKILL.md                # 14 sub-skills for project lifecycle (with start-next-phase routing hub and plan-roadmap)
│   │           └── state-files.md          # docs/planning/ file format reference
│   ├── ui-workflow/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── ui-workflow/
│   │           ├── SKILL.md                # ui-phase and ui-review sub-skills (anti-slop + 5-dim critique)
│   │           └── ui-contract-template.md # UI design contract template
│   ├── ui-design-system/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── ui-design-system/
│   │           ├── SKILL.md                # curated / guided / quick modes
│   │           ├── domains/                # SaaS / admin / marketing domain rules
│   │           ├── stacks/                 # Astro / Blazor / generic-web / React / Vue stack notes
│   │           └── design-systems/         # 70 vendored real-world DESIGN.md references (MIT)
│   │               ├── INDEX.md            # Categorized catalog with vibe one-liners
│   │               ├── NOTICE.md           # Attribution + refresh instructions
│   │               ├── stripe/DESIGN.md    # Real CSS tokens from production sites
│   │               ├── linear.app/DESIGN.md
│   │               ├── vercel/DESIGN.md
│   │               └── ...                 # 67 more
│   ├── squad/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   └── skills/
│   │       └── squad/
│   │           ├── SKILL.md                # routing, persona switching, sub-skills
│   │           ├── routing-rules.md        # default routing rules reference
│   │           ├── history-format.md       # history.md format spec
│   │           └── default-team/           # default agent charters
│   │               ├── lead.md
│   │               ├── backend.md
│   │               ├── frontend.md
│   │               ├── tester.md
│   │               └── scribe.md
│   └── compress-memory/                    # New plugin (added in this task — 11th plugin)
│       ├── .claude-plugin/
│       │   └── plugin.json
│       └── skills/
│           └── compress-memory/
│               ├── SKILL.md                # Main skill — 5-step flow with hard denylist
│               ├── compression-rules.md    # Drop / Replace / Preserve / Compress rules
│               ├── safety-rules.md         # Denylist, backup invariant, validation
│               └── NOTICE.md               # Attribution to caveman (MIT)
└── docs/
    ├── planning/                           # Project lifecycle state (ROADMAP, MILESTONE, STATE)
    └── plans/                              # Design documents and phase plans

支持的框架

试车手

剧作家、柏树、小丑、Vitest、摩卡、Karma、守夜人、WebdriverIO

路线检测

React路由器、Next.js（应用路由器和页面路由器）、Angular、Vue路由器、SvelteKit

需求

• 克劳德代码
• Node.js 18+
• 回归测试： 微软Playwright MCP服务器 (@playwright/mcp)以及一个正在运行的web应用程序进行测试
• 对于推送前审查： 一个带有功能分支的git存储库。Playwright MCP服务器是可选的（支持基于浏览器的回归测试作为审查的一部分）。
• 对于重构分析： 一个包含要分析的代码的git存储库。不需要额外的工具。
• 对于决策跟踪器： 长期记忆MCP 用于跨会话持久性（通过市场依赖关系自动安装）。在降级模式下无需它即可工作。
• 对于roslyn codelens集成： 罗斯林编码透镜mcp MCP服务器（通过市场依赖关系自动安装）。没有它，技能是惰性的。
• 对于项目编排： 不需要额外的工具。仅使用内置工具（读取、写入、Glob、Bash用于git命令）。状态文件存储在 docs/planning/.
• 对于ui工作流： ui-phase 不需要额外的工具。 ui-review 要求 regression-test 技能及其剧作家MCP先决条件。
• 对于memorylens集成： memorylens mcp MCP服务器（通过市场依赖关系自动安装）。没有它，技能是惰性的——在没有它的情况下可以忽略它。NET项目。
• 对于ui设计系统： 不需要额外的工具。
• 对于小队： 没有硬性要求——可以独立工作。 长期记忆MCP 启用代理历史的一级语义搜索（通过市场依赖关系自动安装）。没有它也能工作，回到基于grep的查找。

许可证

麻省理工学院