SuperAPI AI 工具集

aile-code-review

编程与开发

查看项目

更新于 10-16 04:40

技能介绍

用途

aile-code-review 是一个代码审查技能,用于在完成任务、实现主要功能或合并代码之前验证工作是否符合要求。其核心原则是“早复习、常复习”,目标是在问题级联发生之前发现并解决问题。该技能源自 superpowers 的代码审查能力,已迁移为 aile-only,策略上保留审查分级与反馈闭环,并对齐团队交付门禁。

主要能力

该技能通过调度 code-reviewer 子代理来执行代码审查。审查者会返回优势、问题(分为关键、重要、次要等级别)以及评估结论。使用者根据反馈采取行动:立即修复关键问题,在继续之前修复重要问题,注意稍后的小问题;如果审稿人判断有误,可以基于技术推理进行退回。

何时请求审查

强制场景包括:子代理驱动开发中的每个任务之后、完成主要功能后、合并到主程序之前。可选但有价值的场景包括:卡住时(获取新视角)、重构前(基线检查)、修复复杂错误后。

使用方式

  1. 获取 git SHA:
BASE_SHA=$(git rev-parse HEAD~1)  # or origin/main
HEAD_SHA=$(git rev-parse HEAD)
  1. 调度代码审阅者子代理:使用具有超能力的任务工具,选择代码审阅者类型,填写模板 code-reviewer.md。占位符包括:{WHAT_WAS_IMPLEMENTED}(你刚刚建造的)、{PLAN_OR_REQUIREMENTS}(它应该做什么)、{BASE_SHA}(开始提交)、{HEAD_SHA}(结束提交)、{DESCRIPTION}(简要总结)。

  2. 根据反馈采取行动:立即修复关键问题;在继续之前修复重要问题;注意稍后的小问题;如果审稿人错了就退回(附上推理)。

示例

[Just completed Task 2: Add verification function]

You: Let me request code review before proceeding.

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

[Dispatch superpowers:code-reviewer subagent]
  WHAT_WAS_IMPLEMENTED: Verification and repair functions for conversation index
  PLAN_OR_REQUIREMENTS: Task 2 from docs/plans/deployment-plan.md
  BASE_SHA: a7981ec
  HEAD_SHA: 3df7661
  DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types

[Subagent returns]:
  Strengths: Clean architecture, real tests
  Issues:
    Important: Missing progress indicators
    Minor: Magic number (100) for reporting interval
  Assessment: Ready to proceed

You: [Fix progress indicators]
[Continue to Task 3]

与工作流程集成

子代理驱动的开发:每项任务后回顾,在问题复杂化之前发现,在进行下一个任务之前修复。执行计划:每批后回顾(3个任务),获取反馈、申请、继续。临时开发:合并前审查,卡住时回顾。

危险信号

绝不:因为“很简单”而跳过评论;忽略关键问题;继续处理未解决的重要问题;用有效的技术回馈进行争论。如果审稿人错误:用技术推理进行反击;显示证明其有效的代码/测试;要求澄清。

限制

该技能的详细模板请参考 aile-code-review/code-reviewer.md。关于收费、价格、平台支持等具体信息,资料中暂未提供。