Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub提供本地stack CLI工具的使用指南，用于在squash-merge仓库中管理和修复堆叠PR。涵盖状态检查、同步、合并及撤销操作，替代GitHub原生命令以保留堆叠意图。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
提供本地stack CLI工具的使用指南，用于在squash-merge仓库中管理和修复堆叠PR。涵盖状态检查、同步、合并及撤销操作，替代GitHub原生命令以保留堆叠意图。
如何管理堆叠的Pull Requests
squash-merge模式下修复PR分支关系
使用stack CLI进行PR同步和合并
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手写的乐观更新逻辑，确保使用effect-atom的Atom.optimistic替代，避免并发竞态条件。
审查涉及atoms.tsx或导入mutation的tsx文件
发现组件使用本地状态跟踪in-flight mutation而非标准原子
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
修复 effect-atom 写入突变未指定无效化键的问题，指导为 useAtomSet 调用添加精确的 reactivityKeys。
lint 报错提示 mutation 缺少 invalidation keys
需要优化前端数据缓存失效策略
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将React中基于promise模式的effect-atom突变处理，从try/catch重构为promiseExit配合Exit.isFailure的模式，以符合Effect错误模型并优化UI边界处理。
代码审查发现mutation调用使用了try/catch
Lint工具提示需替换promise模式为promiseExit
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求实现，强制通过 Effect HttpClient 替代原生 fetch，以提升可测试性并支持 Mock。适用于代码审查及修复 lint 报错场景。
代码审查
修复 executor/no-raw-fetch lint 错误
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
通过 Effect Schema 或类型适配器在边界规范化未知数据，替换断言和探测模式，消除重复类型转换与 unsafe 检查。
代码中存在 unknown 类型的形状断言或属性探测
存在 double casts、内联对象断言或不安全的 JSON 解析
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 或 Data.TaggedError。确保保留失败语义，识别真实边界以避免强制转换，并规范错误构造方式。
代码中存在 new Error, throw, try/catch, Promise.catch, Promise.reject
使用 instanceof Error 或字符串化错误消息
存在仅用于构造标签化错误的冗余辅助函数
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，禁止在条件分支中使用 expect，确保测试确定性。
代码审查发现直接导入 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等宽泛类型 bypass。通过缩小范围、添加守卫或改进局部类型来修正类型边界，确保类型安全而非禁用检查。
代码中存在 @ts-nocheck
存在其他宽泛的类型绕过指令
npx skills add UsefulSoftwareCo/executor --skill wrdn-typescript-type-safety -g -y
提供高保真服务模拟器，支持GitHub、Stripe等16种服务的真实API交互与OAuth流程。用于E2E测试和演示中替代真实上游依赖，确保集成验证的准确性。
需要进行第三方服务集成的端到端测试
需要模拟真实OAuth/OIDC认证流程
需要在无外部网络依赖下验证API请求
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、计时器、订阅等异步工作的模态
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
指导 Executor CLI 的稳定版与 Beta 版发布流程，涵盖包范围界定、基于 Changesets 的版本管理、Changelog 生成及 Beta 训练切换。
执行 CLI 版本发布
准备或撰写更新日志
进入或退出 Beta 测试周期
创建 Changeset
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
提供基于 effect-atom 库实现乐观 UI 更新的规范，指导使用 Atom.optimistic 处理查询与变异的竞态问题，禁止自行实现 pending 状态。
需要实现列表数据的即时 UI 更新
涉及查询原子与变异原子的组合优化
处理快速编辑导致的竞态条件
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
用于 Effect 框架中 HttpApi 服务的端到端测试，涵盖测试服务器搭建、HttpClient 注入及层组合规范。
编写涉及 Effect HttpApi 的测试
配置 In-process 测试服务器
处理 HttpClient 注入与 URL 拼接
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供基于Effect库封装第三方SDK客户端的模式，实现类型安全错误处理、自动追踪及依赖注入。适用于需包装Promise API外部服务并统一异常管理的场景。
需要封装第三方SDK（如Stripe、AWS）为Effect服务
要求对Promise API进行统一错误处理和链路追踪
希望使用依赖注入模式管理外部客户端实例
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
提供 Graphite CLI (gt) 的使用指南，指导 Agent 使用 gt 替代 git 进行分支管理、提交和 PR 操作，确保堆栈元数据同步及自动重排。
Git commit
Git push
Creating PRs
Amending changes
Stacking branches
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
提供 Warden 安全扫描的操作手册，涵盖本地配置、输出规范及授权、代码执行和数据泄露等高危场景的推荐扫描命令，辅助进行安全审计与漏洞排查。
请求进行安全审计或漏洞扫描
需要排查授权、代码执行或数据泄露风险
需要分析或处理 Warden 扫描结果
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
