Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub用于管理基于 squash-merge 的堆叠 PR，提供状态检查、同步、合并及撤销等 CLI 命令指南。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
用于管理基于 squash-merge 的堆叠 PR，提供状态检查、同步、合并及撤销等 CLI 命令指南。
需要检查和同步堆叠 PR
执行堆叠 PR 的合并或撤销操作
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手写的乐观更新逻辑，强制使用effect-atom的Atom.optimistic原子操作。旨在消除并发修改竞态条件，确保UI状态一致性，替代不规范的本地状态管理方案。
审查涉及React组件的代码变更
检查导入effect-atom mutation的文件
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
修复 effect-atom 写入突变时缺少失效键的问题，指导为 useAtomSet 调用添加 reactivityKeys 以正确使缓存无效。
lint 报错 useAtomSet mutation call that mutates data without invalidation keys
需要为数据写入操作配置缓存失效逻辑
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将 React 中基于 promise 模式的 effect-atom 突变处理从 try/catch 重构为 promiseExit 模式，符合 Effect 错误模型。
代码审查发现 mutation 使用 try/catch
Lint 工具提示需替换异常控制流
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求通过 Effect HttpClient 而非原生 fetch，以支持测试注入和模拟。适用于 lint 报错或新增网络协议代码场景。
lint 提示 executor/no-raw-fetch
添加网络协议或 Provider 代码
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
规范处理边界未知或松散类型数据，使用 Effect Schema 进行一次性解析，替代断言、探针和不安全转换，确保后续代码类型安全。
代码中存在对未知数据的重复探测或断言
出现不安全类型转换如 as unknown as X
使用 JSON.parse 后直接断言类型
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-boundaries -g -y
自动将重复的 TypeScript 类型声明替换为基于 Effect Schema 推导的类型，消除手动定义与运行时 Schema 之间的差异，确保类型一致性并防止漂移。
存在与 Schema 定义重复的接口或类型别名
Lint 或审查提示类型与 Schema 不一致
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未类型化的 JavaScript 错误处理，将 new Error 等替换为 Schema.TaggedError。需在边界处保留原生异常，避免静默吞掉错误，确保失败语义与类型通道一致。
代码中存在 untyped JavaScript error handling
使用 new Error, throw, try/catch 或 Promise.catch
lint 报告错误类型不匹配
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 框架下的 Vitest 测试写法，强制使用 @effect/vitest 替代原生导入，禁止在条件分支中使用断言，确保测试确定性。
代码审查发现直接使用 vitest 导入
测试中存在条件性断言
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-vitest-tests -g -y
修复跨包相对导入，强制使用包名导出访问。当 Lint 检测到违反工作区包边界时触发，替换路径并补充必要导出，维护代码封装性。
Lint 报告跨包相对导入错误
需要重构模块依赖以符合包边界规范
npx skills add UsefulSoftwareCo/executor --skill wrdn-package-boundaries -g -y
移除 TypeScript 类型逃逸手段（如 @ts-nocheck），通过缩小范围、添加守卫或改进局部类型来修复类型边界，确保代码类型安全。
代码中存在 @ts-nocheck 指令
Lint 报告广泛的类型绕过警告
npx skills add UsefulSoftwareCo/executor --skill wrdn-typescript-type-safety -g -y
提供生产级保真度的服务模拟器，支持GitHub、Stripe等16种服务。通过真实SDK交互实现端到端测试与演示，具备完整OpenAPI规范、OAuth流程及凭证管理，用于验证上游API集成和请求断言。
需要模拟第三方API进行集成测试
需要真实的OAuth/OIDC认证流程演示
需要基于OpenAPI规范注册服务接口
需要验证请求是否成功发送至上游
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
通过 Executor MCP 查询生产环境遥测数据（Axiom、Postgres、PostHog），用于排查错误、延迟、用户流失及验证部署。提供字段说明与 APL 查询示例，支持按组织归因分析。
排查线上错误
分析延迟问题
验证部署后遥测数据
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导在React中构建自包含模态框，确保表单状态和异步工作随组件卸载而清理，防止生命周期泄漏。提供真卸载与Radix动画兼容的重置方案，并列出代码审查检查点。
编写或审查模态/对话框组件
处理模态内异步操作（如OAuth、定时器）的状态管理
排查模态关闭后状态未正确重置导致的Bug
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供Executor CLI包发布操作指南，涵盖发布范围界定、版本策略偏好、Changesets工作流及Beta流程。用于指导生成发布说明、执行版本发布及管理变更集。
准备发布CLI包
生成发布说明
编写或管理Changeset
进入或退出Beta测试周期
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
提供 effect-atom 库实现乐观 UI 更新的规范，指导使用 Atom.optimistic 处理查询与变异的竞态问题，避免手动维护待处理状态。
需要实现即时 UI 反馈的列表操作
涉及多个快速连续编辑的变异场景
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
用于 Effect 框架中 HttpApi 服务的端到端测试。提供在进程内启动测试服务器、注入 HttpClient 及正确配置 Layer 的方法，涵盖路径参数处理与 URL 拼接陷阱。
编写涉及 Effect HttpApi 的测试用例
测试基于 @effect/platform 构建的 HTTP 服务或插件
配置测试服务器的 Layer 组合
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供基于Effect库的第三方SDK客户端封装模式，通过use方法实现类型安全错误处理、自动追踪及依赖注入。
需要封装第三方SDK以适配Effect运行时
希望统一外部API调用的错误处理和追踪逻辑
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
提供 Graphite CLI (gt) 替代原生 Git 命令的最佳实践，涵盖分支创建、提交、变基冲突解决及堆栈管理。确保 Agent 在版本控制流程中保持元数据同步，避免状态不同步问题。
使用 git commit/push/checkout 等命令时
需要创建或管理堆叠分支时
处理变基冲突或提交修改时
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
基于Warden工具的安全扫描与审计指南，覆盖认证授权、代码执行及数据泄露风险。提供本地配置、JSONL输出规范及针对云/API/插件的具体扫描命令，用于安全排查与发现分级。
请求进行安全审计或漏洞扫描
需要排查认证授权、代码执行或数据泄露风险
要求运行Warden工具并分析结果
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
