deepreview

Deepreview

Deepreview 执行严格、基于证据的 code review。它有三种 mode：

• Current Changes Mode：review 当前 workspace 和 branch 相对 main 或指定 base ref 的 changes。
• PR Review Mode：review 指定 Pull Request 相对其 base branch 的完整 diff。
• All Repository Mode：review 仓库中的全部代码。

当用户要求 strict review、deep review、current unmerged changes review、PR review 或 full repository review 时，使用这个 skill。

Invocation Handling

直接映射这些短指令：

$deepreview
$deepreview 当前改动
$deepreview current changes
$deepreview --base main
$deepreview --base <ref>

使用 Current Changes Mode。裸 $deepreview 等价于 $deepreview --base main。如果提供了 --base <ref>， 就 review 当前 workspace 和 branch 相对该 base ref 的 changes，而不是默认 main。

$deepreview PR 123
$deepreview pr 123
$deepreview --pr 123

对 PR number 123 使用 PR Review Mode。

$deepreview --all
$deepreview all
$deepreview full
$deepreview repo
$deepreview 全部代码
$deepreview 整个仓库

使用 All Repository Mode。

如果同时提供 --all 和 --pr <number>，必须询问用户是要 review 整个仓库还是指定 PR，不要自行选择。 如果同时提供 --all 和 --base <ref>，使用 All Repository Mode，并把 --base 仅作为可选参照基线记录到 scope。 如果同时提供 --pr <number> 和 --base <ref>，使用 PR Review Mode，并把 --base 仅作为需要核对 PR base branch 的显式期望。如果用户要求 PR review 但没有给 PR number，先询问 PR number。若请求无法判断是 current changes、PR mode 还是 All Repository Mode，只问一个简短澄清问题。

Output Contract

始终把完整 review 结果写入 docs/reviews/ 下的 markdown 文件。目录不存在时创建。

写 review artifact 前，必须从本机系统时钟生成 timestamp。不要推断、手写或编造 timestamp。不要使用 001 这类计数器。

运行或执行等价操作：

mkdir -p docs/reviews
ts="$(date +%Y%m%d-%H%M%S)"

Current Changes Mode 使用生成的 timestamp：

docs/reviews/code-review-${ts}.md

PR Review Mode 使用生成的 timestamp：

docs/reviews/pr-<pr_number>-review-${ts}.md

All Repository Mode 使用生成的 timestamp：

docs/reviews/repo-review-${ts}.md

写入前，确认路径匹配以下格式之一：

docs/reviews/code-review-[0-9]{8}-[0-9]{6}.md
docs/reviews/pr-<pr_number>-review-[0-9]{8}-[0-9]{6}.md
docs/reviews/repo-review-[0-9]{8}-[0-9]{6}.md

最终回复用户时，只简要说明 review conclusion 和 output file path。