用途:对 UnoPim 的代码变更或 PR 做合规审查,重点检查新增或修改的行,而非历史遗留代码。使用前需先掌握 unopim-standards 引用文件(laravel13.md、security.md、performance.md、scale.md、extensibility.md、localization.md、comments.md),本技能是将其应用到 diff 上的检查清单。
主要能力:按维度审查并给出阻断或高优先级结论。阻断维度包括:方法体、对象/数组字面量、路由组或 Blade 中新增的任何注释;硬编码颜色(十六进制、rgb、style、style 块、任意值、默认意图色阶及遗留色);存在 x-admin:: 组件却用原生 HTML;2 次以上重复的代码或标记;未加边界的 ->all()/->get()/->pluck(),循环内查询,缺失预加载,Blade 内查询,批量任务未用 ShouldQueue,未加索引的 where/orderBy/筛选列;跨库可移植性问题(裸 SQL 表名未加 DB::getTablePrefix()、硬编码 wk_、MySQL 专有 SQL、Elasticsearch 调用未按开关加 DB 回退);安全(写路由 ACL 覆盖、FormRequest、上传白名单、批量赋值、加密与审计、SSRF、CSV 公式转义);本地化(硬编码用户可见字符串、语言键目录与占位符);Octane 安全(单例持有请求或凭据状态);以及门禁验证证据是否真实运行。高优先级项包括模型代理、Laravel 13/PHP 8.4 写法、迁移目录、Provider 加载、测试、事件与路由命名。
使用方式:以 git diff -U0 为输入逐行判定;每条结论需按“[维度] [阻断|高|中]:违规陈述 / 位置 file:line / 标准 unopim-standards/<文件> / 对照 packages/Webkul 下真实示例路径 / 修复建议”的格式输出。
限制:属于人工审查,部分维度无法由钩子覆盖,需实际阅读 diff 并交叉核对路由文件与各 acl.php;不应以“钩子已通过”作为证据。审查范围只限新增或修改行,遗留行仅作提示。适用场景为 UnoPim 代码评审、PR 合规检查及约定与最佳实践咨询。其他细节资料暂未提供。