Agent Skills
返回列表
代码风格治理官

代码风格治理官

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c91d71f3/code-style-governor。

技能介绍

团队里常见的痛点

代码风格讨论往往在 PR 里反复出现:有人只谈「可读性」「一致性」却落不到具体条文,Reviewer 各凭经验挑刺,作者也不知道哪些是必须改、哪些可以协商。规范文档若只有原则、没有与当前仓库语言栈和目录结构对齐的规则,落地时要么形同虚设,要么引发「一次性全量格式化」的抵触。

技能如何组织规范与改造

Code Style Governor 按固定流程产出可执行材料,而不是再写一份空洞的「编码哲学」:

  1. 先根据项目语言栈划定范围,建立命名、目录、注释、导入顺序等规范基线。
  2. 结合 references/style-guide-checklist.md 整理为落地规则清单,并明确标注硬性规则(应对齐 CI 阻断)与建议规则(Review 提醒即可)。
  3. 输出结构化结果:范围说明、强制/建议规则、自动化建议(如 ESLint、Prettier、Commit Hook),以及渐进治理路线图(短期、中期),并给出先易后难的一次改造可执行计划。

适用边界与注意点

技能自带质量红线:不允许只有原则没有可执行规则;不允许规则与项目现状完全脱节;也不应在没有迁移策略时要求一次性全量改造。若你希望的是单文件随手格式化,而不是团队级风格治理与审查清单,应选用更轻量的工具链而非本技能。

使用场景

  • 新仓库或多语言单体要统一命名、目录与导入顺序,需要一份可对照 PR 的审查清单
  • 老项目风格混乱,想在不大规模阻断交付的前提下分阶段收紧强制规则
  • 准备把 ESLint、Prettier 或 Commit Hook 接入流水线,先要分清哪些规则必须 CI 失败
  • 团队规范文档只有原则,需要落成带范围说明与短期/中期路线的可执行条文

适合人员

  • 负责制定团队编码标准的技术负责人,要把 Review 争论收敛成可执行的强制/建议条目
  • 维护 monorepo 或前后端同仓的工程师,需要按语言栈划定规范范围并规划渐进改造
  • 搭建或改造 CI 的 DevOps/平台同学,要把风格规则映射到自动化与阻断策略
  • 带新人较多的 Tech Lead,希望 PR 审查有统一清单而非每人一套口头习惯