Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub本地 stack CLI 用户指南，用于在 squash-merge 仓库中管理、同步、合并和修复堆叠 PR。提供状态检查、意图追踪及自动修复功能。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
本地 stack CLI 用户指南，用于在 squash-merge 仓库中管理、同步、合并和修复堆叠 PR。提供状态检查、意图追踪及自动修复功能。
需要管理或修复堆叠的 Pull Requests
询问如何在 squash-merge 模式下保持 PR 依赖关系
使用 stack CLI 进行分支同步或合并操作
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手动实现的乐观更新逻辑，确保其使用effect-atom的标准API替代，以修复并发竞态条件导致的UI闪烁问题。
审查涉及effect-atom突变原子的React组件代码
检查diff中是否包含手写的乐观更新状态管理模式
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
修复 effect-atom 写入变异调用，为 useAtomSet 添加 reactivityKeys 以指定失效的读取键，确保数据一致性。
lint 报告 useAtomSet 变异缺少失效键
需要修复前端状态同步问题
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将React中effect-atom的promise模式try/catch重构为promiseExit与Exit处理，统一错误模型。
代码审查发现mutation调用使用了try/catch
需要统一Effect库的错误处理模式
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求通过 Effect HttpClient 而非原生 fetch，确保可测试性。适用于代码审查、重构及添加网络协议插件时触发，禁止直接调用全局 fetch。
代码审查发现使用原生 fetch
开发网络协议或 Provider 插件
需要替换真实网络为本地测试夹具
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
规范未知数据边界的类型处理，使用 Effect Schema 或类型适配器替代断言与探测，消除双重转换和内联对象断言，确保领域代码保持强类型。
代码中存在 unknown 类型的值被反复探测或断言
出现双重类型转换如 as unknown as X
使用 JSON.parse 后直接断言类型
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-boundaries -g -y
将重复的 TypeScript 类型声明替换为从 Effect Schema 自动推导的类型，确保静态类型与运行时校验一致，消除数据模型漂移。
代码中存在与 Effect Schema 定义重复的手动接口或类型别名
Lint 或 Review 提示类型与 Schema 不同步
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未使用类型化错误的 JavaScript 错误处理模式，将原生 Error/throw 替换为 Schema.TaggedError/Data.TaggedError，确保错误语义和边界正确处理。
Lint 报告使用 new Error, throw, try/catch, Promise.catch 等未类型化错误处理
需要重构 Effect 代码以符合类型化错误规范
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-typed-errors -g -y
消除 TypeScript 中手动定义的重复对象类型，通过 ReturnType 从工厂函数推断类型，防止类型与实现漂移。
代码审查发现接口或类型别名镜像了运行时返回的对象
存在重复定义对象结构的 interface 或 type
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-value-inferred-types -g -y
规范 Effect 库的 Vitest 测试写法，要求使用 @effect/vitest 替代原生导入，禁止在条件分支中使用断言，确保测试确定性。
代码审查中发现直接使用 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流程。用于测试集成、演示及端到端验证，确保请求准确到达并生成凭证。
需要模拟上游第三方API进行集成测试
需要验证OAuth/OIDC认证流程
需要为集成测试生成OpenAPI规范
需要断言HTTP请求是否成功发送
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
指导构建自包含模态框，确保表单状态和异步工作随组件卸载而销毁，避免手动重置导致的生命周期泄漏。提供条件卸载及Radix动画兼容方案，用于代码审查与开发。
编写或审查模态框/对话框代码
处理包含OAuth弹窗、定时器或订阅等异步工作的组件
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供 executor CLI 包的发布操作指南，涵盖版本范围界定、Changesets 流程、版本号递增偏好及 Beta 列车管理。用于指导用户执行发布、编写变更日志或进入/退出 Beta 阶段。
cut a release
prepare release notes
enter/exit a beta train
write changesets
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
提供基于 effect-atom 库实现乐观 UI 更新的规范。指导使用 Atom.optimistic 和 Atom.optimisticFn 处理查询与突变，避免自定义状态导致的竞态问题，确保 UI 即时响应且数据一致。
需要实现前端操作的即时反馈
涉及列表数据的创建、更新或删除操作
需要处理并发修改的竞态条件
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
用于 Effect 框架中 HttpApi 服务的端到端测试。提供在进程内启动测试服务器、配置 HttpClient 及层组合的最佳实践，涵盖路径参数处理等常见陷阱。
编写涉及 Effect HttpApi 的端到端测试
测试基于 @effect/platform 构建的 HTTP 服务或插件
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供将第三方 SDK 包装为 Effect 服务的模式，实现类型安全错误处理、自动追踪和依赖注入。
需要封装第三方 SDK 客户端
使用 Effect 管理副作用
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
指导使用 Graphite CLI (gt) 替代原生 git 命令进行分支管理和 PR 提交，确保堆栈元数据同步。涵盖创建、修改、变基冲突处理及无交互模式操作规范。
git commit
git push
creating PRs
amending changes
stacking branches
version control workflow
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
使用 Warden 工具对仓库进行安全扫描，涵盖授权、代码执行和数据泄露风险。提供本地配置、输出规范及针对云/API/插件的具体扫描命令，用于审计和安全排查。
请求进行安全审计
使用 Warden 扫描代码
调查授权或数据泄露风险
处理 Warden 扫描结果
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
