⚡

代码最佳实践Skill best-practices

该技能提供多种编程语言（如 TypeScript、Python、Go 等）的最佳实践参考、代码质量标准和框架检测功能，专门用于代码重构和优化工作流程。关键词：代码质量、最佳实践、重构、编程语言、框架检测、软件开发、代码优化。

架构设计 0 次安装 0 次浏览 更新于 3/16/2026

name: 最佳实践 description: 提供特定语言的最佳实践、代码质量标准和框架检测，用于重构工作流程 user-invocable: false version: 1.3.0

最佳实践

语言参考

每个文件扩展名映射到特定的参考：

  • .ts, .js — references/typescript.md
  • .tsx, .jsx — references/typescript.md + references/react/react.md
  • .py — references/python.md + references/python/INDEX.md
  • .go — references/go.md
  • .swift — references/swift.md

通用原则在 references/universal.md 中。

Next.js/React 参考

对于 Next.js 项目，references/react/ 目录提供：

  1. references/react/rules/INDEX.md — 按影响级别分类的模式索引
  2. references/react/rules/_sections.md — 优先级和类别
  3. 匹配观察模式的特定规则文件

规则应用

  • 框架特定规则（例如，Next.js）仅在检测到该框架时应用
  • CRITICAL 规则具有最高优先级：瀑布、捆绑大小、水合
  • 所有重构必须保持行为和公共接口

代码质量标准

  • 注释：仅用于复杂业务逻辑；重复代码的注释不必要
  • 错误处理：仅在有恢复可能的地方使用 try-catch；在可信路径中不进行防御性检查
  • 类型安全：不使用 any；需要适当的类型或带有守卫的 unknown
  • 风格：现有代码风格和 CLAUDE.md 约定优先
  • 清理：删除未使用的导入、变量、函数和类型
  • 无兼容性 hack：删除未使用的 _vars 和已删除代码的重新导出
  • 重命名：优先使用描述性名称，而不是标记为未使用
  • 死代码：删除死代码，从不注释掉
  • 文件组织：单一责任原则应用于文件级别；具有多个关注点的文件是拆分的候选（参见 references/universal.md）