SuperAPI AI 工具集

code-review

编程与开发

查看项目

更新于 10-15 17:47

技能介绍

用途

本技能用于对 LoongCollector 项目的代码变更进行安全导向、架构一致性优先的深度代码评审。其核心目标是发现真实缺陷、行为回归和风险点,而不是给出泛泛建议。技能定位为“高级代码审查助手”,适用于 PR 评审与分支评审两种场景。

主要能力

  • 增量评审:通过 reviewed_commits.json、patch-id 映射、hunk 指纹匹配等机制,只评审未覆盖的新变更,并在 rebase/force-push 时按置信度决定增量、局部补审或全量回退。
  • 评论状态双维跟踪:区分流程状态(status_flow:open/resolved/wont-fix/deferred)与技术状态(status_tech:fixed/not-fixed/false-positive/partially-fixed),并支持人工手动订正与终态跳过规则。
  • 快照机制:生成 snapshot/round-<n>/files/*、manifest.json、latest.json,用于下一轮增量决策辅助。
  • 专项 sub-agent 并行检查:按责任矩阵划分逻辑与架构、并发与生命周期、安全稳定与性能、复用合规与文档一致性四类检查。
  • 意图理解文档:产出含 Mermaid 图(至少 2 张)的 Code Review - Intent & Architecture Notes。
  • 最终报告:按严重度排序的 Findings、Lifecycle Verdict、Fix Plan、Validation Plan,并支持发布到 PR。

使用方式

技能定义了严格的执行步骤:

  1. Preflight:执行 python3 --version、git rev-parse --is-inside-work-tree、gh auth status,任一失败须停止并按 references/failure-playbook.md 修复。
  2. Local Branch Sync:同步远程 PR headRefOid 或分支 HEAD SHA,并在 final-report.md 顶部记录 head SHA。
  3. Review Plan:在评审目录生成并维护 review-plan.md,按大项+子项拆分并勾选。
  4. Phase 1:初始化评审工作区,使用脚本 init_review_workspace.py、fetch_review_comments.py、update_comment_status.py、generate_comment_status_report.py、incremental_review_mapper.py、build_snapshot.py 等。
  5. Phase 2:读取 project-knowledge、architecture.md、codebase-map.md 及相关规范,构建全局认知。
  6. Phase 3:产出意图理解文档并落盘到 code-review 目录,含至少 2 张 Mermaid 图。
  7. Phase 4:并行启动 3-4 个 sub-agent 专项检查。
  8. Phase 5:输出 Final Report 并落盘,可选发布到 PR。

脚本失败时允许进入降级评审模式,但须记录 script-failures.md、切换 full 全量评审、在报告中增加 Script Failure Feedback 小节。

适用场景

  • LoongCollector 项目的 PR 代码评审。
  • LoongCollector 分支代码评审。
  • 需要对增量变更做安全与架构一致性检查的场景。
  • 需要跟踪历史评审意见修复情况的场景。

限制

  • 技能明确要求结论必须基于实际读取到的代码与变更,不允许基于记忆或猜测。
  • 仅评论真实变更范围内的问题,避免“顺手重构建议”淹没核心缺陷。
  • 平台发布必须等待用户显式确认后才能执行。
  • 依赖 python3、git、gh 等工具,任一 Preflight 命令失败须停止评审。
  • 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。