sa-peer-review - SKILL.md Agent Skill

name: sa-peer_review description: 当完成任务、撰写主要章节，或在定稿前验证工作是否符合要求时使用

请求同行评审

分派 superpowers:code-reviewer 子智能体，在问题扩散之前捕捉它们。

核心原则： 尽早评审，频繁评审。

何时请求评审

强制性：

在子智能体驱动写作的每个任务之后
完成主要章节之后
在合并到主草稿之前

可选但有价值：

当卡住时（全新的视角）
在重写之前（基线检查）
在修复复杂的逻辑漏洞之后

如何请求

1. 获取版本记录 (Git SHAs):

BASE_SHA=$(git rev-parse HEAD~1)  # 或 origin/main
HEAD_SHA=$(git rev-parse HEAD)

2. 分派审稿子智能体:

使用 Task 工具调用 superpowers:code-reviewer 类型，填写 code-reviewer_zh.md 中的模板

占位符：

{WHAT_WAS_WRITTEN} - 你刚刚写了什么
{PLAN_OR_REQUIREMENTS} - 它应该包含什么论点
{BASE_SHA} - 起始提交
{HEAD_SHA} - 结束提交
{DESCRIPTION} - 简要总结

3. 根据反馈行动:

立即修复 严重 (Critical) 问题
在继续之前修复 重要 (Important) 问题
记录 次要 (Minor) 问题以备后用
如果审稿人错了，进行反驳（附带理由）

示例

[刚刚完成任务 2: 添加验证论据]

你: 让我在继续之前请求同行评审。

BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
HEAD_SHA=$(git rev-parse HEAD)

[分派 superpowers:code-reviewer 子智能体]
  WHAT_WAS_WRITTEN: 关于会话索引验证和修复的论证段落
  PLAN_OR_REQUIREMENTS: docs/plans/deployment-plan.md 中的任务 2
  BASE_SHA: a7981ec
  HEAD_SHA: 3df7661
  DESCRIPTION: 增加了 verifyIndex() 和 repairIndex() 的理论依据和 4 种问题类型
  
[子智能体返回]:
  优势: 架构清晰，论据真实
  问题:
    重要: 缺少进度指标的论述
    次要: 报告间隔 (100) 的依据不明确
  评估: 准备好继续

你: [添加进度指标论述]
[继续任务 3]

与工作流集成

子智能体驱动写作:

在每个任务后评审
在问题复合之前捕捉它们
在移动到下一个任务之前修复

执行计划:

在每个批次（3 个任务）后评审
获取反馈，应用，继续

临时写作:

在合并前评审
卡住时评审

危险信号

绝不：

因为“很简单”而跳过评审
忽略严重问题
在未修复重要问题的情况下继续
对有效的学术反馈进行无理争辩

如果审稿人错了：

用学术理由反驳
展示证明其成立的证据/引用
请求澄清

参见模板：peer_review/code-reviewer_zh.md