SuperAPI AI 工具集

socratic-review

编程与开发

查看项目

更新于 10-16 04:32

技能介绍

用途:这是一个结对评审与重构会话技能,不是生成报告的静态工具。适用于评审自己的代码、同事的 PR 或接手的历史代码,目标是通过提问让用户自己看见问题,并对发现的问题采取行动。

主要能力:

  1. 静默评估:先自行理解代码。小范围目标(单个方法、短片段、聚焦 diff)直接内联阅读;较大或不熟悉的目标(多文件 PR、跨层 SHA、需追溯调用点的遗留代码)并行派发通用子代理探索,再综合其发现。每个坏味道要确定最佳重构手法(Extract Class、Move Method、Replace Conditional with Polymorphism 等)及执行顺序,合并为一份私有的按严重度排序的问题与手法清单,不对外展示。
  2. 让用户主导:开场用一两句表明已理解代码,然后根据上下文(自己写的、评审 PR、继承代码)问对应的开放式问题,等用户回答后再一次一个问题地推进。
  3. 引导触及盲区:当用户说完了自己能看到的,检查静默评估中尚未涉及的问题空间,用提问方式逐一打开(按严重度),而不是直接说出问题。
  4. 转向重构:诊断清晰后,先问测试是否绿、安全网是什么,再问第一步做什么、为什么先做这个。当用户提出的手法不匹配时,不直接纠正,而是提问引导其看到更深层问题,再精确命名手法和所恢复的原则,并指导排序。

问题库覆盖:职责与内聚、耦合与依赖、清晰度与意图、变更与设计、XP 与简单性、Rails 层次与 thoughtbot 模式、安全(强参数、SQL 注入、授权、XSS、批量赋值、数据暴露、限流)、性能(N+1、索引、后台任务、大数据量)、测试、错误处理、数据完整性、边界情况。重构问题库覆盖:命名坏味道、手法选择、测试安全、简单性。

结束:总结发现、约定手法与顺序、第一步,并询问是否要调整顺序或跳过。语气是资深结对伙伴而非老师,成功标准是用户能命名坏味道、命名手法、给出理由并知道何时停止。

限制:本资料未说明所依赖的 Agent 工具、子代理机制或 references/smell-explorer.md 的具体实现细节,也未提供收费、价格或平台信息,均暂未提供。