SuperAPI AI 工具集

requesting-review

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

用途:在完成任务、实现重要功能或合并到主分支前,调度 superpower-planning:code-reviewer 子智能体进行代码评审,在问题扩散前发现它们。核心原则是尽早评审、频繁评审。

必要评审时机:子智能体驱动开发中每个任务之后、完成重大项目步骤后、合并到 main 前、实现可能偏离已批准计划时。可选时机:卡住时、重构前、修复复杂 bug 后、做影响架构的改动后。

评审优先覆盖:计划对齐、代码质量、架构、文档与规范、严重程度语义(Critical / Important / Minor)。

用法:先获取 git SHA,例如 BASE_SHA=$(git rev-parse HEAD~1) 和 HEAD_SHA=$(git rev-parse HEAD),再用 Task 工具调度 code-reviewer 子智能体并填写模板。必需输入:{WHAT_WAS_IMPLEMENTED}、{PLAN_OR_REQUIREMENTS}、{BASE_SHA}、{HEAD_SHA}、{DESCRIPTION}。推荐输入:计划文件路径、规格文件路径、任务编号/标题、是中间任务评审还是最终实现评审。模板见 skills/requesting-review/code-reviewer.md。

反馈处理:Critical 问题立即修复;Important 问题除非有强技术理由,否则继续前修复;Minor 问题可稍后处理。若评审有误,可用技术理由和证据反驳;若发现计划漂移,要么修正实现以符合计划,要么明确更新计划/规格。

评审后:将评审结果追加到 .planning/progress.md,将技术洞见追加到 .planning/findings.md 的 ## Code Review Findings 下;若出现计划/规格漂移,需明确记录。

限制:该技能依赖 superpower-planning:code-reviewer 子智能体与对应模板文件;具体收费、平台支持等信息暂未提供。