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 工具指南，支持状态检查、自动合并及撤销操作。
需要检查和同步堆叠的 Pull Requests
在 squash-merge 模式下修复 PR 依赖关系
执行堆叠 PR 的自动合并或撤销操作
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手动实现的乐观更新逻辑，识别应使用Atom.optimistic或Atom.optimisticFn但被替代的情况，避免并发竞态条件。
审查涉及effect-atom突变原子的React组件代码
检查diff是否触碰packages/react/src/api/atoms.tsx或相关页面文件
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
指导为 effect-atom 的写操作添加 reactivityKeys，确保数据变更时正确失效相关缓存。用于修复 lint 报错，优化前端状态管理的一致性。
代码中存在 useAtomSet 等写操作但未指定失效键
Lint 工具提示 mutation 缺少 invalidation keys
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将 React 中基于 promise 模式且使用 try/catch 处理 effect-atom 变异的 UI 处理器，重构为使用 promiseExit 和显式 Exit 处理。旨在统一错误模型，避免依赖异常进行乐观更新清理。
代码审查发现 try/catch 包裹 useAtomSet 变异调用
需要修复或优化前端 UI 层中的异步变异错误处理逻辑
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求通过 Effect 服务而非原始 fetch，确保测试可替换网络层。用于修复 lint 警告或添加协议代码时，强制使用 HttpClient 并管理边界适配。
lint 报告 executor/no-raw-fetch
新增网络协议或 Provider 代码
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
规范 TypeScript 中未知数据的边界处理，使用 Effect Schema 或类型适配器替代断言和探测，确保输入解析一次后保持类型安全。
代码中存在双重类型断言
对未知形状进行内联对象断言
使用 in 操作符或 Reflect.get 探测属性
Lint 工具报告不当的类型转换
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-boundaries -g -y
消除TypeScript中手动定义的接口与Effect Schema重复声明，通过Schema推导类型确保静态类型与运行时解析一致，防止数据模型漂移。
代码审查发现手动类型与Schema定义重复
重构时移除冗余的interface或type alias
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未类型化的 JavaScript 错误处理模式，将原生 Error/throw/try-catch 替换为 Schema.TaggedError/Data.TaggedError，确保错误沿 Effect 通道传递并保留语义。
代码中存在 new Error, throw, try/catch, Promise.catch/reject 等未类型化错误处理
lint 报告使用非 Effect 风格错误处理的违规项
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-typed-errors -g -y
自动将手动镜像运行时值的 TypeScript 类型替换为基于工厂函数的 ReturnType 推断类型，防止类型漂移。适用于代码审查中识别并修复重复的类型定义模式。
代码审查发现接口或类型别名与返回对象结构重复
使用 satisfies 关键字匹配非边界处的重复形状
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-value-inferred-types -g -y
指导在Effect项目中规范使用@effect/vitest编写测试，禁止从原始vitest导入，并将条件断言拆分为独立测试以确保确定性。
lint报告直接导入vitest
测试中存在条件断言
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无需修改即可运行，替代传统Mock。
需要模拟第三方API进行集成测试
需要验证OAuth/OIDC认证流程
需要生成OpenAPI规范用于文档或工具
需要断言实际发出的HTTP请求
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
提供生产环境遥测数据查询能力，涵盖Axiom追踪、Postgres及PostHog分析。通过Executor MCP访问，无需凭据。包含字段布局说明、APL查询食谱及错误归因逻辑，用于排查线上错误、延迟、使用情况及验证部署效果。
排查线上错误或延迟问题
分析产品使用情况或流失信号
验证部署后的遥测数据
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导构建自包含模态框，确保表单和异步状态随组件卸载而清理，避免手动重置导致的生命周期泄漏。提供条件卸载及Radix Dialog动画兼容的实现方案与审查要点。
编写或审查模态框/对话框组件
处理包含OAuth弹窗、定时器或订阅等异步工作的UI组件
排查因状态未清理导致的界面卡死bug
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供 Executor CLI 包（含稳定版和测试版）的发布操作指南，涵盖发布范围界定、Changesets 版本管理流程、Changelog 生成规范及 Beta 列车机制。
执行 CLI 包发布
准备发布说明
进入或退出 Beta 测试周期
为 CLI 编写 Changeset
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 框架 HTTP API 服务的端到端测试。提供基于 layerTest 的内存测试服务器搭建、HttpClient 注入及层组合模式，涵盖路径参数处理与 URL 拼接陷阱等关键规则。
编写 Effect HttpApi 服务测试
配置 @effect/platform 测试环境
解决 HTTP 测试中层组合顺序问题
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供将第三方 SDK 封装为 Effect 服务的模式，实现类型安全错误处理、自动追踪及依赖注入。
需要封装第三方客户端
集成外部 API
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
提供 Graphite CLI (gt) 使用指南，指导 Agent 使用 gt 替代 git 进行分支管理、提交和 PR 操作，确保堆栈元数据同步及自动化交互。
Git commit
Git push
创建 Pull Requests
修改提交内容
堆叠分支管理
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
用于运行Warden安全扫描的指南，涵盖授权、代码执行及数据泄露风险检测。提供本地配置、输出规范及针对云/API表面的推荐扫描命令，需人工验证结果。
请求进行安全审计
使用Warden扫描代码库
调查认证或数据泄露风险
分析Warden扫描发现
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
