Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub提供本地 stack CLI 的使用指南，用于在 squash-merge 仓库中管理、同步、合并及回滚堆叠 PR，解决 Git 祖先丢失导致的堆叠意图维护问题。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
提供本地 stack CLI 的使用指南，用于在 squash-merge 仓库中管理、同步、合并及回滚堆叠 PR，解决 Git 祖先丢失导致的堆叠意图维护问题。
询问如何管理堆叠 PR
需要修复或同步堆叠分支
查询 stack CLI 命令用法
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手写的乐观更新逻辑，确保使用effect-atom的标准原子方法替代。旨在修复并发竞态条件导致的UI闪烁问题，通过追踪突变与读取状态的一致性来保证数据正确性。
审查涉及effect-atom变异的React组件代码
检查diff是否触及相关atoms或页面文件
发现手写pending状态管理逻辑
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
修复 effect-atom 写入变异时缺少无效化键的问题，指导为 useAtomSet 调用添加 reactivityKeys，确保数据一致性。
lint 提示 useAtomSet 突变缺少 invalidation keys
需要为 effect-atom 写操作添加响应式键
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将React中基于promise模式的effect-atom变异处理从try/catch重构为promiseExit和显式Exit处理，以匹配Effect错误模型并优化UI边界。
代码审查发现useAtomSet使用promise模式并包裹try/catch
需要统一Effect库的错误处理规范
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求通过 Effect 服务进行，禁止使用原生 fetch。旨在提升测试可替换性，支持注入 HttpClient 层以模拟网络环境，确保 SDK 和插件代码的可测试性与架构一致性。
代码审查发现 executor/no-raw-fetch lint 错误
新增网络协议或 Provider 代码
需要替换真实网络为本地测试夹具
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
在数据边界处使用 Effect Schema、命名守卫或类型适配器规范化未知或松散类型的数据，替代断言和探测，确保内部代码类型安全。
处理不可信输入数据的解析与验证
替换 JSON.parse 或类型断言以消除 unknown 类型
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-boundaries -g -y
自动将重复的 TypeScript 类型定义替换为基于 Effect Schema 推导的类型，确保静态类型与运行时解析一致，消除类型漂移。
代码审查发现手动类型与 Schema 重复
需要统一类型来源以防止漂移
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未类型化的 JavaScript 错误处理模式，将 new Error、throw 等替换为 Schema.TaggedError。需识别边界、复用现有错误定义，保留失败语义，避免掩盖异常或改变调用契约。
代码中出现 untyped JavaScript error handling
Lint 检测到新 Error, throw, try/catch, Promise.catch
需要重构错误处理以符合 Effect typed failures
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-typed-errors -g -y
消除 TypeScript 中手动定义与运行时对象重复的类型，改用 ReturnType 从工厂函数推断类型，确保类型与实现同步，防止漂移。
代码审查发现接口或类型别名镜像了返回的对象
存在手动定义的接口/类型与工厂返回值结构重复
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-value-inferred-types -g -y
指导在Effect框架项目中规范使用@effect/vitest编写测试，禁止直接导入vitest及条件断言，确保测试确定性。
代码中直接导入原始vitest模块
测试用例中包含基于if/ternary等条件的expect断言
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-vitest-tests -g -y
修复工作区跨包相对导入，替换为包名导出并补充最小化公开接口，确保仅在同包内使用相对路径。
lint报错提示跨包根目录的相对导入
需要重构代码以符合包边界规范
npx skills add UsefulSoftwareCo/executor --skill wrdn-package-boundaries -g -y
修复 TypeScript 类型安全，移除 @ts-nocheck 等绕过手段，通过缩小类型范围或添加守卫来修正类型边界。
代码中存在 @ts-nocheck
存在宽泛的类型绕过指令
npx skills add UsefulSoftwareCo/executor --skill wrdn-typescript-type-safety -g -y
提供高保真服务模拟器，支持GitHub、Stripe等16种上游API。用于在测试或演示中模拟真实接口、OAuth流程和凭证生成，确保集成代码无需修改即可通过真实SDK验证。
需要模拟第三方API进行集成测试
需要验证OAuth/OIDC认证流程
需要生成可断言的请求日志以证明请求到达
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
通过 Executor MCP 查询生产环境遥测数据（Axiom 追踪、Postgres、PostHog），用于排查错误、延迟、用户流失及验证部署，包含字段布局与查询配方。
排查生产环境错误
分析系统延迟或性能问题
调查用户流失信号
验证部署后的遥测数据
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导构建自包含模态框，确保表单和异步状态随组件卸载而清理，防止生命周期泄漏。适用于编写或审查拥有异步工作的模态组件。
编写包含异步操作的模态框
审查模态框状态管理逻辑
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供 Executor CLI 包的发布操作指南，涵盖发布范围界定、Changelog 生成规范、Versioning 偏好及 Changesets 工作流。用于指导版本切割、发布说明编写及 Beta 流程管理。
执行 CLI 包发布
准备发布说明
进入或退出 Beta 测试周期
为 CLI 编写 Changeset
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
指导在 effect-atom 中实现乐观 UI 更新，利用 Atom.optimistic 和 Atom.optimisticFn 处理并发冲突与状态刷新，避免使用自定义 pending 状态导致的数据竞态问题。
需要实现前端操作的即时反馈
涉及列表查询与增删改查变动的原子操作
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
用于 Effect 框架中 HttpApi 服务的端到端测试，涵盖测试服务器搭建、HttpClient 注入及层级组合规范。
编写涉及 Effect HttpApi 的端到端测试
配置测试用 HTTP 客户端与服务层
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供使用Effect库封装第三方SDK客户端的模式，支持类型安全错误处理、自动追踪及依赖注入。
需要封装第三方SDK
构建Effect服务层
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
管理 Git 分支和 PR，推荐使用 Graphite CLI (gt) 替代原生 git 命令。涵盖提交、修改、分支创建、堆叠及合并请求，确保栈元数据同步与自动重排。
Git 代码提交
推送代码
创建或提交 Pull Request
修正提交记录
处理分支堆叠
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
使用Warden工具对代码库进行安全扫描，覆盖授权、代码执行和数据泄露等风险。提供本地运行配置及针对云/API表面、后端存储等关键区域的推荐扫描命令与输出规范。
请求审计项目安全性
需要运行Warden扫描
调查认证或数据泄露风险
处理Warden扫描发现
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
