SuperAPI AI 工具集

titans

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

titans(Code Review Triad)是一套三视角代码审查流程,核心是让三个并行子代理从不同视角审查同一范围,再汇总发现。

用途:在较大规模工作完成、准备合并前作为质量闸口;或定期做代码卫生检查。不适用于 50 行以内的快速修复、探索性原型、一次性脚本,或需要速度而非彻底度的场景。该三视角模式也被描述可用于文档、架构、流程、CLAUDE.md 等非代码对象的审查。

三个视角:Epimetheus 关注已出的问题与潜在隐患(缺陷、债务、脆弱性、安全);Metis 关注当下成品质量(清晰度、惯用法、结构、测试);Prometheus 关注是否服务于未来目标(愿景、可扩展性、知识捕获)。三者是小幅重叠的视角而非互斥分区。

使用方式:先界定审查范围(特定文件、目录或本次会话改动),准备可用上下文(CLAUDE.md、README、架构文档)与已知目标;若范围不清应先询问,避免误审整个代码库。随后并行调度三个 Task,使用 Explore 子代理并指定 model: "opus",每个评审者获得对应视角的评审简报、范围内的文件与上下文、输出结构模板,并知晓另外两位评审者的存在以减少重复。示例调用结构为 Task(subagent_type: "Explore", model: "opus", description: "EPIMETHEUS review of [scope]", prompt: "[评审简报]+[文件]+[输出模板]")。

输出结构:每位评审者按 Findings(问题、位置、严重度 critical/warning/note、修复复杂度)、Assessed Under Assumptions(先声明假设再给条件性结论)、Could Not Assess(缺失信息)、Questions(能深化审查的具体问题)四段输出。随后综合:多评审者共识的高优先项、暴露权衡的分歧、重复出现的无法评估项(视为文档债)、发布前关键路径、可延后作为技术债的项、待解决问题。

限制与处理:若某评审者超时、报错或输出异常,可先以现有结果继续并在综合中标注缺失视角,或缩小范围后重跑。部分失败时两份评审仍优于没有。若某评审者似乎在循环,通常意味着范围不清,宜中断并重新界定范围而非等待。反模式包括范围模糊、跳过综合、忽略部分失败、在完成前过早审查。文中的实测 token 用量提示:Epimetheus 最多、Metis 居中、Prometheus 最少,具体因代码库规模与范围清晰度而异。titans 可与 /open、/close 流程衔接:关键问题进 Now 桶,低优先项进 Next 桶,文档债交给交接 Gotchas 部分。