代码风格治理官
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c91d71f3/code-style-governor。
技能介绍
团队里常见的痛点
代码风格讨论往往在 PR 里反复出现:有人只谈「可读性」「一致性」却落不到具体条文,Reviewer 各凭经验挑刺,作者也不知道哪些是必须改、哪些可以协商。规范文档若只有原则、没有与当前仓库语言栈和目录结构对齐的规则,落地时要么形同虚设,要么引发「一次性全量格式化」的抵触。
技能如何组织规范与改造
Code Style Governor 按固定流程产出可执行材料,而不是再写一份空洞的「编码哲学」:
- 先根据项目语言栈划定范围,建立命名、目录、注释、导入顺序等规范基线。
- 结合
references/style-guide-checklist.md整理为落地规则清单,并明确标注硬性规则(应对齐 CI 阻断)与建议规则(Review 提醒即可)。 - 输出结构化结果:范围说明、强制/建议规则、自动化建议(如 ESLint、Prettier、Commit Hook),以及渐进治理路线图(短期、中期),并给出先易后难的一次改造可执行计划。
适用边界与注意点
技能自带质量红线:不允许只有原则没有可执行规则;不允许规则与项目现状完全脱节;也不应在没有迁移策略时要求一次性全量改造。若你希望的是单文件随手格式化,而不是团队级风格治理与审查清单,应选用更轻量的工具链而非本技能。
使用场景
- 新仓库或多语言单体要统一命名、目录与导入顺序,需要一份可对照 PR 的审查清单
- 老项目风格混乱,想在不大规模阻断交付的前提下分阶段收紧强制规则
- 准备把 ESLint、Prettier 或 Commit Hook 接入流水线,先要分清哪些规则必须 CI 失败
- 团队规范文档只有原则,需要落成带范围说明与短期/中期路线的可执行条文
适合人员
- 负责制定团队编码标准的技术负责人,要把 Review 争论收敛成可执行的强制/建议条目
- 维护 monorepo 或前后端同仓的工程师,需要按语言栈划定规范范围并规划渐进改造
- 搭建或改造 CI 的 DevOps/平台同学,要把风格规则映射到自动化与阻断策略
- 带新人较多的 Tech Lead,希望 PR 审查有统一清单而非每人一套口头习惯