Skills
收录 97,501 个为 Agent 打包的专项能力与操作指引,复制一行命令即可安装。
测试与质量
判定一个新测试是否应该存在,并强制它高效,从而保护 CI 免受低价值测试膨胀的影响。在对 pytest、Jest 或 Playwright 测试所断言或设置的内容做任何更改之前使用,小到在现有代码块中新增一个 fixture 或一个断言。前置价值标准(每个测试都必须捕捉现有测试未捕捉到的现实回归;在编写新的独立测试之前先扩展最近的现有测试;通过公共接口而非实现细节测试行为;将近似重复的用例合并为参数化用例)与效率标准(确定性、隔离、快速;选择最廉价的测试层级;优先 Django TestCase 而非 TransactionTestCase;无 sleep、无真实网络;不留会随时间对照真实时钟老化的绝对日期时间炸弹;不接入测试从不使用的数据库)。包含一个 "don't write it" 决策树。修复现有 flaky 测试请用 `/fixing-flaky-tests`;在本关卡判定 Playwright 测试确有必要后,用 `/playwright-test` 了解具体做法。
系统化的四阶段调试流程:(1)阅读完整错误信息并复现问题,了解故障;(2)查找可运行示例进行对比;(3)每次只测试一个假设,并只做一项更改;(4)修复根本原因并通过测试验证。包含“三次尝试规则”(修复尝试失败 3 次后升级处理)和“铁律”(未经调查不得修复)。测试意外失败、发生错误、行为异常、原本正常的功能突然损坏或用户报告 Bug 时启用。触发词包括:“debug”、“why is this failing”、“test failure”、“unexpected error”、“bug”、“broken”、“investigate this error”、“fix this bug”、“tests are failing”、“weird behavior”、“something broke”、“track down this issue”。多个 Bug 需要系统化调查时也会启用(逐个处理,不批量修复)。不适用于从零编写新测试(使用 tdd)或常规代码审查(使用 code-review)。
将 Figma 节点的实际规格与代码规格(你的组件渲染出的值)进行比较,获得 0–100 的一致性得分、差异列表和修复建议。用于检测设计到代码的漂移:触发词“check design parity”“does my code match the Figma”“compare this component to the design”“is my implementation faithful”“find differences between design and code”“verify the build matches Figma”“design QA against code”“parity score”。通过 use_figma(任何套餐)读取该节点的视觉/排版/间距/token/无障碍规格,并将其与你提供的 codeSpec 进行差异比对。它补充原生 get_design_context:不是生成代码,而是验证现有代码是否与设计保持同步。
Apache Doris 的全面 SQL 语句检查(基于 Doris 3.1.4 Nereids ANTLR4 grammar),支持两种检查模式:1. 语法检查——关键字验证、语句结构验证、子句完整性、Doris 特定语法兼容性(DISTRIBUTED BY、PARTITION BY、ENGINE、DUPLICATE/AGGREGATE/UNIQUE KEY、INSERT OVERWRITE、LOAD、EXPORT、MTMV、BACKUP/RESTORE 等);2. 规范检查——依据 Apache Doris 开发最佳实践检查对象设计标准、数据操作标准和命名约定。内置自定义 Doris SQL tokenizer(来自 DorisLexer.g4 的 504 个关键字)和递归下降解析器,支持 100 多种 Doris 语句类型。适用于需要对 Apache Doris SQL(版本 2.1.x / 3.0.x / 3.1.x / 4.x)进行 SQL 质量审查、语法验证或规范合规性检查的场景。触发词:“Doris SQL检查”“Doris SQL规范”“Doris SQL审计”“Doris SQL语法”“检查Doris SQL”“Doris SQL review”。
将 Web 操作过程记录为浏览器宿主机上的证据 — 一段 WebM 视频、每次点击和页面加载后的截图(在点击位置带红色标记)以及 steps.md 日志。支持两种方式 — Agent 通过 agent-browser 经 CDP 驱动浏览器,或由人工在 Playwright 启动的窗口中操作,同时脚本进行录制。适用于被要求「record a web journey」「record the flow」「capture a user flow」「show me what you clicked」,或走查过程需要截图和视频作为凭证时。
使用 supertest、MSW 和 Vitest 的 API 测试模式。涵盖 REST API 的集成测试、用 Mock Service Worker v2 模拟 HTTP 请求、响应断言、schema 校验、测试组织,以及针对 Express、Fastify 和 Hono 的框架专属模式。在编写 REST API 集成测试、模拟 HTTP 请求或测试 API 端点时使用。用于 api-test、supertest、msw、mock-service-worker、integration-test、http-mock、endpoint-test、request-test。
指导 Agent 在 PostHog monorepo 中复现、定位根因、修复并验证 flaky 测试。适用于测试在 CI 中偶发失败但在重跑或本地通过时,`hogli ci:insights` 或 debugging-ci-failures skill 将失败归类为 flaky 测试时,拿到 flaky 任务的 GitHub Actions URL 时,被要求检查某个测试、PR 或 master 的 Trunk Flaky Tests 时,或被要求对 flaky 的 Jest、pytest 或 Playwright 测试去抖动、稳定化或修复时。核心准则:更改任何东西之前先在本地复现,修复根因(绝不用 sleep、重试或更大的超时来掩盖),并用与观测到的失败率相匹配的 N 次运行验证循环来证明修复有效。稳定化并非唯一有效的结果——本 skill 还会判定测试是否应该存在,因此删除一个捕捉不到任何真实问题的测试,或对因运行层级而 flaky 的测试重新定级,都是一等一的结局。
负责单个实验的冒烟测试:编写一个小型 pytest,在部分真实 `data/` 上拟合,并在不相交且不含历史缓冲区的数据切片上预测。预测数量必须等于 predict-grid 行数。以下情况触发:已批准的实验需要冒烟测试;`pytest tests/smoke/` 因行数失败;用户询问冒烟测试失败原因;管道编辑需要验证;或实验脚本更改了管道形状。若 `status.setup.pending` 非空,则停止(加载 `setup-ml-project`);若没有已批准的设计或匹配的实验脚本,也应停止并向用户说明,指引其进入设置流程或留在 `build-ml-pipeline`。已拒绝的 git 不会再次询问。“Why is smoke failing?” 仍由本技能处理。本技能不涵盖回归测试或 CV 解读。使用方法:检查 `status`,阅读日志和实验,编写 `tests/smoke/test_NN_*.py`,然后运行 `python -m skore_skills smoke run --stem <stem>`。红色 JSON 表示应在 `build-ml-pipeline` 中修复管道。不要放宽断言。
在为 TS/React 组件库创建、配置或扩展 Storybook 时使用,涵盖 main.ts/preview.ts 设置、CSF3 故事编写、args/argTypes/controls、装饰器和 providers、MSW 与模块模拟、通过 Vitest addon 使用 play-function 进行交互测试、@storybook/addon-a11y 工作流(axe-core)、autodocs 与 MDX 文档、设计令牌、Figma 链接、Chromatic 部署以及按需构建性能。适用于“编写 story”“设置 Storybook”“配置 addon-a11y”“修复 play function”“部署 Storybook”“在 CI 中测试 Storybook”等任务;即使用户没有提到“storybook”,但正在编辑 `*.stories.tsx`、`.storybook/main.ts` 或 `.storybook/preview.ts` 时也会触发。面向 Storybook 9+/10(现代 `storybook/test` 导入、Vitest addon、CSF3 + `satisfies Meta`)。不涵盖通用 React 模式(使用 `react` skill)、通用 Testing Library 查询(使用 `react-testing-library`)或 WCAG 入门(指向 addon-a11y 和 axe 规则配置)。
为软件包、示例、类型检查、lint、构建、Vitest 测试套件、Effect v4 CLI 测试和运行时 E2E 测试选择并执行 TypeScript SDK 验证。添加测试、诊断 TypeScript CI、选择有针对性的测试命令、验证 TypeScript 软件包更改,或针对 [email protected] 和 @effect/vitest 编写或移植 CLI 测试时使用。仅限 Python 的检查请勿使用。
转换并校验用于 Playwright 测试自动化的验收标准。适用于用户要求:(1) 审查/评估/检查验收标准是否已可自动化,(2) 评估验收标准能否原样转换,(3) 校验验收标准对 Playwright 的质量,(4) 将验收标准转化为测试,(5) 根据验收标准生成测试,(6) 将 .md 列表项或 .feature Gherkin 文件转换为 Playwright 规格,(7) 从需求创建测试自动化。同时处理列表式 markdown 和 Gherkin 语法,并生成与校验 JSON 测试计划。
通过 agent-browser 进行无头浏览器自动化——Rust CLI 守护进程,使用持久化身份验证配置文件,实现快速、可脚本化的并行浏览器操作。支持批量命令、网络拦截、设备模拟、按站点配置文件身份验证(仅首次使用有头模式登录,此后始终无头运行),以及通过 --session 创建并行隔离会话。工作流:ReviewStories(将 YAML 用户故事分派给并行 UIReviewers)、Automate(加载/运行参数化配方模板)、Update。向通用 Agent 委派后台并行抓取任务,并提供 agent-browser 使用说明。若网站启用了机器人检测,则回退到 Interceptor。适用于无头浏览器、批量抓取、快速截图、开发服务器测试、并行浏览器、后台自动化、提取数据、审查故事、自动运行配方、批量截图、并行抓取多个页面。不适用于部署验证或使用真实 Chrome 确认 UI(使用 Interceptor);不适用于简单的单 URL 获取(使用 WebFetch);不适用于绕过 CAPTCHA 或机器人检测(使用 BrightData 或 Interceptor)。
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。
