Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHub本地 CLI 工具，用于在 squash-merge 仓库中安全地管理、同步和修复堆叠 PR。支持状态检查、PR 基础链接推断、自动合并及操作回滚，解决 Git 祖先信息丢失问题。
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (21)
本地 CLI 工具，用于在 squash-merge 仓库中安全地管理、同步和修复堆叠 PR。支持状态检查、PR 基础链接推断、自动合并及操作回滚，解决 Git 祖先信息丢失问题。
询问如何管理堆叠 Pull Request
需要修复或同步基于 Squash Merge 的分支栈
npx skills add UsefulSoftwareCo/executor --skill stack -g -y
检测React代码中手写的乐观更新逻辑，强制使用effect-atom的Atom.optimistic和optimisticFn标准原语，避免并发竞态条件。
涉及packages/react/src/api/atoms.tsx或相关页面的diff
导入effect-atom mutation atom的代码
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-optimistic -g -y
修复 Effect-atom 写入突变时缺少无效化键的问题，指导在 useAtomSet 调用中添加 reactivityKeys 以明确数据依赖，确保状态一致性。
lint 提示 useAtomSet 突变缺少 invalidation keys
需要为 effect-atom 写入操作添加细粒度缓存失效键
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
将 React handler 中基于 promise 模式的 effect-atom 突变处理，从 try/catch 重构为使用 promiseExit 和 Exit.isFailure 的标准错误处理模式，以符合 Effect 错误模型。
Lint 或代码审查指出 useAtomSet 突变调用周围使用了 try/catch
需要处理 UI 层突变失败后的错误状态或繁忙状态重置
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-promise-exit -g -y
规范 HTTP 请求使用 Effect HttpClient，禁止直接使用 raw fetch，确保测试可注入 Mock 层。
代码中使用了原始 fetch 调用
添加网络协议或 Provider 代码
Lint 工具报告 executor/no-raw-fetch 错误
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-raw-fetch-boundary -g -y
指导在数据边界处使用 Effect Schema、类型守卫或适配器规范化未知数据，替换不安全的类型断言和动态属性探测，确保后续代码类型安全。
发现对未知数据形状进行内联对象断言
检测到双重类型转换或 unknown 形状探测
出现 ad hoc 属性检查或非结构化 JSON 解析
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-boundaries -g -y
将重复的 TypeScript 类型声明替换为基于 Effect Schema 推导的类型，消除运行时 Schema 与静态类型间的漂移，确保类型一致性。
发现手动定义的 interface/type 与附近的 Effect Schema 结构重复
代码审查指出类型定义冗余
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-schema-inferred-types -g -y
修复 Effect 代码中未类型化的 JavaScript 错误处理模式，将原生 Error 替换为 Schema.TaggedError/Data.TaggedError。指导识别边界、复用现有错误定义并保留失败语义，确保在 Effect 错误通道中正确传播异常。
代码中存在 new Error, throw, try/catch, Promise.catch 等未类型化错误处理
Lint 报告使用未类型化 JavaScript 错误处理
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
修复跨包相对导入，强制使用包名导出路径，确保工作区包边界清晰，避免直接访问私有源码。
代码中存在跨包的相对导入路径
Lint工具报告了违反包边界规则的导入错误
npx skills add UsefulSoftwareCo/executor --skill wrdn-package-boundaries -g -y
消除 TypeScript 类型绕过机制，修复 @ts-nocheck 等宽泛类型 bypass。通过收窄表达式、添加守卫或改进局部类型来修复类型边界，确保类型安全而非禁用检查。
代码中存在 @ts-nocheck 指令
存在宽泛的类型 bypass 如 any 滥用
Lint 工具报告类型安全检查被禁用
npx skills add UsefulSoftwareCo/executor --skill wrdn-typescript-type-safety -g -y
提供高保真服务模拟器，支持GitHub、Stripe等16种服务。通过真实SDK和OpenAPI规范模拟上游API交互，用于E2E测试、演示及验证请求，确保集成可靠性。
需要模拟第三方API进行集成测试
需要生成OpenAPI规范供工具使用
需要模拟OAuth或认证流程进行测试
需要在无真实依赖环境下验证请求
npx skills add UsefulSoftwareCo/executor --skill emulate -g -y
提供生产环境遥测数据（Axiom traces、Postgres、PostHog）的查询能力，用于排查错误、延迟及验证部署。包含字段布局、APL查询配方及错误归因逻辑，通过Executor MCP访问。
调查生产环境错误
分析系统延迟
验证部署后的遥测数据
查询产品使用率和流失信号
npx skills add UsefulSoftwareCo/executor --skill prod-telemetry -g -y
指导构建自包含模态框，确保表单状态和异步工作随组件卸载而销毁，避免生命周期泄漏。涵盖实现策略及代码审查要点。
编写或审查模态框/对话框代码
处理涉及 OAuth、定时器等异步工作的组件
npx skills add UsefulSoftwareCo/executor --skill self-contained-modals -g -y
提供 Executor CLI 包发布操作指南，涵盖发布范围界定、Changesets 工作流、版本递增策略及 Beta 流程，用于辅助用户执行版本切割、编写变更日志等操作。
切割 CLI 版本
准备发布说明
进入或退出 Beta 训练
为 CLI 编写 Changeset
npx skills add UsefulSoftwareCo/executor --skill cli-release -g -y
指导在 effect-atom 中实现乐观 UI 更新的标准模式。通过 Atom.optimistic 和 Atom.optimisticFn 包装查询与突变，避免自定义状态导致的竞态问题，确保 UI 即时响应且数据一致。
需要实现前端操作的即时反馈（乐观更新）
处理列表项的创建、更新或删除操作
防止自定义 pending 状态引发的竞态条件
npx skills add UsefulSoftwareCo/executor --skill effect-atom-optimistic-updates -g -y
提供Effect框架HttpApi服务的端到端测试指南，涵盖测试服务器搭建、HttpClient注入及层级组合规范。
编写Effect HttpApi接口测试
配置Effect HTTP测试环境
调试Effect HTTP服务集成问题
npx skills add UsefulSoftwareCo/executor --skill effect-http-testing -g -y
提供基于Effect库的第三方SDK封装模式，通过use方法实现类型安全错误处理、自动追踪及依赖注入。
需要封装第三方API客户端
在Effect项目中集成外部服务
统一错误处理和链路追踪
npx skills add UsefulSoftwareCo/executor --skill effect-client-wrapper -g -y
指导使用 Graphite CLI (gt) 管理 Git 分支、提交和 PR，替代原生 git 命令以维护堆栈元数据一致性。涵盖交互处理、变基冲突解决及分支操作规范，适用于版本控制工作流。
git commit
git push
creating PRs
amending changes
stacking branches
version control workflow
npx skills add UsefulSoftwareCo/executor --skill graphite -g -y
提供 Warden 安全扫描的操作手册，涵盖本地环境配置、JSONL 输出规范及针对权限、代码执行和数据泄露的推荐扫描命令，用于自动化安全审计与风险排查。
需要审计项目安全性
使用 Warden 进行代码扫描
调查认证授权或数据泄露风险
处理 Warden 扫描发现的安全问题
npx skills add UsefulSoftwareCo/executor --skill warden-security-review -g -y
