review

用途：该技能把代码审查委托给 pi CLI 工具（@earendil-works/pi-coding-agent）。pi 以只读工具运行，防止误改代码，只分析并以文本返回发现结果。使用前需检查安装：command -v pi >/dev/null 2>&1，未安装则提示用户并停止。\n\n主要能力与审查目标：默认（无目标）审查 git diff HEAD 的暂存与未暂存改动，此时 pi 工具限制为 read，仅能读取 diff 中提到的文件，不能搜索代码库或运行 git；目标支持 --branch <name>（git diff main...<branch>）、--diff <range>、@filepath（指定文件）、PR 编号（gh pr diff <n>），这些显式目标或 --explore 会把工具集扩展为 read,grep,find,ls；任何情况都不包含 bash，不能编辑文件或运行 git。\n\n配置与参数：设置通过 JSON 文件持久化，优先级为 CLI 参数 > .claude/pi.local.json > .claude/pi.json > ~/.claude/pi.local.json > 内置默认。支持 --endpoint、--model、--thinking（off/minimal/low/medium/high/xhigh/max）、--explore、--with-packages 等参数；--edit-config 打开设置文件，--list-models 列出已配置端点与模型后停止。\n\n执行方式：不直接运行 pi，而是通过 Task 工具启动 pi:pi-agent 执行层，传入 MODE、TASK、PROVIDER、MODEL、ENDPOINT、THINKING、TOOLS、WITH_PACKAGES、APPEND_PATHS、FILE_REFS、CLEANUP_FILES；不传 API_KEY 与 BASE_URL。CLAUDE.md 与 git 上下文通过 --append-system-prompt 传入。审查维度包括正确性、代码质量、安全、架构与测试，发现按严重级别（HIGH/MEDIUM/LOW）分组并给出 file:line 与修复建议，无问题则明确说明。\n\n限制：默认目标是未提交的工作区改动，无改动时报告并停止；pi 未配置（缺少 API key）、提供方/模型不可用、任务被中断等会导致错误退出；stdout 为空但退出码为 0 时视为模型可能未理解任务。具体收费、价格、平台与效果资料暂未提供。