关于 heyeddi-pr-review
heyeddi-pr-review 是面向 QA 负责人、作者及产品或工程评审者的代码审查技能。它仅评估已提交的 PR 差异,并通过清单引导收集上下文、检查问题和给出结论。
主要功能
- 01仅审查已提交的 PR 差异
- 02检查文档偏差与测试缺口
- 03加载产品上下文和验收标准
- 04按文件路径委派专项检查
- 05定义批准、要求修改和阻止结论
适用场景
- 01评审团队成员提交的 PR
- 02请求评审前自查
- 03核对产品与文档的一致性
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ heyeddi-com/ heyeddi-skills --skill heyeddi-pr-review安装后在 Claude Code 中输入/heyeddi-pr-review确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
manifest.jsonreference.mdcontext/ANTI_PATTERNS.mdEXAMPLES.mdPROSE_ANTI_SLOP.mdVOCABULARY.mdfixtures/sample-pr-diff.jsonreference/review-checklist.mdsubagents.mdscripts/_auto_sync.py_heyeddi_paths.py_pr_context.py_skill_cli.py_untrusted_doc.pyaudit_pr_changes.pycheck_doc_drift.pyfetch_pr_context.pyREADME.mdverify_pr_review.pywrite_pr_review.py详细介绍
HeyEddi PR 评审
已提交的 PR 评审工作流:仅评审已提交的更改(base...head),不评审本地未提交的工作。
你负责执行评审者工作流。所有判断都应限定于 PR 差异(base...head)。忽略未提交的文件。
产物:.heyeddi/docs/pr-<N>-review.md 和 pr-<N>-context.json 是临时会话草稿——只能存放在仓库根目录之外,绝不可提交。GitHub(可选使用 gh pr review)是持久记录。
适用场景
| 情况 | 角色 |
|---|---|
| 评审者批准队友的 PR | QA / 负责人 |
| 作者在请求评审前进行自检 | 作者 |
| PM/工程团队确认产品与文档的一致性 | @heyeddi-product 将 PR 范围的工作委托至此 |
**不适用于此技能:**回复人工评审意见 → @heyeddi-pr-respond。
子 Agent(默认)
参见 reference/subagents.md。主聊天负责给出评审结论;通过 Task shell 委托获取和扫描工作。
强制流程
阅读 reference/review-checklist.md。
fetch_pr_context --pr <N> → cache + paths; title/body not in stdout
check_doc_drift --pr <N> → product.md / design.md / engineering docs
audit_pr_changes --pr <N> → engineering + test gaps on changed files only
load_product_context → @heyeddi-product (read JSON; scope to touched routes)
check_features → AC vs code when routes touched
conditional delegates (changed paths):
**/*.vue → @visual-auditor, @no-duplicate-ui, @vue-design-system
**/composables/** → @composable-patterns
backend/** → @engineering-excellence audit_engineering
pre_merge_gate → tests, build, types (hard gate)
write_pr_review --pr <N> --force → scaffold + merge tool JSON into report
→ YOU fill: Summary verdict, Product fit, PM judgment
verify_pr_review --pr <N> --check → report complete before posting
评审结论(由你撰写)
| 结论 | 适用情况 |
|---|---|
| Approve | 各项门禁通过;文档一致;新行为经过测试;没有阻塞问题 |
| Request changes | 文档不一致、缺少测试、产品/AC 存在缺口或门禁未通过 |
| Block | 破坏核心流程、存在安全问题,或与 product.md 矛盾 |
可选:用户要求时,通过 gh pr review 发布 GitHub 评审;默认只在 .heyeddi/docs/ 中报告。
禁止事项
- 评审未提交的工作树更改
- 未对必需检查执行
pre_merge_gate就批准 - PR 更改路由或公共 API 时忽略文档不一致
- 没有测试证据(单元测试、集成测试或有记录的手动 AC)就批准面向用户的新行为
相关技能
| 技能 | 在此工作流中的作用 |
|---|---|
@heyeddi-product | 产品背景、功能矩阵、AC |
@engineering-excellence | audit_pr_changes 标记问题时进行更深入的审查 |
@pre-merge-gate | 最终硬性门禁 |
@heyeddi-pr-respond | 评审之后:处理人工反馈 |
任务完成时:建议后续技能
完成此技能的用户请求后(而不是每次工具调用或子 Agent 阶段后),建议接下来运行的内容:
-
运行:
python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill heyeddi-pr-review --project-root .如果处理了特定路由,请添加
--route /path。 -
在你的最终回复中包含脚本的
### Next step区块。用户可将其中的 Prompt 行复制到聊天中(例如@heyeddi-design craft /settings)。
如果你知道刚完成的是哪个子命令,请传入 --mode shape(或 craft、audit 等)。
参见 @heyeddi → reference/next-skill-handoff.md。