SuperAPI AI 工具集

ts-google

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:这是一份基于 Google 内部 TypeScript 标准的风格指南技能,面向 AI 代理与 LLM,用于指导自动重构和代码生成,也可在人工编写、审查或重构 TypeScript 代码时作为统一规范参考。

主要能力:共 45 条规则,分为 8 个类别并按影响优先级排序:模块组织(module-,CRITICAL)含命名导出优先、避免可变导出、仅用 ES6 模块、避免命名空间、使用相对导入路径、import type、精简导出 API 面;类型安全(types-,CRITICAL)含禁用 any、对象优先接口、显式标注结构类型、正确处理可空类型、数组类型语法一致、禁用包装类型、优先 Map/Set、避免空对象类型;类设计(class-,HIGH)含参数属性、readonly 标记、用 TypeScript private、避免纯静态容器类、构造调用括号、不直接操作原型;函数模式(func-,HIGH)含函数声明优先、箭头函数简洁体、避免重绑 this、用剩余参数、生成器语法、少用默认参数;控制流(control-,MEDIUM-HIGH)含始终用大括号、恒用三等号、数组优先 for-of、switch 必带 default、条件中禁止赋值;错误处理(error-,MEDIUM)含只抛 Error 实例、catch 变量标为 unknown、空 catch 需注释、避免类型与非空断言;命名与风格(naming-,MEDIUM)含标识符命名风格、描述性命名、不用装饰性下划线、接口无 I 前缀、真正常量用 CONSTANT_CASE;字面量与强制转换(literal-,LOW-MEDIUM)含字符串单引号、正确的数字字面量格式、显式类型转换、避免 Array 构造器。

使用方式:按需阅读各参考文件获取详细说明与代码示例,包括 AGENTS.md(含全部规则的完整指南)、references/_sections.md(类别定义与顺序)、assets/templates/_template.md(新增规则模板)、metadata.json(版本与参考信息)。

适用场景:编写新 TypeScript 代码、组织模块与导入、设计类型注解与接口、创建类与函数、审查代码风格一致性、重构既有 TypeScript 代码。

限制:资料未提供具体安装命令、运行环境、收费或价格信息,暂未提供。