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 Request
需要修复或同步 Squash Merge 下的分支关系
查看堆叠 PR 的状态和依赖图
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手动实现的乐观更新逻辑，识别未使用effect-atom标准API导致的竞态条件。
审查涉及effect-atom变异的React组件代码
检查diff是否包含相关包或导入语句
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
修复 effect-atom 写操作未指定无效化键的问题，指导在 useAtomSet 调用中添加 reactivityKeys，确保数据变更能正确触发 UI 更新。
Lint 报错提示 mutation 缺少 invalidation keys
需要为 write mutation 添加缓存失效逻辑
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将React中effect-atom的promise模式try/catch重构为promiseExit及显式Exit处理，统一错误模型。
lint或review提示mutation调用使用了try/catch
需要修复UI层mutation失败的状态管理
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求通过 Effect 服务而非原生 fetch，以支持测试时替换为本地模拟或 Mock。定义修复形状、批准边界及代码示例，确保 SDK 和插件网络调用可测试性。
lint 报错 executor/no-raw-fetch
添加涉及网络协议的插件代码
重构使用全局 fetch 的代码
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 定义的重复，通过 schema 推导类型以保持静态类型与运行时解析一致，防止数据形状漂移。
代码审查发现接口或类型别名重复描述了 Schema 中已定义的字段
需要统一类型定义源头以避免手动维护的类型与运行时 Schema 不同步
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未类型化的 JavaScript 错误处理，将原生 Error/Throw 转换为 Schema.TaggedError，确保在 Effect 错误通道中正确传递类型化故障。
Lint 报告使用 new Error, throw, try/catch, Promise.catch 等未类型化错误处理
需要将同步失败转换为 Effect.fail 以符合类型系统
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项目中规范使用@effect/vitest编写测试，禁止从原始vitest导入及在条件分支中使用断言，确保测试确定性。
代码审查发现直接使用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 指令
存在其他宽泛的 TypeScript 类型绕过操作
Lint 工具报告类型检查被禁用
npx skills add UsefulSoftwareCo/executor --skill wrdn-typescript-type-safety -g -y
提供生产级服务模拟器，支持GitHub、Stripe等16种服务的真实API对接测试。通过OpenAPI规范、OAuth流程和凭证生成，用于E2E集成测试及演示，确保上游请求正确到达。
需要进行第三方服务集成测试
需要模拟OAuth/OIDC认证流程
需要验证API请求是否成功发送
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
提供生产环境遥测数据查询能力，涵盖Axiom追踪、Postgres及PostHog分析。用于排查生产错误、延迟、使用情况及变更验证，包含字段布局与APL查询示例。
排查生产环境错误或延迟
验证部署后的遥测数据
分析用户使用情况或流失信号
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导前端组件实现自包含模态框，确保表单和异步状态随组件卸载而清理，防止生命周期泄漏。
编写或审查包含异步操作的模态框代码
排查模态框关闭后状态未重置导致的Bug
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供 executor CLI 包的发布运行手册，涵盖发布范围界定、基于 Changesets 的版本管理、PR 流程及 Beta 训练机制，指导如何正确执行版本切分与发布。
执行 CLI 包发布
准备发布说明
进入或退出 Beta 训练
编写 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 框架中 HttpApi 服务的端到端测试。提供测试服务器搭建、HttpClient 注入及层级组合的最佳实践，帮助开发者规避常见陷阱。
编写涉及 Effect HttpApi 的测试
配置 @effect/platform 服务测试环境
处理测试中的 HTTP 客户端注入
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供使用Effect框架封装第三方SDK客户端的模式，实现类型安全错误处理、自动追踪和依赖注入。
需要封装第三方SDK（如Stripe、AWS）
希望统一错误处理和分布式追踪
构建基于Effect的服务层
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
提供 Graphite CLI (gt) 替代原生 git 的规范，管理分支堆叠、提交与 PR。强调避免使用 raw git 以防状态不同步，指导 Agent 处理交互参数及 Rebase 冲突解决，确保版本控制工作流的一致性。
执行代码提交或修改
创建或管理 Git 分支
发起或管理 Pull Request
解决 Rebase 冲突
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
基于 Warden 工具执行安全扫描与审计的技能。涵盖权限控制、代码执行及数据泄露风险检测，提供本地运行配置、目标文件筛选及 JSONL 结果输出规范，用于自动化安全审查与发现排查。
请求进行安全审计或漏洞扫描
需要分析权限控制、代码执行或数据泄露风险
要求使用 Warden 工具检查代码库
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
