SuperAPI AI 工具集

programming

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:该技能用于在编写或修改 .py、.pyi、.rs、.ts、.tsx、.mts、.cts、.go 文件时统一执行严格类型的语言规则。作者定位为一种强制先读参考再写码的“懒而严谨”的工程方式,参考文件位于 references/ 下按语言分目录。

主要能力:先执行语言门(PHASE 0),据扩展名或用户请求识别语言,加载 references/python、references/rust、references/typescript、references/go 中 README 及指定文件;若涉及 unsafe、*mut、*const、MaybeUninit、FFI、unsafe impl Send/Sync 或自定义无锁原语,再加载 references/rust-ub。共享七条原则包括:能不写就不写(YAGNI、复用、标准库、平台特性、已装依赖优先);类型系统作为证明系统;只在边界解析不可信输入(Pydantic v2、serde、Zod);一个名字对应一个概念(NewType、newtype tuple struct、Branded 类型);变体穷尽匹配;信任框架保证;测试驱动。

使用方式:按红→绿→重构循环;测试按单元、集成、E2E 三层组织,Given/When/Then 结构,一个 When 一个测试;优先真实对象、内存假实现、testcontainers、HTTP 级假实现,mock 为最后手段。禁止断言提示词自然语言文本,只断言机器消费的路由决策、结构标记、条件行为或触发片段。

适用场景与限制:用于上述语言的任意规模改动,包括一次性脚本(uv + PEP 723、rust-script、Bun)。跨语言铁律要求默认不可变、品牌化原语、无未类型化逃逸、禁裸错误字符串、RAII 资源、必须异步运行时、现代 HTTP 客户端、禁参数变异、不为一次性操作写辅助函数;并给出各语言 2026 规范库建议。具体语言铁则与命令细节未在资料中展开,需查阅对应 references 文件,本介绍不补充未提供内容。