Agent Skills
返回列表
代码风格一致性

代码风格一致性

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3299e856/code-style-consistency。

技能介绍

它要解决的问题

模型生成代码时很容易带出默认习惯：项目用 @/ 别名，它写 ../；项目封装了 request，它直接 fetch；项目用 cn() 组合 Tailwind 类，它裸写冲突类。结果代码能跑，但像外部临时工写的，维护成本高。这个技能把重点放在“先识别项目约定，再按约定生成”。

工作方式

  • 风格指纹：优先通过 scripts/scan_style.py 或用户提供的参考文件提取技术栈、命名、Import 路径、组件写法、样式方案、请求封装和错误处理。
  • 参考实现优先：新增组件、页面或 API 前，先定位项目内最相似文件，读取其骨架、Props、导入和导出方式，再替换业务逻辑。
  • 生成约束：对 UI 库、样式方案、状态管理、TypeScript 严格度、命名和注释语言做硬约束，避免混入未安装依赖或不匹配写法。
  • 偏离显式化：如果必须偏离项目风格，需要在输出中说明原因，而不是悄悄替换约定。

适用边界

它适合前端项目、已有代码库和明确技术栈场景；资料中提到的 scan_style.py、Ant Design、Tailwind、CSS Modules 等场景更具体。若项目约定只存在于口头知识里，仍需用户补充参考文件或回答少量探针问题。

使用场景

  • 在 React 项目新增商品卡片组件时，参考同层组件的导入、导出和类型写法生成代码。
  • 修改已有服务层请求函数时，先读取原文件，保持其错误处理、注释和请求封装习惯。
  • 在 Tailwind 项目里补写弹窗样式时，检查是否使用项目封装的类名合并工具，避免样式冲突。
  • 新增 API 调用文件时，对齐现有 api 或 services 目录的别名路径和类型定义方式。

适合人员

  • 负责维护 React 组件库的前端工程师，希望新增组件不被默认写法污染。
  • 接手老项目的工程师，需要按现有请求封装和类型定义方式补写功能。
  • 用 AI 生成代码的团队负责人，要求输出符合团队 ESLint、Prettier 和导入别名规范。
  • 负责代码审查的工程师，想减少因样式、状态管理或命名不一致带来的返工。