SuperAPI AI 工具集

Skill 广场

找到适合任务的 Agent Skill,阅读介绍并复制安装命令。

更新于 11-16 00:04

编程与开发

41,214 个结果

nestjs-personal-conventions

nestjs-personal-conventions 是一套面向 NestJS 项目的个人编码约定技能,用于在编写或审查 NestJS 代码(服务、控制器、DTO,以及与数据库或外部 HTTP API 的集成)时应用。它以通用 NestJS 最佳实践(架构、依赖注入、安全)为基础,补充四条有明确倾向的约定:数据库访问必须经由专用的 *.repository.ts 仓储类,禁止服务直接调用 ORM 客户端;每个 DTO 类须实现项目共享契约中的对应接口;对单个外部 API 的出站调用放在专用的 *.api.service.ts 中;对整套外部系统的集成建立独立的 <domain>-http/ 模块,通过 forRootAsync() 注册一次并设为 global。此外还规定仓储方法命名(get* 缺失时抛错、find* 缺失时返回 null/undefined)、PinoLogger.error(err, message) 的错误日志调用形态、分支调试日志、M2M Bearer 令牌守卫,以及 @IsOptional()/@ValidateIf() 与跨字段校验装饰器叠加时的陷阱及修复方式。技能要求先调用 nestjs-best-practices 子技能。

编程与开发4 次安装

plannotator-conventions

Plannotator Conventions 是 ai-dev-kit 提供的一项约定型技能,用于规范在长时间运行的 Plannotator 进程(计划评审、代码评审或标注)启动或轮询期间的行为。它不涉及评审界面的具体操作机制,那部分需调用相关的 plannotator/plannotator-* 子技能;本技能作为其上层的必要约定层,规定如何对待进行中的进程以及评审期间围绕提交应注意的事项。核心规则包括:Plannotator 可跨工具使用来评审计划、变更和视觉产物;应持续轮询直至得到最终结果(标注、批准、错误或退出码),空响应、无输出或轮询超时都只是中间状态而非完成;只要进程未返回最终结果,就不应结束当前回合;收到标注后应先处理再继续周边工作;除非用户直接要求,评审过程中不得执行 git add、git commit 或创建 PR。

编程与开发4 次安装

subagent-driven-development-conventions

该技能是用于在当前会话中把实现计划的任务委派给子代理执行时的一套约定层。它要求配合 superpowers:subagent-driven-development 技能使用,后者负责实际委派循环,本技能则规定委派前加载哪些上下文、子代理提示词写什么、模型选择以及评审节奏。规则包括:不必开启原生 Plan Mode;委派前由调度方自行读取项目记忆文件、代码库快速索引、目标子代理角色定义及任务范围相关规则;每份提示词须显式传入完整上下文包(目标、范围、接口、约束、需调用的技能、工作流模式、验证策略、就绪标准);实现与评审子代理默认用 mini/低cost模型;实现子代理禁止提交代码;测试编写交给测试角色而非实现者;全部任务完成后做一次整分支终审而非逐任务评审。资料另列常见错误及修正。

编程与开发4 次安装

ts-code-style-conventions

这是一套与框架无关的个人 TypeScript 代码风格约定,适用于编写或审查 TypeScript 代码时的命名、类成员排序、方法签名以及模块拆分。它规定接口/类型命名不加 Interface 后缀、不用 Data/Info 等填充词;字段排序要求必填在前、可选在后;禁止非空断言(!);类成员按输入→输出→字段(public→protected→private)→构造函数→方法(public→protected→private)排序;方法参数达到 3 个及以上时合并为一个具名对象并解构;方法体内用空行分隔逻辑块;避免 let 加后续重新赋值,改为从返回值的函数中取 const;禁止魔法数字,用命名常量或基于明显基准单位的算术表达;模块增长时按类型拆分到 *.types.ts、*.constants.ts、*.helpers.ts、*.mapper.ts 等文件,类型守卫放在其收窄的类型旁。该约定可叠加在具体技术栈技能之下,只约束命名与结构,不涉及架构。

编程与开发4 次安装

writing-plans-conventions

这是一个用于多步骤开发任务的计划编写前置技能(writing-plans 的配套约定技能),适用于在动手写代码前已有规格或需求时。它在正式的 spec→计划流程之前运行,先判断计划涉及哪些技术栈(NestJS、Angular 或两者),并按顺序加载对应的最佳实践与个人约定技能,使计划中的代码片段从一开始就符合真实技术栈约定,而非通用模板。该技能还规定了计划必须具备的结构:目标、架构、文件地图、实现任务、测试场景、约束和一次最终验证;每个任务须给出具体的“修改前/修改后”代码,且须包含独立测试编写任务;不在任务中加入提交步骤。

编程与开发4 次安装

api-compatibility

该技能用于在修改命令、数据结构(schema)、API、协议、配置格式、插件接口或其他组件所消费的行为时,帮助维护接口兼容性。其核心规则是把每个外部接口视为与一个或多个消费方版本之间的契约:需枚举可观察的输入、输出、错误码、默认值、副作用、顺序和版本协商,除非是有意为之且已版本化的破坏性变更,否则应保留向后行为。对于兼容性变更,至少应测试当前生产者/当前消费者、新生产者/旧受支持消费者、旧受支持生产者/新消费者、不受支持的版本、未知字段以及缺失的可选字段。该技能主张优先采用增量式变更和能力协商,而非静默的语义变更,并让不兼容的组合明确失败,而不是部分可用。当两个代码仓库需要“协同工作”时,应把受支持范围编码为机器可读的握手,并测试被接受和被拒绝的相邻版本;仅靠文档不构成兼容性边界。

编程与开发4 次安装

concurrency-safety

并发安全(Concurrency Safety)是一份面向多线程、多进程、智能体、钩子、异步任务、并行构建以及共享可变文件或状态场景的实践规范。其核心规则是:共享状态加上重叠执行必然产生竞态,除非所有权与执行顺序被显式定义。该规范要求先识别共享可变资源,再决定采用锁、事务、不可变快照、队列、独立工作区或比较交换/版本校验等机制,并保持临界区尽量小,避免在持有锁时调用任意外部回调。对于可能重试或重复投递的操作,应使其幂等;并行工作应使用唯一的临时名与输出名。规范强调要有意测试两个写入者/读取者,因为依赖时序的缺陷在单线程测试中很少暴露。在智能体场景中,应隔离分支或工作树,防止两个智能体在无协调下编辑同一文件;在安装器场景中,应保护配置的读-改-写过程免受并发运行影响,或检测并中止。最后,顺序测试通过并不能证明并发安全。

编程与开发4 次安装

deterministic-selection

该技能用于在代码需要从多个文件、提供方、发布版本、候选项、记录、插件、匹配项或同等有效选项中选择一个,且可重复性很重要时,确保选择过程确定且可复现。核心规则是不允许文件系统或 API 的枚举顺序成为未记录的决策依据;应定义明确的排序键和稳定的平局规则,例如语义版本、优先级、时间戳加名称、提供方评分加 slug,或其他与契约相关的身份标识。比较前先规范化输入,使最终选择在不同机器和重跑之间保持一致。当确实想要“第一个结果”时,需证明上游 API 保证顺序,否则在本地排序。若选择影响正确性、成本或可复现性,应记录或返回被选中的身份标识。测试应覆盖主键相等、大小写不同、元数据缺失和输入重排等情形;候选集相同但迭代顺序变化时,选择算法应返回相同结果。适用于多来源选择、发布选择、插件选择、候选筛选等对确定性有要求的场景。目前资料未提供具体安装方式、命令、平台限制、收费信息或更多使用步骤。

编程与开发4 次安装

error-taxonomy

error-taxonomy 是面向程序化错误处理的分类技能,核心原则是恢复策略应取决于失败类型,而非通用兜底捕获。它要求把来自 API、子进程、安装器、解析器、服务提供方、网络或校验环节的错误,划分为可操作的类别:暂时性传输/容量问题、永久性输入/不支持操作、认证/授权、配置或依赖缺失、数据损坏、不变量违反、内部缺陷等。同时保留原始错误或退出码及足够结构化上下文以便诊断,并为每类错误映射明确策略:重试、回退、修复、回滚、请求凭据或立即失败。技能明确禁止重试语法错误、无效 API 参数或确定性不兼容,提醒不要把所有超时都当作暂时性错误(子进程可能仍在运行),未知错误应保持未知并保守失败,直到有证据支持归类。适合构建可靠的错误重试、分组、映射与恢复流程时参考使用。

编程与开发4 次安装

invariant-driven-design

Invariant-Driven Design(不变量驱动设计)是一套面向有状态系统、安装器、序列化器、并发代码、工作流与 API 的设计方法。其核心规则是:在决定实现细节之前,先定义“必须始终保持为真”的事实,并把这些事实写成可检查的断言,例如每个提供方只有一个活跃注册、清单哈希与最终字节一致、安装失败绝不输出成功、用户配置在修复后仍然保留、锁只有一个持有者。该方法要求把约束的执行放在最窄的边界上,即无效状态可能进入或离开的位置;测试应主动尝试直接违反不变量,并证明其被拒绝或修复。它主张用少量强不变量替代大量流程性提醒:若正确性依赖每个调用者按顺序记住五个步骤,则应把这些步骤收进接口或自动化闸门,由构造方式本身保证不变量成立。资料未提供安装命令、代码示例、收费与平台信息。

编程与开发4 次安装

path-portability

path-portability 是一项面向 AI 编程助手的路径可移植性技能,属于 senjuwoo/ultimate-ai-starter-bundle 技能包。它用于在代码、安装器、归档文件、配置、子进程或脚本需要跨机器处理文件系统路径时提供约束与检查规则。其核心要求是:路径必须能够应对空格、Unicode 字符、不同盘符、不同用户主目录,以及从不同工作目录调用的情况。技能给出的契约包括:在运行时解析已知根目录,不嵌入其他机器的主目录或盘符;区分绝对路径与相对于所属脚本或配置的路径;只在需要引用的边界处加引号,不把 shell 转义后的字符串当作文件系统路径存储;使用路径 API 而不是字符串拼接;子进程在平台或 API 支持时传递参数数组;测试包含空格、非 ASCII 字符和不同当前目录的路径;归档需拒绝目录穿越(..)、绝对成员和不安全设备名;Windows 上需分别验证 PowerShell 5.1/cmd 与 POSIX shell 的引号行为。

编程与开发4 次安装