技能介绍

要解决的问题

代码评审是合并前的关键闸门，但纯人工评审容易陷入三种困境：一是只盯着 diff 行，忽略跨文件的类型契约、迁移脚本和文档是否同步；二是 PR 描述缺失或过于笼统，评审者要花大量时间反推改动意图；三是同类问题反复出现，评审意见却没有沉淀成可执行的改进项。对 agent 驱动的工作流来说，更需要一次自动化、结构化的预审，把能自动化的检查前置。

技能如何工作

该技能把 PR-Agent 包装成一个可被 agent 调用的审查步骤，核心能力包括：

结构化摘要：生成覆盖改动范围、关键影响面和风险点的 PR 摘要，而不是逐行复述 diff。
自动化检查：对拉取请求执行规则化检查，输出可定位的问题项。
评论与改进提示：在 PR 中留下具体改进建议，并附带后续 prompt，便于继续追问或澄清。
ask-mode 跟进：当信息不足时，以问答方式继续收集上下文，再决定是否推进合并审查。

关键步骤是：先运行一轮自动化审查 pass，收集摘要、检查项和评论；再根据改进提示决定是否发起 ask-mode 追问；最后把结果交给人工合并评审。

适用边界

该技能定位于 human merge review 之前的自动化预审，不替代最终合并决策。上游仓库的源码与安装说明无法自动提取，因此不要把它直接用于敏感发布流程；接入前应自行审阅上游项目，并确认 Git provider access、LLM API key 与 Python/pip 环境满足要求。