Agent Skills
› UsefulSoftwareCo/executor
UsefulSoftwareCo/executor
GitHubAdd and run focused end-to-end coverage for Executor application features, bug fixes, and behavior-preserving refactors. Use the existing real-server suite and evidence reports. Documentation and cosmetic-only edits do not need new scenarios.
Install All Skills
npx skills add UsefulSoftwareCo/executor --all -g -y
Skills in Collection (26)
Add and run focused end-to-end coverage for Executor application features, bug fixes, and behavior-preserving refactors. Use the existing real-server suite and evidence reports. Documentation and cosmetic-only edits do not need new scenarios.
npx skills add UsefulSoftwareCo/executor --skill executor-e2e -g -y
本地 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
Build and deploy Executor apps with tools, storage, UI, accounts and background work. Read before creating or changing an app.
npx skills add UsefulSoftwareCo/executor --skill app-authoring -g -y
Call Executor app tools from execute. Search and signatures, slugs and accounts, unavailable apps, account connections, approvals and resume, limits and errors.
npx skills add UsefulSoftwareCo/executor --skill code-mode -g -y
Start here. What Executor is, how to find and call app tools with search, call and execute, when to build an app, and when to send feedback.
npx skills add UsefulSoftwareCo/executor --skill executor -g -y
Read cached inbox messages and save new messages when the user asks. Use this when working with the Live inbox app.
npx skills add UsefulSoftwareCo/executor --skill inbox -g -y
