Agent Skills
返回列表
💻

结构可维护性评审

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-structural-review。

技能介绍

要解决什么问题

PR 评审里常把「对不对」和「结构好不好」搅在一起,留下大量「这里可以再干净一点」却说不清该删、该并、该迁到哪里。结构性债务(千行文件、意大利面分支、裸 unknown、非原子写库)往往在合并后才放大维护成本。

技能如何工作

本技能是一套只出报告的结构与可维护性量表:不改动文件、不代为开 PR。每条发现必须回答:具体应删除、折叠或重命名什么,以及规范落点在哪份文件的哪一行。

审查前先问五条主问题:变更让代码库变大还是变小;决策逻辑是否在 canonical 层;模块能否孤立理解;新类型是否结构到位;是否引入栈级回退(如 Next.js 16 仍用 middleware.ts)。

沿 10 条轴线打分:~1000 行文件、抽象是否值得存在、分支是否散落在渲染树、server action / hook / *.types.ts 等层级纪律、类型结构、await 写库是否包在事务内、五步以上顺序编排、Bun/Tailwind v4 等栈卫生、同行为可否用更少结构表达、直接调用优于魔法抽象。严重级别按 Blocker / Request Changes / Minor 排序输出,并附带可直接粘贴的 reviewer phrase。

适用边界

与 /code-review 正交:不重复挑正确性 Bug、测试覆盖率数字或仓库 instruction 违规。安全归 /security-audit;纯风格偏好(缩进、微命名)忽略。歧义时默认 Request Changes,成本由作者承担。

使用场景

  • 合并前希望按千行规则、抽象价值、分支集中度逐项把关,而非笼统说「结构不好」
  • 大型 React/Next 变更里要判断 mutation 是否应沉到 server action、派生状态是否该进 hook
  • TypeScript PR 里要揪出裸 unknown、内联 interface、未注释的 as 强转等结构性类型问题
  • 同一 PR 里出现 middleware.ts、tailwind.config 或 npm/npx 调用时要做栈级回退检查

适合人员

  • 维护 Next.js + shadcn 单体并在 review 中强制执行 proxy.ts、Bun、Tailwind v4 约定的 tech lead
  • 负责后端写路径审查、要求多段 `db.update` 必须事务或原子语义的后端 reviewer
  • 接手百人级前端模块、需在 PR 阶段阻止文件膨胀与渲染树内重复 if 分支的 maintainer
  • 与通用 /code-review 分工、只希望 AI 专注结构/devex 维度、避免重复报 Bug 的仓库维护者