文件系统 MCP 推荐

当被要求对课程的 notebook 与代码样例做验证、测试、冒烟测试或运行（针对真实的 Microsoft Foundry / Azure OpenAI 配置）时使用。涵盖环境准备（.env、az login、依赖包）、scripts/validate-notebooks.ps1 运行器、PASS/FAIL 结果解读，以及哪些课程需要额外资源（Azure AI Search、GitHub MCP、Foundry Local、Playwright）。

当被要求对课程的 notebook 与代码样例做验证、测试、冒烟测试或运行（针对真实的 Microsoft Foundry / Azure OpenAI 配置）时使用。涵盖环境准备（.env、az login、依赖包）、scripts/validate-notebooks.ps1 运行器、PASS/FAIL 结果解读，以及哪些课程需要额外资源（Azure AI Search、GitHub MCP、Foundry Local、Playwright）。

查询预构建的 code-review-graph 知识图谱（基于 Tree-sitter、覆盖整个 monorepo），而非用 Grep+Read 遍历调用链——成本低 2-6 倍，且能捕捉 grep 漏掉的分派调用。用于任何跨多文件的任务，即便用户从未提及图谱或主动索取：修复或追踪缺陷（「fix this bug」「why does X happen」「trace this」）、探索陌生代码（「how does X work」「who calls X」「what imports Y」「where is X used」）、规划或执行重构（「rename X」「is it safe to change or remove X」「what would break」「blast radius」「find dead code」），或审阅改动（「review this PR」「review this branch or diff」）。若你即将用 Grep 查找某符号的调用者/被调用者/引用者，停下来改用本技能。

使用参数化语句、贪婪加载、恰当索引与事务管理，编写安全且经过优化的数据库查询。在编写数据库查询、实现数据获取逻辑、优化查询性能、防止 SQL 注入、处理 N+1 查询问题、使用 ORM 或查询构建器、实现缓存策略或管理数据库事务时使用。适用于处理 SQL 查询、ORM 查询方法、数据库仓储模式，或任何从数据库检索或操作数据的代码。

使用参数化查询、贪婪加载、恰当索引与事务管理，编写安全、高性能且经过优化的数据库查询。在控制器、仓储、服务或模型方法中编写数据库查询、使用查询构建器或 ORM 方法、实现过滤/排序/分页逻辑、通过贪婪加载优化 N+1 查询问题、处理连接与复杂查询、实现查询缓存，或将相关操作包裹进数据库事务时使用。

本仓库的本地 Next.js 文档索引（.next-docs/）。用于 apps/web 中任何 Next.js 相关工作：路由、布局、页面、app router、服务端/客户端组件、server actions、缓存、重新验证、metadata、route handlers、proxy/middleware、next.config、图片、字体、错误处理、加载状态、并行/拦截路由、动态路由、useRouter/usePathname/useSearchParams、cookies/headers、重定向、部署、升级。在实现或调试 Next.js 行为前先阅读相关 .mdx 文件；不要依赖训练数据。

为 Next.js dev overlay 撰写或审查 insight 类型的错误页。在新建 errors/<slug>.mdx 页面、审查现有页面或检查其与 framework 修复卡片是否一致时使用。涵盖页面结构、标题对齐、带 Copy prompt 按钮的 FixCard、代码片段、与正式文档的术语一致性，以及 Vercel 技术写作风格。

编写、现代化或修复全面的 MSTest 单元测试，覆盖 MSTest 3.x/4.x API。适用：编写、创建、评审或现代化 MSTest 测试与断言，比 Assert.IsTrue 更好的 MSTest 断言，用 IsInstanceOfType 替代硬转义，MSTest 断言 API（Contains、ContainsSingle、HasCount、IsEmpty、IsNotEmpty、DoesNotContain、AreSame、IsNull、StartsWith、EndsWith、MatchesRegex、IsGreaterThan、IsLessThan、IsInRange），纠正 Assert.AreEqual 颠倒的 Expected/Actual 参数，用 Assert.Throws 替换 ExpectedException，数据驱动（DataRow、DynamicData、ValueTuples），生命周期（TestInitialize、TestCleanup、TestContext），异步与取消测试，条件执行/重试/清理（OSCondition、Retry），并行化（Parallelize/DoNotParallelize），MSTest.Sdk 配置，MSTESTxxxx 分析器修复。不适用：测试质量审计（用 test-anti-patterns）、运行测试（用 run-tests）、MSTest 版本迁移（用 migrate-mstest 技能）、xUnit/NUnit/TUnit、非 .NET 语言。

为 TypeScript 代码编写有效的 JSDoc 注释。提供文档格式、放置策略、最佳实践以及何时写文档、何时让代码自解释的指导。有助于保持代码清晰与 IDE 支持。

使用 Jest 与 React Native Testing Library 为 React Native 应用编写并运行测试。在创建测试、调试失败用例或搭建测试基础设施时使用。

运行测试前必读。详细说明：单个标准单元测试（快）、完整套件（慢）、认证处理，以及获取 API Token 的方法。任务完成时必须运行测试。

读取计划文档，将其拆解为步骤，从 ECC 目录中设计每一步的代理链，并输出可直接粘贴的 /orchestrate 自定义提示词。只做生成——本身不会调用 /orchestrate。当用户有多步计划并想通过 orchestrate 来驱动、又不想手工编排代理链时使用。

针对 ClickHouse 支撑的 logs 表（logs.all.otel 分析端点）编写、评审与迁移 Supabase 日志查询。只要任务涉及 Logs Explorer SQL、log_attributes map、按日志 source 查询（edge_logs、postgres_logs、auth_logs 等）、把旧的 BigQuery cross join unnest(metadata) 日志查询翻译为 ClickHouse，或在 apps/studio/data/logs 与 apps/studio/components/interfaces/Settings/Logs 中接入分析日志 SQL 时使用。用户即使只说“日志查询”“Logs Explorer”或粘贴一段 BigQuery 日志查询待转换也应使用，不必非要提到 ClickHouse。

浏览器使用核心指南，运行任何浏览器命令前先读。内容包括 snapshot 与 ref 工作流、页面导航、元素交互（click、fill、type、select）、文本与数据提取、截图、标签页管理、表单与登录态处理、等待内容、并行运行多个浏览器会话，以及常见失败问题的排查。当用户要求与网站交互、填表、点击、提取数据、截图、登录站点、测试 Web 应用或自动化任何浏览器任务时使用。

为 SkiaSharp 撰写并评审 XML API 文档（docs 子模块中的 ECMA/mdoc XML）。两种模式：(1) 新增：为含“To be added.”占位符的新 API 写文档；(2) 评审：按范围检查现有文档的准确性、时效性、示例与卫生。触发语：“document class”“add XML docs”“write XML documentation”“fill in missing docs”“remove To be added placeholders”“review documentation”“check docs for errors”“fix doc issues”“audit the docs”“review the font docs”“are the examples correct”“update out-of-date docs”，以及任何对 SkiaSharp API 文档做新增、校验、修正或扩充的请求。

为 Static Web Server（SWS）项目编写或评审测试——单元测试、集成测试、测试 fixture 与 mock 策略。

为 Langflow 编写并审查 Playwright E2E 测试。当用户要求编写、修复或审查 E2E 测试、spec 文件、Playwright 测试或覆盖完整 UI 的集成测试时触发。修改 data-testid 属性、tests/utils/ 中的测试辅助函数或 fixture 配置时同样触发。

审计 SkiaSharp 原生依赖的安全漏洞与 CVE，包括 SkiaSharp-Native 与 SkiaSharp Azure DevOps 流水线的 Component Governance（CG）告警。只读调查，输出带建议的状态报告。当用户要求：审计安全问题或 CVE、检查各依赖的 CVE 状态、寻找安全问题及其 PR 覆盖、汇总未修复漏洞、查看待处理的安全工作、检查 Component Governance 告警、评审原生构建流水线的 CG 告警时使用。触发语：“security audit”“audit CVEs”“CVE status”“what security issues are open”“check vulnerability status”“security overview”“what CVEs need fixing”“CG alerts”“component governance”“check container CVEs”。本技能为只读。要实际修复问题，请使用 `native-dependency-update` 技能。

编写、修改或调试位于 ts/e2e-tests/cli 的 Docker 化 Composio CLI 端到端测试，包括二进制调用、fixture 隔离、输出断言与包清单。仅用于 CLI E2E 测试套件；实现 CLI 源码请使用 cli-command 技能。

本仓库的 Codacy Cloud 工作流——在 `git push` 前本地运行 Codacy 分析器（对齐 Codacy CI 行为），并经 v3 API 拉取/聚类任意 PR 的 Codacy 问题。当用户提到 Codacy、「codacy analysis」、`codacy-analysis-cli`、「codacy issues on PR」「fix codacy CI」「codacy markdownlint findings」，或 netdata-org PR 上任何 Codacy 门禁失败时使用。附带脚本 analyze-local.sh（codacy-analysis-cli 的 docker/二进制运行器）与 pr-issues.sh（分页 v3 问题拉取 + 按工具/模式/严重级/文件分组）。令牌安全——CODACY_TOKEN 绝不进入助手可见的 stdout。按设计只读；写操作（标记误报、标记已修复）需要 GitHub issue 或分支本地 SOW。

HiMarket 后端（Java 与 Spring Boot）编码规范。在修改或审查 himarket-server、himarket-dal、himarket-bootstrap、后端 Maven POM、Flyway SQL、controller、service、DTO、repository、校验、日志、异常或后端测试时使用。编辑前先阅读 docs/standards/backend。

DeerFlow 的端到端冒烟测试技能。引导完成：1）拉取最新代码；2）Docker 或本地安装与部署（尊重用户偏好，遇 Docker 网络问题时默认本地）；3）服务可用性验证；4）健康检查；5）最终测试报告。当用户说「run smoke test」「smoke test deployment」「verify installation」「test service availability」「end-to-end test」等时使用。

使用 Vitest 浏览器模式、Playwright 与 @self/tootils 测试工具，为 Gradio 前端的 Svelte 组件编写全面的、行为驱动的单元测试。

根据提供的示例或品牌指引，以独特语气撰写文章、指南、博客、教程、newsletter 等长篇内容。当用户需要超过一段的成稿书面内容时使用，尤其在对语气一致性、结构和可信度有要求时。

为 schema 变更编写安全、零停机的数据库迁移计划。当需要规划数据库迁移、设计零停机 schema 变更、记录 expand/contract（扩展/收缩）式迁移、为数据库变更给出回滚流程，或把 schema 更新与部署协同编排时使用。产出结构化迁移计划，涵盖迁移目标、向后兼容性分析、扩展/收缩阶段拆分、精确 SQL、每阶段回滚步骤、数据校验查询和部署运行手册。

为 schema 变更编写安全、零停机的数据库迁移计划。当需要规划数据库迁移、设计零停机 schema 变更、记录 expand/contract（扩展/收缩）式迁移、为数据库变更给出回滚流程，或把 schema 更新与部署协同编排时使用。产出结构化迁移计划，涵盖迁移目标、向后兼容性分析、扩展/收缩阶段拆分、精确 SQL、每阶段回滚步骤、数据校验查询和部署运行手册。

为 Bitwarden iOS 编写测试、增加测试覆盖率、做单元测试或补齐缺失测试。当被要求“write tests”“add test coverage”“test this”“unit test”“add tests for”“missing tests”，或为新实现创建测试文件时使用。

为你的目标工具（Claude、n8n 或 Zapier）量身定制工作流的分步自动化说明。最适合紧跟 discover-patterns 或 process-analyst 之后运行。

基于 CDP 的本地 OpenWork Electron 浏览器自动化。适用于驱动本地 Electron 开发应用、browser_list、browser_snapshot、browser_eval、composer 自动化或本地 UI 冒烟测试。

以只读方式委托 cursor-agent（Composer）回答问题、排查代码、讨论设计方案并做对抗性校验。不建 worktree、不做 cherry-pick、也不评审 Lead 的 diff——cursor-agent 锁定在 ask 模式，无法写入。当用户说：问 cursor、让 cursor 校验一下、要第二意见、对抗式评审、设计讨论、用 cursor 排查、cursor:ask 时使用。不要用于：编码实现、重构、修改文件、提交/推送等需要写权限的工作（请改用 cursor:do 或 breezing --cursor）。

把问题咨询、调研、设计讨论与对抗性 sanity check 只读地委派给 cursor-agent（Composer）。不开 worktree、不 cherry-pick、不评审 Lead diff——cursor-agent 锁定在 ask 模式，无法写入。当用户说：ask cursor、cursor sanity check、要第二意见、对抗性评审、设计讨论、用 cursor 调研、cursor:ask 时使用。不要为实现、重构、文件编辑、commit/push 或任何需要写权限的操作加载（改用 cursor:do 或 breezing --cursor）。

编写、运行并解释 SQL 查询，并借助 sqlite3 CLI 对 CSV/SQLite 数据做快速本地分析。当用户要求编写或修复 SQL 查询、查询 .db/.sqlite 文件，或用 SQL 分析 CSV（联表、分组、窗口函数）时使用。触发词包括 SQL、query、SELECT、JOIN、GROUP BY、sqlite、database table、查询、数据库、写个 sql、联表、分组。

诊断并修复浏览器、预览或 Electron 的导出/下载失败，尤其涉及 Save As、Blob/Data URL、File System Access API、createWritable 失败与 0 KB 文件的图像导出问题。

使用 React Native Testing Library（RNTL）v13 与 v14（`@testing-library/react-native`）编写测试。在编写、评审或修复 React Native 组件测试时使用。涵盖：render、screen、查询（getBy/getAllBy/queryBy/findBy）、Jest 匹配器、userEvent、fireEvent、waitFor 与异步模式。支持 v13（React 18，同步 render）与 v14（React 19+，异步 render）。触发：React Native 组件的测试文件、RNTL 导入，以及提到「testing library」「写测试」「组件测试」「RNTL」。

只要用户想对 PDF 文件做任何事情，就使用本技能。包括读取或提取 PDF 中的文本与表格、把多个 PDF 合并成一个、拆分 PDF、旋转页面、添加水印、创建新 PDF、填写 PDF 表单、加解密 PDF、提取图片，以及对扫描版 PDF 做 OCR 使其可检索。用户提到 .pdf 文件或要求产出 PDF 时，请使用本技能。

为 Unreal Engine 项目编写并运行自动化测试——简单/复杂自动化测试（IMPLEMENT_SIMPLE_AUTOMATION_TEST、IMPLEMENT_COMPLEX_AUTOMATION_TEST）、BDD 风格 Spec 测试（DEFINE_SPEC、BEGIN_DEFINE_SPEC、Describe/It/BeforeEach/AfterEach）、关卡内功能测试（AFunctionalTest）、底层测试（基于 Catch2 的 LLT）、latent/异步命令、EAutomationTestFlags、FAutomationTestBase 断言 API（TestTrue/TestEqual/TestNotNull/AddError），以及从编辑器、CLI 或 CI 运行测试。适用于为玩法逻辑或系统编写单元/集成测试、搭建无头 CI 测试运行、校验数据/内容或防止回归。

当用户想对 PDF 文件做任何处理时使用此技能。包括读取或提取 PDF 中的文本/表格、合并多个 PDF 为一个、拆分 PDF、旋转页面、添加水印、创建新 PDF、填写 PDF 表单、加密/解密 PDF、提取图片，以及对扫描版 PDF 做 OCR 使其可搜索。只要用户提到 .pdf 文件或要求生成 PDF，就使用此技能。

为 FSH 功能编写测试——xUnit + Shouldly + NSubstitute + AutoFixture，遵循命名与 AAA 约定。在添加单元/handler/验证器/实体测试时使用。完整规则见 .agents/rules/testing.md 与 integration-testing.md。

只要用户想对 PDF 文件做任何事情，就使用本技能。包括读取或提取 PDF 中的文本与表格、把多个 PDF 合并成一个、拆分 PDF、旋转页面、添加水印、创建新 PDF、填写 PDF 表单、加解密 PDF、提取图片，以及对扫描版 PDF 做 OCR 使其可检索。用户提到 .pdf 文件或要求产出 PDF 时，请使用本技能。

以严格、精确、可维护的类型编写、重构或评审 TypeScript 代码，杜绝不必要的 any、类型断言与类型抑制。在 Remix 仓库中处理 .ts/.tsx 文件、公共 API、泛型、可辨识联合、类型守卫、tsconfig/模块设置、对外声明类型的代码，或任何 TS 类型质量影响正确性的改动时使用。

Ledger Wallet 的 TypeScript + React 类型约定。在编写或评审 .ts 与 .tsx 文件时阅读。

只要用户想对 PDF 文件做任何事，就使用本技能。包括阅读/提取 PDF 中的文本与表格、将多个 PDF 合并为一个、拆分 PDF、旋转页面、添加水印、创建新 PDF、填写 PDF 表单、加密/解密 PDF、提取图片，以及对扫描版 PDF 做 OCR 使其可搜索。只要用户提到 .pdf 文件或要求产出 PDF，就使用本技能。

通过 Supabase 按姓名或邮箱添加 Cursor Directory 大使徽章。解析对应人员并设置 users.is_ambassador。当用户要求添加、授予或提升某位大使、颁发大使徽章，或提到 Cursor Ambassador 时使用。

在 tests/** 下任何位置编写、编辑、重构或调试测试（单元、集成或端到端）时使用；编写 NUnit 4 测试类（*Test、*IntegrationTest）；使用 NSubstitute mock、AutoFixture 的 [AutoMockData]/[InlineAutoMockData]/[Frozen]，或 AwesomeAssertions（不是 FluentAssertions）；涉及 CliIntegrationFixture、IntegrationTestFixture、MockFileSystem、TestableLogger、NUnitAnsiConsole 或 New* 工厂辅助类；在 tests/Recyclarr.Cli.IntegrationTests.E2E/ 下添加或更新 E2E 夹具；编辑 Fixtures/recyclarr.yml、metadata.json、cf/、cf-groups/、quality-profiles/ 夹具目录；运行 Run-E2ETests.ps1 或 scripts/coverage.py；排查不稳定测试、覆盖率缺口或 Testcontainers 设置。触发短语如“write a test”“fix this test”“improve coverage”“add an E2E case”“mock this dependency”，或任何对 *.Tests.csproj 及 tests/** 下文件的编辑

使用本地 Whisper CLI 进行语音转文字（无需 API key）。

面向 Claude Code 的 PreToolUse 安全反模式钩子。在 Edit/Write/MultiEdit 操作完成前捕捉 12 种常见安全风险（命令注入、XSS、SQL 注入、不安全反序列化、GitHub Actions 工作流注入、eval/new Function 代码注入）。会话状态缓存可防止同一文件+规则组合的重复告警。仅用标准库、无依赖。当你需要在触及安全敏感代码（认证、支付、用户输入处理、IaC）的 Claude Code 会话中加一道安全网时使用。若需执行经核实安全的操作，可用 ENABLE_SECURITY_REMINDER=0 临时关闭。

在 Recharts 中编写强类型的 TypeScript 代码。

Happy monorepo 的本地开发指南。如何在本地构建、安装、测试并运行 CLI、后端、移动应用与桌面端（Tauri）。当用户输入 /dev，或询问如何「构建」「启动开发」「本地安装」或「运行某个包」时使用。