SuperAPI AI 工具集

Skill 广场

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

更新于 11-16 00:04

编程与开发

41,199 个结果

principle-make-operations-idempotent

该技能围绕“让操作具备幂等性”这一设计原则展开,适用于设计命令、生命周期步骤或处理循环的场景,这些操作往往运行在崩溃、重启和重试频繁发生的环境中。其核心目标是让操作无论运行多少次、从何种状态开始,都能收敛到相同的正确终态。技能提出四个关键模式:收敛式启动(扫描已有状态、清理陈旧产物、接管存活会话)、基于内容的清理(按内容等价性而非创建顺序比较)、自愈锁(基于 PID 检测陈旧锁)、幂等调度(失败任务可干净重生,每轮循环后重新生成新输入)。同时给出三项自检问题:连续运行两次会怎样、上一次运行在每个可能点崩溃会怎样、重新执行是否收敛到相同终态。若答案依赖遗留状态,则说明需要补充对账步骤。

编程与开发5 次安装

principle-migrate-callers-then-delete-legacy-apis

这是一条关于内部 API 重构的工程原则:当决定采用新 API 设计后,应在同一轮重构中迁移所有调用方并删除旧 API,而不是保留兼容层。原则要求不因内部调用方仍存在就保留旧 API 路径,需先盘点调用方、完成迁移、立即删除旧 API;临时适配器应视为例外并设定时限,而非默认架构;同时更新测试以断言新契约,删除仅保护重构前实现细节的测试。适用条件为:没有外部用户依赖向后兼容、项目能承受协调一致的破坏性变更、新 API 属于简化或重构计划的一部分。保留新旧两套 API 会造成双路径复杂性、拖慢清理,并使代码库呈现只增不减的状态。

编程与开发5 次安装

typescript-best-practices

TypeScript 最佳实践是一份针对 .ts 与 .tsx 文件的编码规范技能,用于在阅读或编辑 TypeScript 代码时应用类型系统纪律。它主张用判别联合建模互斥变体、用品牌类型区分同源原始类型、用构造式建模让非法值无法被构造,从而在编译期而非运行时排除错误状态。同时强调对外部数据使用 unknown 而非 any、优先使用运行时 schema 库并从中推断类型、避免 as 断言、按判别 switch 到类型守卫的层级收窄类型、用 never 检查穷尽性、用 satisfies 替代 as、在边界处解析并信任内部类型,以及通过对象参数、真实测试与结构化日志提升可维护性。该技能要求先应用 type-system-discipline 原则技能,具体示例见 references/patterns.md。

编程与开发5 次安装