用途
pr-review 是一个代码审查技能,用于审查拉取请求(Pull Request)。它扮演代码变更审查者的角色,目标是识别可能影响代码库质量、正确性或安全性的问题。
主要能力
- 标准审查:读取并遵循同目录下的 _review-core.md 文件中的审查方法论,对 PR 进行审查。
- Markdown 输出:默认以 Markdown 格式输出审查结果,包含 PR 标题、URL、作者、分支信息、摘要、按优先级分类的发现项(P0 严重、P1 高、P2 中、P3 低)以及最终裁决。
- JSON 输出:通过 --json 标志输出结构化 JSON,适用于 CI 中的行内评论。JSON 包含 PR 编号、标题、URL、作者、分支、提交 SHA、摘要、发现项数组、裁决(评估、置信度、理由、所需操作)、按优先级统计的问题数量以及 diff 统计信息。
- 魔鬼代言人模式:通过 --devils-advocate 标志,在标准审查完成后额外运行一轮对抗性审查,挑战假设、压力测试边界情况,并质疑 PR 的方法是否正确。该模式会生成子代理,合并发现项(以 [DA] 前缀标识),并可能调整裁决和置信度。
- 完整审查模式:通过 --full 标志,在标准审查完成后并行运行所有附加审查流程,包括魔鬼代言人、JIRA 完整性验证和代码简化审查。--full 隐含 --devils-advocate。
- JIRA 完整性验证:从分支名、PR 标题和描述、提交信息中提取 JIRA 票据 ID(匹配 AG-\d+ 或 ST-\d+ 模式),生成子代理进行验证,合并发现项(以 [JIRA] 前缀标识),并在 JSON 输出中包含 jira_summary 对象。如果未找到任何 JIRA ID,会添加一条 P1 发现项。
- 代码简化审查:生成子代理对 PR 更改的文件执行 /simplify 技能的分析,关注重用、质量和效率,报告发现项(以 [SIMPLIFY] 前缀标识)但不进行编辑。
使用方式
解析 ARGUMENTS 环境变量(或技能参数)以获取标志和 PR 编号。支持的参数包括:
--json:输出结构化 JSON 而非 Markdown。--devils-advocate:在标准审查后运行额外的魔鬼代言人审查。--full:运行所有附加审查流程(魔鬼代言人 + JIRA 完整性验证 + 代码简化审查)。- 剩余位置参数:PR 编号。
示例:123、--json 123、123 --json、--devils-advocate 123、--full 123、--json --full 123。
适用场景
- 代码审查自动化,尤其适合集成到 CI 流程中。
- 需要结构化审查输出以便进行行内评论的场景。
- 需要额外对抗性审查或完整性验证的 PR。
限制
- 该技能依赖同目录下的 _review-core.md 文件提供审查方法论。
- 魔鬼代言人模式、JIRA 完整性验证和代码简化审查需要生成子代理,可能依赖特定的 Agent 工具。
- JIRA 完整性验证仅识别 AG-\d+ 或 ST-\d+ 模式的票据 ID。
- 代码简化审查仅报告发现项,不进行自动修复。
- 关于收费、价格、平台支持等具体信息暂未提供。