用途:difit-review 用于把指定 git diff(本地修订、GitHub URL、补丁文件等)在 difit 本地差异查看器中打开,并由智能体通过评论机制附加审查发现或代码解释。difit 会打开外部浏览器界面并启动长时运行的本地服务,因此必须由用户明确选择加入:仅当用户点名 difit、要求用 difit 查看/展示/标注,或直接调用该技能时才使用;普通审查请求(如“审查这些改动”“找问题”“审查此 PR/提交/分支”)不走此技能,歧义时优先走普通审查路径。
主要能力:通过 --comment 传入 JSON 评论,形状为 {"type":"thread","filePath":"...","position":{"side":"old|new","line":N 或 {"start":N,"end":M}},"body":"..."}。按用户语言写评论正文;目标侧存在的行用 side 为 new,仅删除侧存在的行用 old;跨多行问题用范围评论。命令选择规则:command -v difit 成功则用 difit,否则用 npx difit;若回退到 npx difit 需要沙箱内网络权限,先请求提权与用户批准。
使用方式:先确认目标 diff 并正常理解内容、必要时检查周边代码,再准备评论并启动 difit,例如 <difit-command> <target> [compare-with] 加多个 --comment。未提交改动用 .,工作区用 working,暂存区用 staged,stdin 用 diff -u file1 file2 | <difit-command>。若决定纳入尚未加入 git 的文件,加 --include-untracked。同一 Git 根与目标最多保留一个 difit 服务:已有运行的同一目标服务时,不再启动或重开 URL,改用 <difit-command> comment add --port <port> '<json>' 追加评论。若多轮审查,可用 --keep-alive 或 --background 启动(后者不自动开浏览器并打印端口、URL、pid 的 JSON),再用 comment add / comment get --port 继续。PR 审查应在本地检查,结果仅限 difit 输出,不回传远端 GitHub。不要将密钥、令牌、密码、API key、私钥等凭据复制进评论或命令行参数。最后分享 difit URL;若没有评论可附加需明确说明。
适用场景:需要人工友好阅读并标注 diff 的代码审查、解释和评审展示。
限制:必须显式授权启动;不用于普通审查请求;评论格式需遵循固定结构;启动前可能需提权;资料未提供验证页面或平台支持的更多细节。