Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub用于管理基于 squash-merge 仓库的堆叠 PR。支持查看状态、同步分支依赖、合并及撤销操作，通过维护 .git/stack/state.json 确保 Git 祖先信息丢失后仍能正确追踪和修复堆叠关系。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
用于管理基于 squash-merge 仓库的堆叠 PR。支持查看状态、同步分支依赖、合并及撤销操作，通过维护 .git/stack/state.json 确保 Git 祖先信息丢失后仍能正确追踪和修复堆叠关系。
询问如何管理堆叠 PR
需要修复或同步被删除分支的堆叠关系
执行 stack merge 或 undo 操作
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中是否手动实现了乐观更新逻辑，而非使用effect-atom的Atom.optimistic。旨在修复并发竞态条件导致的UI闪烁问题，确保代码遵循仓库规范的原子化更新模式。
用户询问或要求检查React组件中的状态管理与突变处理逻辑
代码审查涉及packages/react/src/api/atoms.tsx及相关页面文件时
检测到组件使用了useState/ref管理待处理状态且调用了effect-atom突变
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 中基于 promise 模式且使用 try/catch 的 effect-atom 变异处理，重构为使用 promiseExit 和 Exit.isFailure 的处理方式。旨在匹配 Effect 错误模型，避免依赖异常进行乐观更新清理，提升代码一致性与安全性。
lint 或代码审查指出在 useAtomSet 变异调用周围使用了 try/catch
UI 处理器需要在变异失败后设置错误状态或忙碌状态
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求必须通过 Effect 服务进行，禁止直接使用原生 fetch。旨在提升测试可替换性，支持注入模拟 HttpClient。明确允许边界（如 Worker API）及适配第三方库的封装方式。
代码中检测到 executor/no-raw-fetch lint 警告
添加涉及网络协议或 Provider 的代码
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
在数据边界使用 Effect Schema 或类型适配器规范化未知数据，替代断言和探测。当出现双重类型转换、内联对象断言、未知形状探测或临时属性检查时触发。
代码中存在双重类型转换（如 as unknown as X）
对未知值进行内联对象断言
通过 in 操作符或 Reflect.get 探测未知数据结构
使用 JSON.parse 后直接进行类型断言
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-boundaries -g -y
消除 TypeScript 类型与 Effect Schema 定义的重复。通过从 Schema 推导类型，确保静态类型与运行时校验一致，防止数据解析与类型定义出现偏差，实现 schema-first 的最佳实践。
代码中存在手动定义的 interface 或 type 与附近的 Effect Schema 结构重复
Lint 工具或代码审查指出类型与 Schema 不一致
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未类型化的 JavaScript 错误处理。将 new Error、throw 等替换为 Schema.TaggedError，确保错误进入 Effect 错误通道。保留失败语义与边界例外，避免静默吞没错误或引入冗余辅助函数。
代码中存在 new Error, throw, try/catch 等非类型化错误处理
Lint 报错提示使用未类型化的 JavaScript 错误模式
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进行确定性测试。禁止从原始vitest导入，严禁将断言置于条件分支后，需拆分逻辑或显式断言，确保测试符合Effect范式且行为确定。
代码审查发现使用了原始vitest导入
检测到expect调用位于if、三元或switch等条件分支内部
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 等宽泛类型绕过手段。通过缩小失败表达式、添加 schema/guard 或改进局部类型来解决问题，避免禁用整个文件的类型检查。
代码中出现 @ts-nocheck
存在其他宽泛的 TypeScript 类型绕过标记
Lint 工具报告类型错误但使用了全局忽略
npx skills add UsefulSoftwareCo/executor --skill wrdn-typescript-type-safety -g -y
提供GitHub、Stripe等16种服务的生产级仿真器，支持真实SDK调用、OAuth流程及OpenAPI规范生成。适用于需要模拟上游API、验证请求或演示集成的测试与开发场景。
需要模拟第三方API（如GitHub、Stripe）进行集成测试
需要生成OpenAPI规范以注册集成
需要模拟OAuth/OIDC认证流程
需要验证HTTP请求是否成功发送
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
通过Executor MCP查询生产遥测数据（Axiom、PlanetScale、PostHog），用于排查错误、延迟及验证部署。提供字段布局说明及APL查询示例，支持错误归因和上游故障率分析。
排查生产环境错误
分析系统延迟或性能问题
验证新部署的遥测数据
调查用户流失或使用量异常
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导构建自包含模态框，确保表单状态和异步工作（如OAuth、定时器）随组件卸载而销毁，避免手动重置导致的生命周期泄漏。涵盖无条件卸载首选方案及Radix Dialog动画场景下的Key重挂载策略，并提供代码审查检查点。
编写或审查模态框/对话框组件
处理涉及异步工作的模态框（如OAuth弹窗、订阅、AbortController）
排查模态框关闭后状态残留或'Connecting...'卡死等生命周期泄漏bug
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
指导Executor CLI包的发布流程。涵盖发布范围界定、Changelog生成规范、基于Changesets的版本管理策略及Owner偏好（如频繁使用patch版本）。适用于执行发布、编写变更日志或处理Beta版本流转等场景。
用户请求切割新版本
准备发布说明
进入或退出Beta训练
为CLI编写changeset
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
指导在 effect-atom 中通过 Atom.optimistic 和 Atom.optimisticFn 实现乐观 UI 更新。适用于列表查询及增删改操作，强调直接使用内置支持以避免竞态条件，严禁手动维护 pending 状态。
需要实现 UI 即时反馈的乐观更新
涉及列表查询与对应 Mutation 的原子定义
处理快速点击导致的竞态状态
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
用于Effect平台HTTP API服务的端到端测试。提供基于层组合的测试服务器搭建、HttpClient注入及路径参数处理的最佳实践，涵盖常见陷阱与正确用法。
编写Effect HttpApi服务测试
配置NodeHttpServer.layerTest测试环境
解决HttpClient URL拼接错误
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供使用Effect库封装第三方SDK客户端的模式。通过'use'模式实现类型安全的错误处理、自动链路追踪及基于配置的依赖注入，支持集中化异常管理和密钥安全加载，适用于Stripe等外部服务集成。
需要封装第三方SDK为Effect服务
希望统一处理外部API调用的错误与追踪
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
指导使用 Graphite CLI (gt) 替代原生 git 命令进行分支管理和 PR 提交。涵盖创建、修改提交、处理合并冲突及堆栈同步，强调保持元数据一致性与自动化重排子分支。
执行 git commit 或 push
创建新分支
提交 Pull Request
修正 (amend) 提交记录
管理堆叠分支
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
使用Warden进行代码安全扫描，涵盖权限、代码执行和数据泄露风险。支持本地配置、JSONL输出及多场景推荐扫描命令，需人工复核结果。
请求审计代码安全性
运行Warden扫描
调查授权或数据外泄风险
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
