SuperAPI AI 工具集

typescript

编程与开发

查看项目

更新于 10-15 22:33

技能介绍

用途:提供 TypeScript 开发的标准与最佳实践,在编写或修改 TypeScript 代码时作为规范指南使用。

主要能力与规范内容: 设计原则:遵循 DRY、KISS、SOLID,优先函数式,状态行为用类,组合优于继承,模块单一职责,类依赖用依赖注入。 代码风格:命名描述性强且简洁;公共 API、复杂逻辑用 JSDoc;显式类型标注,非必要不用 any;避免 barrel 导出以防循环依赖,优先直接导入。 类型安全:启用严格模式并配好类型定义;验证可用 Zod 等类型安全模式;未知类型用 unknown 而非 any,并适当收窄;显式标注以减少推断耗时。类型模式包括联合类型、可辨识联合、泛型约束及工具类型(Pick、Omit、Partial 等)。 架构:模块单一关注点与清晰边界,抽取可复用函数,类型与其使用就近放置;依赖注入便于测试,依赖尽量精简;遵循组合优于继承。 测试:测试目录镜像 src/ 结构,文件为 *.test.ts 或 *.spec.ts,命名具描述性;改动代码时检查单测。质量上采用 AAA 模式,覆盖边界与错误条件;单元与集成测试优先用 Vitest,覆盖率用 @vitest/coverage-v8,DOM 测试用 jsdom;端到端测试用 Playwright;适当 mock 外部依赖。 格式与检查:Prettier(printWidth: 120、singleQuote: true、jsxSingleQuote: true),运行 pnpm format 格式化、pnpm format:check 检查;ESLint 配合 @typescript-eslint/parser 与 @typescript-eslint/eslint-plugin,运行 pnpm lint 检查、pnpm lint:fix 自动修复。 框架与工具建议:轻客户端交互可选 Astro,重交互可选 React、Svelte 或 SolidJS;构建工具优先 Vite,倾向 Rolldown 等现代 Rust 工具,除特殊要求避免 Webpack 等旧式 JS 打包器;包管理优先 pnpm,在 package.json 使用 packageManager 字段,monorepo 用 pnpm workspaces(相关模式见 references/pnpm-monorepo.md)。 实现要点:提交前确保通过类型检查;相关改动与测试放在原子提交中;先查看既有工作流模式(如 spec-first、TDD)并遵循。

限制:资料未提供该技能的具体安装命令、支持的平台或版本范围、收费与价格信息,暂未提供。