关于 rhdh-pr-review
用于分阶段获取 GitHub 拉取请求、分析代码并可选择发布审查结果的技能。它规定审查前置条件、对照 head SHA 验证,并为外部写入设置独立批准门槛。
主要功能
- 01分析前获取 PR 上下文
- 02区分仅审查与发布流程
- 03要求 /code-review 和 Adversarial 审查
- 04将发布目标固定到 head SHA
- 05外部写入前调用 mutation-gate
- 06在各阶段传递结构化结果
适用场景
- 01审查 PR 并发布已验证的发现
- 02分析 PR 但不发布审查
- 03依据审查时的 head SHA 核验发现
- 04报告审查与写入结果
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill rhdh-pr-review安装后在 Claude Code 中输入/rhdh-pr-review确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/review-perspectives.mdscripts/fetch_pr_context.pyworkflows/fetch-github.mdpost-to-github.mdreview-code.md详细介绍
RHDH 拉取请求审查
将 Forge I/O 保持在边缘:获取阶段生成 PR 上下文,分析仅使用该上下文和检出的代码,发布阶段只发送已根据 head SHA 验证的发现。
按结果选择流程
| 结果 | 工作流顺序 |
|---|---|
| 代码审查并发布 | workflows/fetch-github.md → workflows/review-code.md → workflows/post-to-github.md |
| 仅分析 | workflows/fetch-github.md → workflows/review-code.md;在编辑后的草稿处停止 |
仅提供 PR URL 或编号时,默认执行代码审查并发布。
审查原则
- 每条草稿审查路径都必须使用
/code-review,包括仅分析路径。如果缺少该工具,请停止,说明缺少code-review,指出/setup-rhdh-skills install,且不要以本地双维度审查替代。 - 每次运行
/code-review时也会派发 Adversarial。团队、工作树和草稿步骤位于workflows/review-code.md。 - 在说明任何发布操作之前,先展示完整的编辑后草稿。明确要求发布表示有此意图,并不代表已批准具体写入。
写入门禁
获取和分析均为只读操作。发布 GitHub 审查属于外部写入:调用指定的技能 mutation-gate,并遵循其负责的门禁,不要在此处重复说明。创建或移除本地 git 工作树不属于该门禁。
审查操作的目标会锁定 head SHA。先前对发现的确认不构成任何写入的批准。报告每项结果时,附上审查 URL、已完成的验证以及仍待完成的恢复操作。
各阶段传递的内容
每个阶段都会在对话中将结果传递给下一阶段。字段名称只在其产生的位置定义:
| 阶段 | 结果 | 定义位置 |
|---|---|---|
| 获取 | PR 上下文:repository、changeRequest、files、diff、linkedIssues、jiraKeys、existingComments、existingReviews、ciStatus、specSource | workflows/fetch-github.md |
| 分析 | 审查草稿:changeRequest、summary、verdict、findings、edited、worktreePath | workflows/review-code.md |
完成条件
报告列出已审查的 head SHA、展示 /code-review 的 Standards 和 Spec 报告,并展示编辑后的草稿,即表示完成。对于发布流程,还应给出每项已批准写入的结果及其目标。
评论
支持 Markdown