Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub本地 CLI 工具，用于在 squash-merge 仓库中管理、同步和修复堆叠 PR。支持状态检查、分支追踪、PR 重定向、合并及撤销操作，替代 GitHub 原生命令以维护堆叠意图。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
本地 CLI 工具，用于在 squash-merge 仓库中管理、同步和修复堆叠 PR。支持状态检查、分支追踪、PR 重定向、合并及撤销操作，替代 GitHub 原生命令以维护堆叠意图。
询问如何管理堆叠 PR
需要修复或同步基于 squash-merge 的分支栈
查看堆叠 PR 状态或元数据
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手动实现的乐观更新逻辑，确保使用effect-atom的Atom.optimistic替代。识别并发变异导致的数据竞争和UI闪烁问题，强制统一使用标准原子原语以保证数据一致性。
审查涉及packages/react/src/api/atoms.tsx的代码变更
检查导入effect-atom mutation atom的文件
发现组件中存在手动管理pending状态的本地状态
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
指导为 effect-atom 的写操作添加 reactivityKeys，确保数据变更能正确失效并刷新 UI。当 lint 检测到缺少无效化键的 useAtomSet 调用时触发。
lint 报错缺少 invalidation keys
需要修复 useAtomSet mutation 调用
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将React中基于promise模式的effect-atom变异处理从try/catch重构为promiseExit与显式Exit处理，以符合Effect错误模型并避免乐观更新依赖异常。
lint或review提示mutation调用周围存在try/catch
需要修复UI处理器中的错误/忙碌状态设置逻辑
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求通过 Effect HttpClient 而非原生 fetch，以支持测试替换与依赖注入。明确代码重构边界、适配第三方库及禁止全局补丁的最佳实践。
lint 报错 executor/no-raw-fetch
添加网络协议或 Provider 代码
重构 HTTP 调用以支持测试
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 结构重复
代码审查指出类型定义冗余
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未类型化的 JavaScript 错误处理，将 new Error、throw 等替换为 Schema.TaggedError。需识别边界，保留失败语义，避免掩盖构造逻辑或改变调用契约。
代码存在 untyped error handling
使用 new Error, throw, try/catch, Promise.catch
lint 报告错误处理模式问题
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-typed-errors -g -y
自动识别并修复TypeScript中重复定义的对象类型，将其替换为基于工厂函数返回值的ReturnType推断类型，防止类型与实现漂移。
代码审查发现手动镜像运行时对象的接口或类型别名
存在重复定义的type/interface且对应值由命名工厂产生
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-value-inferred-types -g -y
规范使用@effect/vitest进行测试，禁止从原始vitest导入及在条件分支中使用断言，确保测试确定性。
代码中直接导入vitest而非@effect/vitest
测试中包含条件判断包裹的expect断言
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-vitest-tests -g -y
修复工作区中跨包相对导入问题，将其替换为通过包导出路径引用。若模块未导出，则补充最小化公共导出，确保仅在同包内使用相对导入，维护清晰的包边界与依赖结构。
代码扫描发现跨包的相对导入路径
重构时需要规范包间依赖关系
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种上游API。用于测试集成、演示及端到端验证，模拟真实OAuth流程、OpenAPI规范及凭证生成，确保请求正确落地。
需要模拟上游第三方API进行测试
验证OAuth或OIDC认证流程
端到端集成测试与演示
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
指导构建自包含模态框的最佳实践，确保表单状态和异步工作随组件卸载而清理，避免生命周期泄漏。涵盖实现模式及代码审查要点，防止连接卡死等Bug。
编写或审查模态框/对话框组件
处理涉及OAuth、定时器、订阅等异步工作的UI组件
排查状态未正确重置导致的UI卡死问题
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供 Executor CLI 发布操作指南，涵盖发布范围界定、版本策略、Changesets 工作流及 Beta 流程。用于指导执行 CLI 包版本发布、编写变更日志及进入或退出 Beta 测试轨道。
准备发布 CLI 版本
生成用户可见的变更日志
进入或退出 Beta 测试轨道
为 CLI 创建 Changeset
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
指导如何在代码库中使用effect-atom库实现乐观UI更新，避免自定义状态管理导致的竞态条件。
需要立即反映用户操作结果的列表查询与突变场景
防止快速编辑导致的状态闪烁和竞态错误
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
用于 Effect 框架 HttpApi 服务的端到端测试。涵盖测试服务器搭建、HttpClient 注入、Layer 组合顺序及路径参数处理等核心模式与常见陷阱。
编写 Effect HttpApi 的集成测试
配置测试用 HTTP 客户端和服务层
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供使用Effect框架封装第三方SDK客户端的模式，实现类型安全错误处理、自动追踪及依赖注入。
需要封装第三方SDK
希望统一错误处理和追踪
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
指导使用 Graphite CLI (gt) 管理 Git 分支、提交和 PR，替代原生 git 命令以维护堆栈元数据。涵盖创建、修改、变基冲突处理及自动化交互参数设置。
执行 git commit 或 push
创建或切换分支
提交 Pull Request
修正提交历史
处理变基冲突
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
指导使用 Warden 工具进行安全扫描的规范。涵盖本地配置、JSONL 输出管理及针对权限、代码执行和数据泄露等风险的具体扫描命令，旨在自动化发现并辅助人工验证安全隐患。
请求进行安全审计
运行 Warden 扫描
调查授权或数据泄露风险
分析 Warden 扫描结果
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
