Code Review 与 CI

Claude Code 可以在本地、PR、云端和 CI/CD 里做 review 或自动化改动。关键先判断两件事:模型请求从哪里发出,代码和命令在哪里执行。

如果要把 Ultrareview、Ultraplan、Agent View、/goal、Routines 和 scheduled tasks 放在同一张图里看,先读 高级工作流与云端能力。

#严重性标准

官方 Code Review 主要把发现分成几类:

给 Claude 写 review 指令时要明确“什么算 Important”。例如支付、鉴权、权限、数据丢失、迁移脚本、生产配置通常要更严格。

#本地 review 流程

/code-review current diff, focus on correctness, security, migration risk, and missing tests. Treat style-only comments as nit.

更稳定的本地流程:

1. 先跑测试或静态检查,把失败输出给 Claude。
2. 让 Claude 只审当前 diff,不要让它泛读整个仓库。
3. 明确 severity 标准和“不报告”的范围。
4. 对重要发现要求文件和行号。
5. 修复后再让 Claude 复查同一 diff。

本地 review 会继续使用当前 session 的模型、effort、工具和 Passion8 网关配置。中途切 /model、/effort 或触发 fallback 会让下一轮缓存 miss。

#官方 Code Review

官方 Code Review 通过 GitHub 集成在 PR 上运行,可以自动发布 check run 和评论。它适合团队统一审查,但要配置:

如果你希望完全走 Passion8,优先使用本地 /code-review 或 CI runner 里的 headless CLI。官方云端 Code Review 不应默认算作本地 Passion8 流量。

#REVIEW.md 应该写什么

REVIEW.md 可以把 review 从泛泛而谈变成团队标准。

# Review instructions

## Important

Report issues that can cause auth bypass, data loss, payment error, privilege escalation, silent corruption, failed migration, or production outage.

## Nit

Limit nit comments to concrete maintainability problems. Do not report formatting already covered by linters.

## Always check

- Permission boundaries
- Error handling and retries
- Database migrations and rollback
- Tests for changed behavior

#Ultrareview

Ultrareview 是更深的云端多 agent review。它适合合并前做高置信度检查,不是每次小改都跑。

非交互使用时可以要求 JSON 输出,方便接入脚本或 CI。

#Ultraplan

Ultraplan 用于先在云端做复杂计划,再选择在 web 执行或把计划发回终端。

如果计划涉及内网、未提交文件或 Passion8 网关,优先把计划带回本地执行。

#GitHub Actions

GitHub Actions 可以让 Claude 响应 issue、PR 评论、失败测试或手工 workflow dispatch。接 Passion8 时,最关键是显式注入 env:

env:
  ANTHROPIC_BASE_URL: https://passion8.cc
  ANTHROPIC_AUTH_TOKEN: ${{ secrets.PASSION8_API_KEY }}

安全建议:

#GitLab CI/CD

GitLab 场景和 GitHub 类似,但需要额外关注 runner 权限、MR 权限和变量保护。

claude:
  variables:
    ANTHROPIC_BASE_URL: "https://passion8.cc"
    ANTHROPIC_AUTH_TOKEN: "$PASSION8_API_KEY"
  script:
    - claude -p "Review this merge request and summarize important correctness issues."

生产建议:

1. 只在 protected branches 或可信 MR 上开放写操作。
2. 对外部 contributor 的 MR 使用只读 review。
3. 把 cloud provider OIDC、Bedrock、Vertex 这类凭据和 Passion8 Key 分开管理。
4. MR 评论和 commit push 要使用最小权限 token。
5. CI job 的缓存和 artifacts 不要保存完整 transcript。

#缓存和成本

完整逐命令影响见 命令与缓存影响。

#官方参考

• Code Review
• Ultrareview
• Ultraplan
• Claude Code GitHub Actions
• Claude Code GitLab CI/CD

#相关页面