SuperAPI AI 工具集

understand

编程与开发

查看项目

更新于 11-06 09:09

技能介绍

understand 是一个面向开发者的理解型技能,目标是在评审或安全改动某项“范围内的工作”之前,先把对象讲清楚。依据资料,它适用于开发者需要理解并判断某项变更集、子系统、决策、计划或概念的场景,内容包括流程、原因与取舍。

主要能力:通过证据、图示、阅读路线、备选方案与验证方式来解释目标;输出一份完整的教学报告(§0–§13),包含必备图示与评审阶段,并在聊天中给出执行摘要。报告可在 Markdown 基础上按需额外生成自包含 HTML。

使用方式:独立调用,工作流与收尾类技能不会调用它。不带目标时解释当前上下文(当前任务、工作区改动含未跟踪文件、活跃计划或最新 watzup 摘要);也可精确解释用户指定的目标。执行流程分步骤:解析范围并规划报告(先低成本估算规模并分级 S0–S4)→收集材料→排序材料→打开教学报告→撰写教学与路由报告→在聊天中总结收尾。规模较大时可拆分多个可独立解释的分组,S2 以上用只读收集代理并行收集,S3 以上由分组代理各自负责互不重叠的片段,最终由编排者统一写入合并报告。

限制与规则:对代码、计划与文档只读,只写入被 git 忽略的工作产物,绝不写入被 git 跟踪的路径,也不复现密钥值;具体结论需有文件与行号证据,推断、已重构的备选方案和未执行的检查要如实标注;缺失参考资料时需指出缺失内容并以声明的阻碍代替静默省略;不做测验、复述、等待回答、结论裁定或理解门槛检查;不负责实际执行评审(由 changes-review 与 code-quality-review 执行),也不负责面向演示者的演示(由 demo-guide 负责)。

适用场景:理解变更集、子系统、关键决策、计划或概念,为人工评审做准备。平台、收费与价格等事实暂未提供。