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 命令以保留堆叠意图。
询问如何管理堆叠 PR
需要修复或同步 stacked PR 的基线
查询 stack CLI 命令用法
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中未使用effect-atom原语的手动乐观更新实现，识别潜在并发竞态条件与UI闪烁问题。
代码审查发现手动实现的乐观状态管理
检查mutation旁是否存在冗余的pending状态追踪
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 handler 中 effect-atom 的 promise 模式 try/catch 重构为 promiseExit 和 Exit handling，以符合 Effect 错误模型。
代码审查发现 mutation 使用 try/catch
需要将 optimistic mutation 改为基于值的错误处理
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求通过 Effect 服务而非原生 fetch，以支持测试注入和 Mock。
代码审查中 lint 报错 executor/no-raw-fetch
新增网络协议或 Provider 代码
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
规范边界处的类型处理，使用 Effect Schema 替代断言或探查未知数据，消除重复的类型检查和不安全的转换。
代码中存在对 unknown 类型的属性探查或断言
出现冗余的类型断如 as unknown as X 或 JSON.parse 后断言
Lint 报告双重类型转换
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-boundaries -g -y
消除 TypeScript 类型与 Effect Schema 定义重复，将手动接口替换为从 Schema 推导的类型，确保静态类型与运行时解析一致，防止数据形状漂移。
代码审查发现类型与 Schema 重复
需要统一类型来源防止漂移
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未使用类型化错误处理的 lint 问题，将原生 JS 错误转换为 Schema.TaggedError。指导识别边界、复用现有错误定义、保持失败语义，并在适配器边界保留原生异常处理。
lint 报告使用 new Error 或 throw
lint 报告使用 try/catch 或 Promise.catch
发现冗余的错误构造辅助函数
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导入
测试中存在条件分支包裹的断言
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的端到端测试。允许真实SDK直接调用，具备完整OpenAPI规范、OAuth流程及凭证管理，用于验证集成逻辑与请求行为。
需要模拟第三方API进行集成测试
验证OAuth或OIDC认证流程
为自动化测试提供真实形态的上游依赖
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
提供生产环境遥测数据查询能力，涵盖Axiom链路追踪、Postgres及PostHog分析。用于排查线上错误、延迟、用户流失信号及验证部署效果，包含字段说明与APL查询模板。
排查生产环境错误
分析系统延迟性能
监控产品使用率与流失
验证部署后数据状态
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导构建自包含模态框，确保表单状态和异步工作随组件卸载而销毁，防止生命周期泄漏。适用于编写或审查拥有异步工作的模态/dialog组件。
编写或审查模态/对话框代码
处理涉及OAuth弹窗、计时器或订阅的异步状态管理
排查模态关闭后状态未重置导致的UI卡死问题
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供 executor CLI 包的发布运行手册，涵盖版本范围界定、Changesets 工作流、版本号策略及 Beta 流程。用于指导用户进行版本切割、生成更新日志及管理发布流程。
准备发布 CLI 版本
编写或整理更新日志
处理 Changesets 文件
进入或退出 Beta 训练
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
指导在 effect-atom 中实现乐观 UI 更新，通过 Atom.optimistic 和 optimisticFn 处理查询与变异的竞态问题，避免手动维护 pending 状态。
需要实现 UI 即时响应而非最终一致性的场景
使用 effect-atom 进行列表增删改查并需优化用户体验时
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
提供 Effect 框架中 HttpApi 服务的端到端测试指南。涵盖使用 NodeHttpServer.layerTest 搭建内存测试服务器、HttpClient 注入及层组合，并详解路径参数处理等常见陷阱。
编写 Effect HttpApi 的集成测试
配置 Effect HTTP 服务的测试环境
解决 Effect HttpClient 与测试服务器配合问题
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供使用Effect框架封装第三方SDK客户端的模式，通过use方法实现类型安全的错误处理、自动追踪和依赖注入。
需要封装第三方SDK为Effect服务
希望统一外部调用的错误处理和追踪
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
提供 Graphite CLI (gt) 的用法指南，指导 Agent 使用 gt 替代 git 进行分支管理、提交和 PR 操作。重点强调保持堆栈元数据同步、处理交互式命令及解决 Rebase 冲突的正确流程，确保版本控制工作流的一致性。
执行 git commit 或 push
创建或切换 Git 分支
提交 Pull Request
修改或变基代码提交
处理版本控制堆栈
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
基于Warden工具的安全扫描技能，用于审计认证授权、代码执行及数据泄露风险。提供本地环境配置、JSONL输出规范及针对云/API/插件等关键表面的推荐扫描命令，需人工复核结果。
需要审计项目安全性
使用Warden进行安全扫描
调查授权或数据泄露风险
处理Warden扫描发现
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
