用途:位于 feature 流程实现完成之后、QA 之前的独立代码审查关卡,判断本次改动是否降低代码健康、是否朝 design 目标前进。只读代码与产物,只写 {slug}-review.md,不修代码、不改 checklist 与 design、不替代 QA 或验收。
主要能力:读取 .codestable/attention.md、{slug}-design.md、{slug}-checklist.yaml、实现汇报、git status --short 与 git diff(含 staged),审查 diff 涉及的人写代码与相邻调用点;先做 design、架构、复杂度、测试策略、风险面、文档归并影响等整体审查,再做行级审查(正确性、错误处理、数据与安全、性能资源、并发异步、可维护性、清洁度);按 blocking / important / nit / suggestion / learning / praise / residual-risk 分级,给出 passed、changes-requested 或 blocked 结论,写入带 frontmatter 的审查报告。
用法:先读取 attention.md 等必读文件并做启动检查,确认 checklist steps 全 done、diff 中有本 feature 改动;可运行自带脚本 python3 scripts/detect-review-agent.py --pretty 检测外部审查能力。优先用 Paseo 启动 audit 类 subagent 做独立只读审查,须遵循 paseo skill 规则并读取 ~/.paseo/orchestration-preferences.json、使用 providers.audit;只有 claude/gemini/aider 等 CLI 可见时默认不自动调用;无外部 reviewer 则本地审查,并记录 not-available、skipped-by-user 或 local-only。external reviewer 结论必须逐条本地核验后合并,不得直接当 blocking;一旦启动 reviewer 而未返回,只能标 blocked / independent-review-pending,由用户决定等待、重试或降级。
限制:默认任务由当前 agent 完成本地审查,独立 reviewer 属增强项而非硬依赖;缺失必读文件、归因不明或前置状态不满足时退回或标 blocked;不能边审查边改代码,不能用个人偏好升级为 blocking,blocking 修复后必须重跑本审查才可进入 QA。报告路径为 .codestable/features/{feature}/{slug}-review.md。其他未在资料中说明的细节暂未提供。