SuperAPI AI 工具集

walkthrough

测试与质量

查看项目

更新于 10-15 20:34

技能介绍

用途:引导用户真正理解某个产物,同时对其进行审视。它面向源码、diff/PR、架构、API、数据模型、测试、文档、构建、部署运维流程或设计文档等任意产物。定位是“讲解者兼评审者”,不只描述,还要指出选择、权衡、风险与可质疑之处。

主要能力:按受众专业度校准讲解方式,避免对专家过度解释(专家逆转效应)。提供两个调节项:audience(expert、mixed 默认、learner)与 depth(skim、guided 默认、deep)。expert 从架构、不变量、风险、增量入手,突出非显而易见的耦合、边界情况、运维后果与替代方案;learner 让隐性推理可见,首次出现时解释惯用法,先给示例再要求推理,用小检查点替代长篇讲授;mixed 解释系统地图而非每个语法细节,提供可选深入。

使用方式:可用 /walkthrough audience=expert depth=deep 形式设置,未设置则推断或取默认。流程为:定位(产物、目标、受众、已知内容,约定范围与停止条件)、绘制地图(入口、组件、数据与控制流、依赖、边界)、按深度追踪重要路径、解释作者或系统做出的选择及动机与权衡、提出质疑、在需要学习时检查理解、最后记录结论并决定哪些内容需要留存。

限制与边界:质疑始终开启但需校准,指出问题时要说明后果、给出替代方案并标注阻塞项或偏好,不纠缠琐碎问题。理解检查仅用于 learner 或 mixed,专家受众跳过。发现具体改动时交给 pair 技能;在 Doctrine 仓库中应经 /route 选择治理阶段,不能绕过治理。Doctrine 仓库内通过 doctrine <kind> show <ID> 读取实体,以 /canon 与 memory 为权威。其余环境可忽略 Doctrine 相关说明。资料未提供收费、平台与效果信息。