Ian-zy1 zy-xr
Cross-model Review — 跨模型交叉评审
When to Use
- 用户说
/zy-xr、/xr、交叉评审、交叉审阅 - 用户完成需求文档后（可主动建议对
.project/requirements/下的文件做评审） - 用户完成架构设计后（可主动建议评审）
- 用户对某个重要文件想获得"第二意见"时
核心理念
One file in, one review out. Zero ceremony. Zero dependencies. Platform-agnostic.
不适用场景
- PR code review → 用
code-reviewskill - 需求追踪 → 用
zy-track
执行模式
自动检测可用模式，优先 Mode A。
Mode A：会话内 sub-agent（首选）
在当前会话内启动一个不同模型的 sub-agent：
| 平台 | 方式 |
|---|---|
| Claude Code | Agent tool + model 参数指定不同模型 |
| OpenCode | 使用 task() 调用。示例：task(category="quick", load_skills=[], run_in_background=false, prompt="你是一名独立的技术评审员...（填充评审模板后的完整提示词）")。通过选择不同的 category 来间接选择不同模型 |
| 其他 | 使用平台原生 sub-agent 机制 |
如果 sub-agent 失败（超时、模型不可用），报告错误并停止。不自动重试。
Mode B：跨窗口文件交接（备选）
1. Agent 填充评审模板 → 写入 {target}.xr-request.md
2. 用户打开另一个 agent 窗口，说 "执行 xr 评审"
3. 另一个 Agent 读取请求文件，执行评审，写入 {target}.xr.md
用户协调，零配置——只有文件。
评审流程
1. 读取目标文件
- 无路径 → 列出当前目录文件让用户选择
- 路径不存在 → 提示并停止
- 文件太大（>100KB）→ 提示拆分或选择部分
2. 确认评审配置（简短，一个问题）
审阅模型: {default} (或指定其他模型)
默认模型选择规则：选择与当前会话不同的模型：
| 当前模型家族 | 默认评审模型 |
|---|---|
| Claude opus | Claude sonnet |
| Claude sonnet | Claude opus |
| Claude haiku | Claude sonnet |
| GLM 系列 | 优先用 Claude 或 GPT 系列（跨厂商视角差异更大） |
| Kimi 系列 | 优先用 Claude 或 GLM 系列 |
| GPT 系列 | 优先用 Claude 或 Kimi 系列 |
无法判断当前模型时：选择可用模型列表中与你认为的当前模型最不相似的一个。
用户可通过 --model 覆盖。
如果用户指定 --focus "安全性"，跳过维度自动检测，直接用 focus。
3. 填充评审模板
读取评审提示词模板：@templates/review-prompt.md
替换占位符：
| 占位符 | 替换为 |
|---|---|
{dimensions} |
自动检测（见 @references/dimensions.md）或 --focus 值 |
{filename} |
目标文件路径 |
{content} |
目标文件内容 |
如果指定了 --focus，在维度部分后追加 重点关注: {focus}。
4. 执行评审
使用可用模式（A 优先，B 备选）执行评审。
5. 写入评审文件
- 路径：
{original_without_ext}.xr.md - 例：
docs/architecture.md→docs/architecture.xr.md - 文件已存在 → 直接覆盖
6. 追加评审摘要到原文件
zy-track 需求（路径含 .project/requirements/）
如果文件有 ## 进度记录 部分，追加：
### {date} (xr - {model})
- 关键反馈: {1-2 sentence summary of must-fix items}
- 修订状态: 待采纳
如果没有 ## 进度记录 → 走通用摘要逻辑。
其他文件（含无进度记录的需求）
追加 HTML 注释（不影响渲染）：
<!-- xr: {date} | {model} | ❌ {must-fix summary} | ⚠️ {suggestion count}项建议见 .xr.md -->
维度自动检测
根据文件路径/扩展名自动选择评审维度，详见：@references/dimensions.md
用户可通过 --dimensions 或 --focus 覆盖。
参数
| 参数 | 说明 | 示例 |
|---|---|---|
<file> |
目标文件路径 | /zy-xr docs/arch.md |
--model |
指定评审模型 | --model sonnet |
--dimensions |
自定义维度 | --dimensions A,B,C |
--focus |
聚焦特定方面 | --focus 安全性 |
Common Traps
- 不要用当前模型评审自己的输出 — 必须用不同模型，否则失去"不同视角"的意义
- 不要把完整评审追加到原文件 — 只追加一行摘要（HTML 注释或进度记录），完整评审写入
.xr.md - 评审提示不要比被评审内容还长 — 模板要精简，核心是指令不是模板
- Mode B 文件交接时用户需要手动在另一个窗口执行 — 不要假设自动化，明确告诉用户步骤
约束
- 不自动触发
- 不创建新目录
- 不让评审提示比被评审内容还长
- 不跳过模型确认
- 不假设特定 sub-agent API——适配当前平台
- 不将完整评审追加到原文件——只追加一行摘要