技能介绍

问题背景

团队在合并前常遇到几类摩擦：PR 里混着关键逻辑、格式化噪声和生成文件；提交消息不符合 Conventional Commits；大 PR 评审时间拉长、缺陷逃逸率上升；AI 共写代码的安全与秘密泄露风险被低估。Guardian 定位在 实现完成 → 请求评审 之间：对暂存或分支上的变更做结构化分析，输出可执行的 Git/PR 建议，而不是替你做破坏性 Git 操作。

如何工作

默认走 SURVEY → PLAN → VERIFY → PRESENT 四段流程，并遵循仓库内的 _common/GIT_GUIDELINES.md、_common/BOUNDARIES.md 与 .agents/guardian.md。

变更分类：按文件标记为关键 / 支持 / 附带 / 生成 / 配置，并计算 PR 大小等级与 noise_ratio
质量与风险：给出 0–100 质量分与 A+–F 等级、risk_score 及安全分类；security_classification == CRITICAL 时阻塞并转交 Sentinel
Recipe 子命令：pr（默认 PR 准备）、commit（原子提交拆分）、naming、strategy、reshape、audit（只读历史诊断）、split（堆叠 PR 计划）、health、ship（端到端交付，合并前必询问）
协作路由：接收 Builder、Zen、Scout、Atlas、Ripple、Harvest、Launch、Judge 等交接；向 Radar（覆盖缺口）、Zen（噪声）、Judge（带风险上下文的评审包）等出站

交付物固定包含五块：变更分类表、大小与信噪比、质量评分、风险评估、可操作建议（含是否阻塞）。

边界与注意

Guardian 是 评审准备分析报告 的作者，不是 PR 正文的粘贴器；报告需提炼进 PR 描述，而非全文复制。参考线如 noise_ratio > 0.30 → Zen、coverage_gap > 0.40 → Radar 用于路由与警告，硬门控（CRITICAL 安全、intent_alignment == FAIL）不可跳过。绝不静默丢弃变更、未经确认强制推送/重写共享分支历史，或在未满足 ship 的七项门控时自动合并。

截图预览

使用场景

功能开发收尾、尚未开 PR 时，对暂存或分支 diff 做关键/支持/噪声分类，并输出质量分、风险等级与审阅者建议。
单分支改动已达 M 级以上，需要按文件边界与依赖顺序规划堆叠 PR，并把每段控制在约 10–15 分钟可评审规模。
提交历史里混有 WIP、fixup 或不符合 Conventional Commits，先跑只读 `audit`，再决定用 `commit` 拆分或 `reshape` 重写。
热修复或发布 PR 已绿 CI，合并前用 `ship` 核对 security、intent_alignment、批准状态等硬门控，合并步骤仅作建议且需人工确认。