SuperAPI AI 工具集

understand

通用与其它

查看项目

更新于 10-15 21:36

技能介绍

用途:understand 用于在开发者需要解释、教学或了解如何评审某次改动时,生成一份完整的评审指南。默认解释当前工作上下文(当前任务列表与工作区改动),也可由提示指定目标,如某个计划、变更集/PR、子系统、设计决策、概念或缺陷原因。

主要能力:报告固定包含四部分——定位(做了什么、可视化地图、用户故事与业务规则)、路线(评审路径:先看哪些文件、按什么顺序、每步应能回答什么)、深度(所需概念、工作原理、为何选此方案、考虑过的其他方案、接受的取舍、影响与波及范围)、验证与反驳(测试与演示、你的判断、挑战此方案)。图示为强制项,包括系统流程图、领域 ERD 和每个主流程的时序图,且必须从图追踪、调用点或既有规格图推导,无法推导时明确说明阻塞。测试用例 ID 必须真实存在,无覆盖则记为缺口。替代方案需列出至少两个并给出具体优缺点。

使用方式:以 $understand 调用;在 Codex 中用 $skill-name 形式调用仓库技能。执行前需建立任务跟踪,按声明顺序执行步骤,不得跳过、重排或合并,除非用户明确批准。报告写入 plans/reports/understand-{YYMMDD}-{HHmm}-{slug}.md(git 忽略的工作产物),并在对话中给出摘要与报告路径;若找不到 git 忽略目录,则改为在对话中交付全部章节。

适用场景:需要理解或评审代码改动、学习项目子系统、评估设计决策、准备演示与测试、或希望获得可自行判断的证据链时。

限制:该技能只读代码与计划,仅写入 git 忽略的工作产物,不修改源码、计划或文档;不输出发现或结论,不阻塞提交或工作流;不向用户提问或测验,挑战性问题以书面形式给出;不编造测试 ID、方案权衡或图示节点;不展示任何密钥、令牌或客户标识,敏感值以占位符呈现。分类为编程与开发。