Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub提供本地 stack CLI 的使用指南，用于在 squash-merge 仓库中管理、同步和修复堆叠 PR。涵盖状态检查、意图跟踪、自动合并及撤销操作，替代 GitHub gh stack 命令以保障工作流安全。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
提供本地 stack CLI 的使用指南，用于在 squash-merge 仓库中管理、同步和修复堆叠 PR。涵盖状态检查、意图跟踪、自动合并及撤销操作，替代 GitHub gh stack 命令以保障工作流安全。
询问如何管理堆叠的 Pull Requests
需要修复或同步基于 squash-merge 的分支结构
执行 stacked PR 的合并或撤销操作
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测 React 代码中手动实现的乐观更新逻辑，识别应使用 Atom.optimistic 却自行维护状态的情况。旨在修复并发修改导致的数据竞态和 UI 闪烁问题，确保代码符合 effect-atom 规范。
审查涉及 effect-atom 变异的 React 组件代码
检查文件是否导入 ./api/atoms 中的变异原子并存在手动状态管理
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
修复 effect-atom 写入变异调用，为 useAtomSet 添加 reactivityKeys 以指定失效读取范围。确保数据更新时正确触发 UI 刷新，使用最窄键覆盖受影响区域。
lint 报错 useAtomSet 缺少失效键
手动检查 mutation 是否包含 reactivityKeys
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将 React 中 effect-atom 的 promise 模式 try/catch 重构为 promiseExit 与 Exit 处理，统一错误模型。
lint 或 review 发现 useAtomSet mutation 使用 try/catch
UI 处理器需设置 error/busy 状态
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求实现，禁止直接使用原生 fetch，强制通过 Effect HttpClient 服务进行网络调用，以支持测试时的依赖注入和 Mock。
代码审查发现使用原生 fetch
新增网络协议或 Provider 代码
需要替换真实网络为本地测试夹具
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
规范边界处的未知或松散类型数据处理，使用 Effect Schema 进行解析验证，替换断言和动态探测，确保内部代码类型安全。
处理未信任输入数据
解析 JSON 字符串
消除 unknown 类型的重复探测
替换不安全的类型断言
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-boundaries -g -y
将重复的 TypeScript 类型定义替换为从 Effect Schema 自动推导的类型，确保静态类型与运行时校验一致，防止数据解析与类型声明出现漂移。
发现手动定义的接口或类型别名与附近的 Effect Schema 结构重复
代码审查或 Lint 工具提示存在类型冗余
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未类型化的 JavaScript 错误处理模式，将 new Error、throw 等转换为 Schema.TaggedError 或 Data.TaggedError，确保错误语义和类型通道的一致性。
lint 报告使用 untyped JavaScript error handling
发现 new Error, throw, try/catch, Promise.catch 等非 Effect 标准错误用法
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-typed-errors -g -y
用于识别并修复 TypeScript 中手动定义的重复对象类型。通过提取工厂函数的返回值来推断类型，确保类型与实现同步，防止代码漂移，提升类型安全性与维护性。
发现接口或类型别名镜像了运行时对象
Lint 或审查报告类型与返回对象重复
存在可被 ReturnType 替代的手动类型定义
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-value-inferred-types -g -y
规范仓库内测试代码，强制使用@effect/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
存在宽泛的 TypeScript 类型绕过指令
npx skills add UsefulSoftwareCo/executor --skill wrdn-typescript-type-safety -g -y
提供高保真服务模拟器，支持GitHub、Stripe等16种服务的真实SDK测试。通过模拟OAuth、API密钥及完整OpenAPI规范，替代传统Mock，用于集成测试与演示，确保请求准确落地。
需要模拟第三方API进行集成测试
需要验证OAuth或OIDC认证流程
需要生成OpenAPI规范供测试使用
需要在不连接真实上游的情况下测试产品代码
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
通过Executor MCP查询生产环境的Axiom追踪、Postgres数据及PostHog分析，用于排查错误、延迟、使用情况及验证部署效果。
排查生产环境错误
分析系统延迟
查看用户行为与流失信号
验证部署后的遥测数据
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导在React中构建自包含模态框，确保表单状态和异步工作随组件卸载而销毁，防止生命周期泄漏。提供条件卸载和Radix动画兼容方案，用于编写或审查拥有异步工作的模态组件。
编写包含异步操作的模态框
审查模态框的状态管理
修复模态框关闭后状态未重置的bug
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供 executor CLI 包的发布运行手册，涵盖发布范围界定、版本策略、Changesets 流程及 Beta 管理。用于指导切分版本、编写变更日志、进入或退出 Beta 训练等发布相关任务。
准备发布 CLI 包
生成或编写变更日志
进入或退出 Beta 版本训练
为 CLI 创建 Changeset
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
指导在 effect-atom 中实现乐观 UI 更新，使用 Atom.optimistic 处理并发竞态，禁止自定义 pending 状态。
需要立即反映 UI 变更的查询与突变场景
避免自定义 pending 状态导致的竞态 bug
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
用于 Effect 框架中 HttpApi 服务的端到端测试，涵盖测试服务器搭建、HttpClient 注入及层组合陷阱。
编写涉及 Effect HttpApi 的测试
使用 HttpClient 测试 HTTP 服务
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供使用 Effect 库封装第三方 SDK 客户端的模式，实现类型安全的错误处理、自动追踪及依赖注入。适用于需要统一包装外部 Promise API 的服务开发场景。
需要封装第三方 SDK（如 Stripe, AWS）为 Effect Service
希望统一处理外部调用的错误与追踪
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
管理 Git 分支和 PR，使用 Graphite CLI (gt) 替代原生 git。涵盖提交、变基冲突解决及堆栈分支操作，确保元数据同步。
代码提交与修改
创建或切换分支
提交 Pull Request
处理变基冲突
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
基于Warden工具的安全扫描技能，用于审计授权、代码执行及数据泄露风险。提供本地运行配置、JSONL输出规范及针对云API和插件SDK的推荐扫描命令，辅助安全排查与发现分类。
请求进行安全审计或漏洞扫描
需要调查认证授权、代码执行或数据泄露风险
要求使用Warden工具检查仓库
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
