Claude Skills by findscripter

当用 PHP 8+ 写高性能后端、处理大数据集或重构遗留 OOP 代码时使用；产出用生成器/迭代器/SPL 节省内存、强类型且 PSR 合规、含完善异常处理的惯用实现；不适用于其他语言、仅需基础 PHP 语法解释、或无法改动运行时与依赖配置的场景；触发词：生成器、SPL、PHP 8 枚举、严格类型、性能剖析

当需要为 Web 应用搭建或扩展端到端（E2E）自动化测试时使用；用 Playwright 完成安装配置、编写测试脚本、视觉回归、跨浏览器与移动端模拟、并接入 CI/CD，产出可运行的测试套件与流水线；不适用于单元/接口测试、纯手工探索测试或非浏览器场景；触发词：Playwright、E2E、端到端测试、跨浏览器、视觉回归、浏览器自动化、CI 测试

当用 Java 写浏览器端到端（E2E）测试、需要并行/跨浏览器/可追溯报告时使用；做基于页面对象模型（POM）+JUnit 5+Allure 的可落地测试脚手架与页面类/用例代码；不适用于纯 API 测试（用 REST Assured）或单元测试。触发词：Playwright Java、POM、JUnit5、Allure、跨浏览器、ThreadLocal、trace、并行测试

当需要编写在 dash/ash/BusyBox/bash --posix 等任意 POSIX shell 上可移植运行的脚本时使用；做严格 POSIX sh 脚本的编写、bashism 排查与跨平台校验，产出 #!/bin/sh 脚本与 shellcheck -s sh 通过项；不适用于依赖 bash 专属特性（数组、[[、local、pipefail）或仅单机一次性命令；触发词：POSIX、dash、bashism、可移植脚本

当事故（SEV1/SEV2、客户面中断>15min、数据丢失/安全、险些酿祸的 near-miss）结束后需要做事后复盘时使用；做产出无指责复盘文档（执行摘要、UTC 时间线、根因分析、行动项），用 5 Whys 把责任从"谁"导向"系统条件"，并落成带 owner/截止日的可追踪工单；不适用于事故进行中的实时应急处置、纯监控告警配置或代码改动审查；触发词：复盘、事后复盘、postmortem、blameless、无指责、根因分析、RCA、5 Whys、事故时间线、incident review、action items。

当在 Windows 上编写或调试 PowerShell 脚本（含 Agent 生成的自动化脚本）时使用；做规避运算符/Unicode/空值/JSON 等高频陷阱，产出健壮可执行的 .ps1 脚本与命令；不适用于 Bash/Linux shell 脚本或 pwsh 跨平台高级特性教学；触发词：PowerShell、Windows 脚本、.ps1、cmdlet、Test-Path、ConvertTo-Json、ErrorActionPreference

当准备上线发布、变更含数据库迁移或特性开关、需在发版前核验 CI 状态与审批、或想提前约定回滚触发条件时使用；做生成结构化的发布前/中/后核查清单并产出回滚触发阈值文档；不适用于发布流程编排与版本号策略（用 release-manager）、CI/CD 流水线脚本实现或事故复盘。触发词：发布前检查、上线清单、回滚触发、冒烟测试

当用 Prisma ORM 做 schema 设计、迁移、查询优化、关系建模或排查连接/事务问题（覆盖 PostgreSQL/MySQL/SQLite）时使用；产出可落地的 schema/查询/迁移修复与最佳实践方案；不适用于裸 SQL 调优、数据库服务器/连接池等基础设施配置（转交对应专项）；触发词：Prisma、schema.prisma、prisma migrate、N+1、$transaction、连接池

当需要让 Web 应用可离线、可安装、像原生应用时使用；产出 manifest.json、Service Worker（含 install/activate/fetch 与缓存策略）、offline.html 与安装提示逻辑；不适用于纯静态站点、需要后台原生能力或仅做常规性能优化。触发词：PWA、Service Worker、离线、添加到主屏幕、Workbox、可安装

当需要部署 Prometheus、配置抓取(scrape)/服务发现、编写 recording 与告警规则并用 promtool 校验时使用；产出 prometheus.yml、规则文件与验证命令；不适用于 Grafana 看板、告警通知路由(Alertmanager)、追踪/日志或 PromQL 排障；触发词：Prometheus、prometheus.yml、scrape、recording rule、告警规则、promtool、kube-prometheus、node-exporter。

当 Python 应用变慢、CPU/内存吃紧、需要在优化前定位真实瓶颈时使用；先用 cProfile/line_profiler/memory_profiler/py-spy 剖析热点，再按算法→数据结构→缓存→向量化→并行的次序优化并做前后基准对比；不适用于功能正确性 bug、非 Python 代码或线上分布式链路追踪；触发词：Python 性能、cProfile、py-spy、lru_cache、内存泄漏、慢。

当为 Python 项目搭建 pytest 测试体系、写单元/集成测试或 mock 外部依赖时使用；用 fixture/参数化/mock/monkeypatch 按 AAA 模式产出可执行测试、conftest 与覆盖率配置；不适用于非 Python 语言或拿测试替代环境验证与专家评审。触发词：pytest、fixture、参数化、mock、覆盖率

当用 Rails 7+ 搭建带 Hotwire 的 Web 应用、做实时局部更新或后台任务时使用；产出 Active Record 防 N+1 查询、Turbo Frames/Streams 局部刷新、Action Cable 通道、Sidekiq Worker 与 RSpec 测试套件；不适用于非 Rails 栈、纯前端 SPA、仅需基础 Ruby 语法、或无法改动 Gemfile 与迁移的场景；触发词：Rails、Hotwire、Turbo、Action Cable、Sidekiq、Active Record、RSpec

当用 ReactFlow 构建可交互节点图（树形导航/大数据量/复杂状态）时使用；做出层级展开、性能优化与状态管理（含撤销重做、自动布局、聚焦/搜索）的生产级实现；不适用于静态流程图、纯 SVG 绘图或非 ReactFlow 图库。触发词：ReactFlow、节点图、自动布局

当用 Expo / React Native 起新项目或落地导航、状态管理、原生模块、离线优先架构与移动端性能/发布时使用；做项目结构、Expo Router、AuthProvider、React Query 离线缓存、原生能力封装、FlashList 优化与 EAS 构建发布的工程化方案产出；不适用于纯 Web 前端、Flutter/原生 iOS/Android 单端开发或与移动架构无关任务；触发词：React Native、Expo、Expo Router、EAS、离线优先、FlashList

当在 React 应用里搭建全局状态、同步服务端数据、或在 Redux Toolkit/Zustand/Jotai/React Query 间选型时使用；做：按本地/全局/服务端/URL/表单分类对症选库，给出 TS 范式、乐观更新与旧 Redux 迁移方案；不适用于纯后端逻辑、非 React 框架或单组件 useState 即可的简单 UI 状态；触发词：状态管理、全局状态、Redux、Zustand、Jotai、React Query、服务端状态、乐观更新、状态选型

当需要在应用内搭建用户端浮动客服窗口 + 管理端工作台的实时聊天系统时使用；做数据模型、REST 接口、WebSocket 频道、前端组件、延时邮件通知的端到端落地方案与代码；不适用于群聊/多人房间、AI 自动应答机器人、纯邮件工单系统。触发词：在线客服、实时聊天组件、客服工作台

当需要规划版本发布、生成变更日志、协调部署、创建发布分支或自动化版本号时使用；做发布全流程编排（语义化版本、变更日志、就绪检查、灰度/回滚/热修复）并产出发布计划与文档；不适用于纯需求评审、CI/CD 流水线脚本细节实现或代码审查本身。触发词：发布、changelog、回滚

当需要新建或扩展后端 REST API 端点时使用；按「路由→校验→鉴权→业务→错误处理→响应→文档→测试」分层产出生产级端点代码与规范；不适用于前端调用、GraphQL/gRPC 或纯架构选型；触发词：REST API、端点、路由、CRUD、接口

当用 Ruby/Rails 写惯用代码、做元编程 DSL、开发 gem、写测试或做性能优化时使用；产出符合社区惯例的 Ruby 代码、Rails MVC 应用、RSpec/Minitest 测试、gem 规范与 benchmark-ips 基准；不适用于其他语言运行时、仅需基础语法解释、或无法改动 Gemfile 与工具链的场景；触发词：Rails、ActiveRecord、元编程、RSpec、RuboCop、gem 开发

当用 Rust 1.75+ 构建服务/库/系统工具，或攻克所有权、生命周期、async 设计与零成本性能优化时使用；做类型安全 API、Tokio 异步、错误处理与测试基准齐备的可上线 Rust 代码；不适用于一次性脚本、动态运行时、只问基础语法或无法引入 Rust 的场景；触发词：Rust、async、Tokio、所有权、生命周期、unsafe FFI、cargo。

当为多客户共享数据库的 SaaS 设计租户隔离时使用；产出 tenant_id 列设计、PostgreSQL RLS 策略、租户感知中间件与 ORM 自动作用域、跨租户 admin 与租户开通方案；不适用于单用户应用或纯鉴权无租户作用域。触发词：多租户、租户隔离、RLS、tenant_id、行级安全、数据泄漏

当需要跨多个服务协调一个无法用单一 ACID 事务保证一致性的长流程（下单履约、审批流、多步业务工作流）、并要在任一步失败时按反向顺序执行补偿（refund/release/cancel）时使用；做 Saga 编排型/协同型设计、状态机建模与补偿逻辑实现，产出可落地的编排器代码与失败回滚方案；不适用于单库本地事务、强一致同步调用，或无补偿语义的只读流程。触发词：saga、分布式事务、补偿事务、最终一致、订单履约、长流程编排

当用 Scala 做企业级函数式编程、分布式系统或大数据处理时使用；做架构选型、效果系统/Actor/流式建模、性能调优并产出可运行 Scala 代码与方案；不适用于纯 Java/Kotlin、与 Scala 无关的通用问题或仅环境配置；触发词：Scala、ZIO、Cats Effect、Pekko、Akka、Spark、Http4s、SBT。

当需要用真实屏幕阅读器验证 Web 应用无障碍、排查读屏/ARIA/动态播报/表单可访问性问题时使用；做按 NVDA/VoiceOver/JAWS/TalkBack 的浏览-焦点双模走查并产出测试脚本、缺陷清单与 ARIA 修复；不适用于纯自动化扫描或与读屏无关的通用 UI 评审。触发词：屏幕阅读器、读屏、NVDA、VoiceOver、JAWS、ARIA、aria-live

当需要把网页做成「随滚动展开的叙事/电影感」体验（视差、滚动动画、Pin 钉住、横向滚动、进度揭示）时使用；产出滚动驱动的页面方案与可运行代码（GSAP ScrollTrigger / Framer Motion / CSS scroll-timeline），含 60fps 性能、移动端与无障碍兜底；不适用于普通静态页排版、纯 3D/WebGL（转 3d-web-experience）、框架级实现（转 frontend）；触发词：滚动动画、视差、滚动叙事

当在 Kubernetes 上设计/落地服务网格（拓扑、零信任 mTLS、跨集群联邦、渐进式交付）时使用；产出网格选型、流量与安全策略、可观测性接入及运维手册；不适用于单纯写某条 Istio YAML（用 istio-traffic-management）或非网格的应用层业务问题；触发词：service mesh、istio、linkerd、mTLS、零信任、多集群

当在前端项目中新增/组合/调试 shadcn/ui 组件、初始化项目或切换设计预设时使用；做组件查找-安装-组合的可执行操作并产出符合关键约束的 React/TSX 代码；不适用于非 shadcn/ui 的 UI 库或纯样式问题。触发词：shadcn、组件库、设计系统

当为 shell 脚本配置静态检查、修脚本告警或在 CI/CD 接入 lint 时使用；做安装/配置 .shellcheckrc、按 SC 码定位修复、抑制误报、接 pre-commit 与 CI 并产出可复用配置与门禁脚本；不适用于非 shell 脚本或运行期测试；触发词：shellcheck、.shellcheckrc、SC2086

当用 Shopify CLI 开发应用/扩展/主题，调用 GraphQL Admin API，配置 OAuth、Webhook、计费、访问域、metafield 或 Shopify Functions 时使用；做脚手架搭建、GraphQL 查询/变更、Liquid 模板与扩展编码并落地可部署产物；不适用于通用电商建站、非 Shopify 平台或纯运营配置（无代码改动）；触发词：Shopify、shopify app、GraphQL Admin、Liquid、checkout extension、metafield、webhook、Polaris。

当需要为服务定义可观测的可靠性目标、落地 SLI/SLO/错误预算与多窗口燃尽告警时使用；做产出 SLI 定义、SLO 目标、Prometheus 录制规则与告警/看板配置；不适用于不可量化的"体验好坏"评估、无指标数据源、纯采集配置（交给监控配置技能）、SLA 合同条款撰写；触发词：SLO、SLI、错误预算、服务等级目标、燃尽率、可靠性目标。

当需要在写代码前先定义规约、验收标准、从规格生成测试或推行规格优先开发时使用；产出含九大必填小节的规约文档、可追溯的验收标准与测试桩；不适用于无明确需求的探索性原型或纯文档补写（事后补写不算规约）。触发词：写规约、验收标准、规格优先、需求先行、Given/When/Then

当线上服务故障/告警触发、需要快速止损与事后复盘时使用；做事件指挥、分级定级、稳态恢复与无指责复盘（产出事件时间线、状态更新、复盘报告与改进项）；不适用于纯功能开发、单元测试或非线上的日常运维；触发词：线上故障、事件响应、止损、复盘、SLO 燃尽

当用 SvelteKit 搭全栈 Web 应用、需要文件路由/SSR/SSG/API 端点/表单动作时使用；做出可运行的路由、load 数据加载、+server 接口、form actions 与渲染模式配置；不适用于纯 Svelte 组件库、React/Next 项目或非 Web 后端服务；触发词：SvelteKit、+page.svelte、load 函数、form actions、SSR、+server.ts。

当审查/修复 Swift 6.2+ 并发问题（actor 隔离、Sendable 违规、@MainActor、async 迁移）或读编译器数据竞争诊断时使用；做最小行为变更的安全修复并给出改后代码与验证清单；不适用于纯功能开发、非并发崩溃排查、Objective-C 旧式 GCD 调优；触发词：Swift 并发、actor 隔离、Sendable、@MainActor、@concurrent、data race。

当编写、审查或重构 SwiftUI 代码，需要状态管理、视图组合、性能、无障碍及 iOS 26+ Liquid Glass 的现行最佳实践时使用；产出基于事实、不绑定特定架构的整改建议与对照清单；不适用于完整 App 工程搭建/上架、跨平台（Flutter/RN）或纯后端。触发词：SwiftUI、状态管理、@State、property wrapper、视图重构、SwiftUI 性能、Liquid Glass

当在 SwiftUI 中采用、审查或重构 iOS 26+ Liquid Glass（液态玻璃）效果，需要正确的 API 用法、修饰符顺序、容器分组与版本回退时使用；产出原生 glassEffect/GlassEffectContainer/玻璃按钮样式的实现片段、审查清单与 #available 降级方案；不适用于自定义模糊堆砌、跨平台框架或纯后端。触发词：Liquid Glass、glassEffect、GlassEffectContainer、玻璃按钮、液态玻璃、glassEffectID

当排查 bug、性能问题、崩溃或线上异常时使用；用科学方法分阶段定位并产出最小复现、根因结论与可验证修复；不适用于已知根因的直接改码或新功能开发；触发词：调试、debug、根因分析、root cause、复现、性能排查、内存泄漏、二分定位、git bisect

当排查 elusive bug、性能劣化、生产事故、崩溃栈/dump、分布式系统异常时使用；做法是按「复现-取证-假设-实验-定位-验证」科学闭环，配合二分(git bisect)、定向日志/断点、差分对比与 profiling，产出可复现步骤、根因结论与已验证修复。不适用于无可复现症状、纯功能开发或拿不到日志/trace/运行信号的场景。触发词：调试、复现、栈追踪、性能、生产事故、内存泄漏

当用 Tailwind v4 搭建样式体系、定义设计令牌或写响应式/容器查询组件时使用；做 CSS-first 配置、令牌分层、深色模式与现代布局并产出可复用样式；不适用于 v3 JS 配置迁移细节、纯原生 CSS 或其他 UI 框架；触发词：tailwind、@theme、容器查询

当在 React/Next.js 中用 TanStack Query（React Query）做数据拉取、缓存失效、变更与乐观更新、SSR 水合时使用；做查询键设计、自定义 hook 封装、staleTime/gcTime 调优与 App Router 预取产物；不适用于非异步的纯客户端本地状态（用 useState/Zustand）、后端接口实现或其他数据库 ORM；触发词：TanStack Query、React Query、useQuery、useMutation、乐观更新、缓存失效、SSR 水合。

当需要系统盘点技术债、决定"先重构什么"、评估代码健康度或排维护 backlog 时使用；做按六类（代码/架构/测试/依赖/文档/基础设施）盘点技术债并用 影响×风险×工作量 打分，产出带优先级、工作量估算、业务理由的清单和可与功能开发并行的分阶段偿还计划；不适用于具体某段代码的逐行 bug 审查、单条重构的实现、或全新功能设计；触发词：技术债、tech debt、重构什么、该重构哪里、代码健康度、维护 backlog、技术债审计

当为新项目选型、对比框架/云厂商或评估迁移路径时使用；做加权打分、5 年 TCO、生态健康、安全合规与迁移成本的数据化评估并产出带置信度的对比报告与建议；不适用于同类工具的琐碎二选一、已拍板的强制选型或紧急生产故障排查；触发词：技术栈对比、TCO、迁移评估

当用 Temporal Go SDK 构建持久化分布式编排（长流程、Saga、信号/定时器、子工作流）时使用；做确定性工作流、mTLS Worker、版本化与重放测试的生产级 Go 实现；不适用于 Python/Java/TS SDK、无持久化需求的简单请求响应或普通 cron。触发词：Temporal、Go SDK、workflow 确定性、mTLS Worker、GetVersion、ContinueAsNew、Selector 信号、Saga 编排

当用 Temporal Python SDK 编排长时运行/分布式事务/Saga 补偿/人审介入/多步管道时使用；做出确定性工作流、幂等 Activity、重试与超时策略、信号查询、时间跳跃测试与 Worker 部署的可执行方案与代码；不适用于无状态请求-响应、简单定时任务（cron 即可）、单机短脚本或纯前端。触发词：Temporal、工作流编排、durable workflow、Saga、Activity、Worker、信号查询、确定性、时间跳跃测试

当需要盘点应用可测面、找出哪些路由/组件/接口/用户流程缺测试时使用；做法是构建覆盖矩阵并按业务影响排序缺口、产出带工作量估算的测试计划；不适用于运行测试或统计行级覆盖率数字本身。触发词：测试覆盖率、缺口分析、哪些没测、缺失测试、coverage gaps、missing tests

当为网页构建交互式 3D 场景、产品配置器、沉浸式作品集或滚动驱动 3D 时使用；做技术选型(Spline/R3F/Three.js)、模型优化、性能调优并产出可运行的 3D 网页代码与降级方案；不适用于纯 3D 游戏引擎(Babylon/Unity)或后端/CAD 建模。触发词：Three.js、React Three Fiber、WebGL、Spline、3D 网站、产品配置器

当为新产品搭建事务邮件、迁移邮件服务商或重构遗留邮件模板时使用；用 React Email 组件 + 统一发送层产出含暗黑模式/i18n/防垃圾优化/UTM 追踪的生产级模板系统；不适用于纯营销群发活动、富交互 HTML 页面或站内信。触发词：事务邮件、邮件模板、React Email、Resend、邮件发送、邮件可达性

当用 TypeScript 单仓前后端（Next.js/Remix/Express+React）需要免 Schema、免代码生成的端到端类型安全 API，或为已有 tRPC 加鉴权中间件、订阅、SSR 调用时使用；做 router/procedure 设计、Zod 输入校验、双 context 工厂、protectedProcedure、客户端 React Query 接线并产出可落地代码；不适用于跨语言/异构客户端、纯 REST/GraphQL 契约、裸 SQL 或 ORM 调优。触发词：tRPC、router、procedure、Zod、createTRPCContext、protectedProcedure、useQuery

当在 monorepo 中配置 Turborepo、优化构建流水线或排查缓存未命中时使用；做产出 turbo.json 流水线/远程缓存接入/过滤构建命令与 CI 配置；不适用于非 Turborepo 的构建工具或与缓存无关的任务；触发词：turborepo、turbo.json、remote cache