TypeScript、JavaScript、React和Node.js开发的通用编码标准、最佳实践和模式。技能概述cc-skill-coding-standards 技能是一个全面的编码标准技能提供TypeScript、JavaScript、React和Node.js开发的通用标准和最佳实践。该技能涵盖代码质量原则、命名规范、错误处理、性能优化、测试标准等多个方面帮助团队编写高质量、可维护的代码。下载地址https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/cc-skill-coding-standards主要功能代码质量原则可读性优先、KISS、DRY、YAGNI等核心原则TypeScript/JavaScript标准变量命名、函数命名、不可变性模式、错误处理React最佳实践组件结构、自定义Hook、状态管理、条件渲染API设计标准REST API约定、响应格式、输入验证性能优化记忆化、懒加载、数据库查询优化测试标准测试结构、命名规范、代码异味检测触发条件在以下情况下应该调用此技能编写TypeScript、JavaScript、React或Node.js代码时需要编码标准和最佳实践指导时进行代码审查时重构代码以提高质量时建立团队编码规范时代码质量原则核心原则可读性优先代码被阅读的次数远多于被编写的次数KISS保持简单避免过度工程化DRY不要重复自己提取通用逻辑YAGNI不要构建不需要的功能TypeScript/JavaScript标准命名规范变量命名使用描述性名称// ✅ GOOD: 描述性名称const marketSearchQuery electionconst isUserAuthenticated trueconst totalRevenue 1000// ❌ BAD: 不清晰的名称const q electionconst flag trueconst x 1000不可变性模式关键始终使用展开运算符// ✅ ALWAYS use spread operatorconst updatedUser { ...user, name: New Name }const updatedArray [...items, newItem]// ❌ NEVER mutate directlyuser.name New Name // BADitems.push(newItem) // BADReact最佳实践组件结构使用函数式组件和TypeScript类型明确定义Props接口使用默认参数保持组件简洁和可复用自定义Hook创建可复用的自定义Hook来封装逻辑使用use前缀命名返回需要的值和函数处理副作用和清理API设计标准REST API约定GET /api/markets # 列出所有市场GET /api/markets/:id # 获取特定市场POST /api/markets # 创建新市场PUT /api/markets/:id # 更新市场完整PATCH /api/markets/:id # 更新市场部分DELETE /api/markets/:id # 删除市场响应格式使用一致的响应结构success: boolean - 请求是否成功data?: T - 响应数据error?: string - 错误信息meta?: object - 元数据分页等性能最佳实践记忆化使用useMemo和useCallback优化性能懒加载使用React.lazy和Suspense延迟加载组件数据库查询只选择需要的列避免SELECT *并行执行使用Promise.all并行执行独立的异步操作测试标准测试结构AAA模式Arrange准备测试数据和环境Act执行被测试的操作Assert验证结果是否符合预期测试命名使用描述性的测试名称✅ returns empty array when no markets match query✅ throws error when OpenAI API key is missing❌ works❌ test search代码异味检测常见反模式长函数函数超过50行应拆分深层嵌套超过5层嵌套应使用早期返回魔法数字使用命名常量代替未解释的数字文件组织项目结构src/├── app/ # Next.js App Router│ ├── api/ # API路由│ ├── markets/ # 市场页面│ └── (auth)/ # 认证页面路由组├── components/ # React组件│ ├── ui/ # 通用UI组件│ ├── forms/ # 表单组件│ └── layouts/ # 布局组件├── hooks/ # 自定义React Hook├── lib/ # 工具和配置│ ├── api/ # API客户端│ ├── utils/ # 辅助函数│ └── constants/ # 常量├── types/ # TypeScript类型└── styles/ # 全局样式输入要求使用此技能时用户需要提供代码片段或文件编程语言和框架信息特定的编码问题或需求代码审查的上下文输出说明技能将提供编码标准和最佳实践建议代码改进建议和示例性能优化建议测试策略和示例代码异味检测和修复建议最佳实践保持一致性在整个项目中使用一致的编码风格优先可读性编写清晰、自文档化的代码处理错误实现全面的错误处理机制优化性能使用记忆化和懒加载等技术编写测试为关键功能编写单元测试和集成测试局限性仅当任务明确符合上述范围时使用此技能不要将输出作为环境特定验证、测试或专家审查的替代品如果缺少所需的输入、权限、安全边界或成功标准请停止并寻求澄清