用途:为 TypeScript、JavaScript、React 和 Node.js 项目提供跨项目通用的编码规范与最佳实践,帮助保持代码可读、可维护、可重构。
主要能力:
- 代码质量原则:可读性优先、KISS、DRY、YAGNI。
- 命名规范:变量用描述性名称,函数用动词-名词模式。
- 不可变模式:使用展开运算符更新对象与数组,避免直接修改。
- 错误处理:检查响应状态并抛出明确错误,避免无处理调用。
- 异步实践:无依赖时用 Promise.all 并行执行。
- 类型安全:定义接口与联合类型,避免 any。
- React:带类型的函数组件、自定义 Hooks、函数式状态更新、清晰的条件渲染。
- API 设计:REST 约定、统一响应结构、使用 zod 做输入校验。
- 文件组织与命名:按 app、components、hooks、lib、types 等目录划分。
- 注释与 JSDoc:解释为什么而非是什么,为公开 API 写 JSDoc。
- 性能:useMemo、useCallback、懒加载、只查询所需字段。
- 测试:AAA 结构、描述性测试名。
- 代码坏味道:过长函数、深层嵌套、魔法数字。
使用方式:资料未提供具体安装命令或调用步骤,仅说明该技能适用于执行其概述中描述的工作流或操作。
适用场景:需要统一团队编码风格、评审代码或重构 TypeScript/JavaScript/React/Node.js 项目时。
限制:仅在任务明确匹配上述范围时使用;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。