pi-hunk-review

桥接Pi与Hunk实现实时diff审查与修复

开发流程 审查AI生成代码排查代码漏洞审查代码规范 通用 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-hunk-review。
它的用途是:桥接Pi与Hunk实现实时diff审查与修复
完整的 Skill 内容见:https://321skill.com/skills/pi-hunk-review/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'/hunk-review zh',它会自动审查当前git diff,并用中文将发现的问题作为Hunk行内评论发布。

对AI说:'/hunk-fix',它会读取Hunk中已有的评论,自动修改代码并运行相关检查。

对AI说:'/hunk-review zh 重点检查认证与授权回归',它会附加指令进行针对性审查。

介绍

这个Skill解决了代码审查与AI修复脱节的问题。在实际开发中,开发者通常需要手动运行lint工具或切换网页去查看PR评论,而AI生成的审查意见往往无法直接与本地实时diff联动。pi-hunk-review让Pi能够直接读取当前git diff,并通过Hunk的行内评论机制将审查结果嵌入到开发者的工作流中,同时支持自动修复。

使用方式很简单,你只需要先在一个终端中启动Hunk的实时diff监视:hunk diff --watch,然后在另一个终端中进入同一Git仓库启动Pi。之后就可以通过自然语言指令来执行审查和修复,例如运行/hunk-review zh让Pi用中文审查当前diff,或者运行/hunk-fix让Pi读取Hunk中的评论并自动修改代码。命令还支持附加额外指令,比如/hunk-review zh 重点检查认证与授权

它非常适合需要高效代码审查的团队或个人,尤其是那些已经使用Git进行协作、希望AI能辅助审查并直接修复代码的开发者。无论是后端开发、前端开发还是测试工程师,都可以在本地开发环境中快速获得AI的实时反馈,减少低效的来回沟通。同时,它也适用于需要多语言审查的场景,支持中、日、韩、西、法等11种语言。

建议在审查前确保Hunk会话已启动且与Pi在同一仓库目录下。需要注意的是,Hunk和Pi都是终端UI,必须分别运行在两个终端中;如果Hunk不在PATH中,需要设置环境变量HUNK_BIN。此外,/hunk-fix不会自动清除评论,修复后建议手动清理以避免混淆。

常见问题

如何安装Hunk?

使用Homebrew执行`brew install hunk`,或使用npm执行`npm i -g hunkdiff`。

为什么运行/hunk-review没有反应?

请确认已启动Hunk会话(`hunk diff --watch`),且当前目录是同一Git仓库。另外,确保Pi已加载该扩展,可以运行`/hunk-status`检查连接状态。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-hunk-review/raw/index.md 读取 pi-hunk-review 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。