Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub提供本地 stack CLI 的使用指南，用于在 squash-merge 仓库中管理、同步和修复堆叠 PR。支持状态检查、元数据追踪、PR 重定向及撤销操作，替代 GitHub gh stack 命令。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
提供本地 stack CLI 的使用指南，用于在 squash-merge 仓库中管理、同步和修复堆叠 PR。支持状态检查、元数据追踪、PR 重定向及撤销操作，替代 GitHub gh stack 命令。
询问如何管理堆叠的 Pull Requests
需要修复或同步基于 squash-merge 的 PR 栈
查询 stack CLI 的具体命令用法
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手动实现的乐观更新逻辑，识别未使用Atom.optimistic/optimisticFn而导致的竞态条件风险。
代码审查中发现手动管理突变状态
检查effect-atom组件是否正确使用原子乐观更新原语
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
修复 effect-atom 写操作缺少失效键的问题，指导为 useAtomSet 调用添加精确的 reactivityKeys，确保数据一致性。
lint 提示 mutation 缺少 invalidation keys
需要修复前端状态同步问题
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将 React 中 effect-atom 的 promise 模式 try/catch 重构为 promiseExit 及 Exit 处理，以符合 Effect 错误模型并优化 UI 边界逻辑。
代码审查发现 try/catch 包裹 useAtomSet 调用
需要统一 mutation 失败处理模式
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范HTTP请求通过Effect服务而非原生fetch，提升可测试性。提供HttpClient使用指南、依赖注入方法及适配边界，禁止直接调用全局fetch或打补丁。
代码中使用了原生 fetch
添加网络协议或 Provider 代码
lint 报告 executor/no-raw-fetch 错误
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
修复边界处对未知数据的类型断言与探测，使用 Effect Schema 进行统一解码和类型校验，消除双重转换、内联对象断言及属性检查，确保域代码获得强类型数据。
代码中存在 double casts (如 as unknown as X)
存在 inline object assertions
对 unknown 形状进行 probing 或 ad hoc property checks
使用 JSON.parse 后直接断言类型
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 代码中未类型化的 JavaScript 错误处理模式，将原生 Error 替换为 Schema.TaggedError，确保错误在 Effect 通道中正确传播并保留原有语义。
lint 提示使用 new Error、throw、try/catch 等非类型化错误处理
需要重构 Promise.catch 或 instanceof Error 以符合 Effect 规范
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
存在宽泛的类型绕过指令
npx skills add UsefulSoftwareCo/executor --skill wrdn-typescript-type-safety -g -y
提供生产级服务模拟器，支持GitHub、Stripe等16种服务的真实API交互、OAuth流程及凭证生成，用于测试集成和演示，替代传统Mock。
需要模拟上游第三方API进行集成测试
需要验证OAuth/OIDC认证流程
需要生成OpenAPI规范供工具使用
需要断言请求是否成功发送
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
提供生产环境遥测数据查询能力，涵盖Axiom链路追踪、Postgres及PostHog分析。通过Executor MCP访问，用于排查线上错误、延迟、使用率及验证部署效果，包含字段说明与APL查询示例。
调查生产环境错误
分析系统延迟或性能问题
查看用户行为或使用量数据
验证新部署的遥测数据
进行错误归因分析
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导构建自包含模态框，确保表单与异步状态随组件卸载而清理。通过条件卸载或受控重挂载防止状态泄漏，避免手动重置导致的生命周期错误，适用于编写或审查拥有异步工作的弹窗组件。
编写包含异步操作的模态框组件
审查模态框代码以检测状态泄漏风险
解决模态框关闭后状态未重置的问题
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 和 optimisticFn 处理并发与竞态问题，禁止自行实现 pending 状态。
需要实现列表或行的即时 UI 更新
涉及查询原子与变更多原子的联动优化
避免手动管理待处理状态导致的竞态条件
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
提供基于Effect平台的HTTP API端到端测试指南，涵盖测试服务器搭建、HttpClient注入及层级组合，帮助开发者规避常见陷阱。
编写Effect HTTP API测试
配置NodeHttpServer.layerTest
解决HttpClient URL拼接错误
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供基于Effect库封装第三方SDK客户端的设计模式，实现类型安全错误处理、自动链路追踪及依赖注入。
需要封装第三方SDK为Effect服务
统一外部调用的错误处理和追踪逻辑
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
提供 Graphite CLI (gt) 使用指南，指导 Agent 使用 gt 替代原生 git 进行分支管理、提交和 PR 操作。涵盖命令映射、非交互模式配置及 Rebase 冲突处理，确保堆栈元数据同步。
代码提交或修改
创建或切换 Git 分支
提交 Pull Request
解决版本控制中的 Rebase 冲突
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
指导使用Warden工具进行安全扫描，涵盖认证、代码执行及数据泄露风险检测。包括本地环境配置、JSONL输出规范及针对云/API表面的推荐扫描命令，需人工复核结果。
请求审计仓库安全性
执行Warden安全扫描
调查权限控制或数据泄露风险
排查GitHub Actions安全隐患
分析Warden扫描发现
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
