SuperAPI AI 工具集

understand-change

编程与开发

查看项目

更新于 10-16 08:43

技能介绍

用途:understand-change 作为一个教学型技能,目标是让用户深入理解某次“变更”(change),通过互动辅导完成从复述、追问原因到测验的学习过程。

主要能力:先确定讲解对象,优先级依次为作为参数传入的提交(commit)、PR 或路径;当前会话中产生的工作;git status 与 git diff 显示未提交的改动;以上都无时取最近一次提交。确定对象后会说明选了什么,便于用户纠正。随后阅读完整变更内容,包括 diff、涉及文件、相关代码、提交信息、计划或 PR 描述,并建立一份运行中的理解清单写入 .turbo/understand/<slug>.md,清单按 Problem(问题、原因、备选方案)、Solution(做了什么、为何如此、设计决策、边界情况)、Context(意义与影响范围)三部分组织,每项一个复选框。

使用方式:slug 需为小写、非字母数字字符替换为连字符、连续连字符合并、去除首尾连字符、按词边界截断至 40 字符。若变更对应已有计划 .turbo/plans/<slug>.md,则复用其 slug;若目标文件已存在,则依次追加 -2、-3 等,不覆盖。用户可显式指定 slug 或输出路径;已存在的路径是否作为输出目标仅在明确说明时如此处理,否则视为背景输入。若显式输出路径已存在,会询问是覆盖、追加数字后缀还是另选 slug。

教学流程:逐项讲解,用户先复述已有理解,再补充纠正,追问 why 与更深层原因,兼顾 what 和 how;用户可按需调整深度,也可要求更简单、更详细或像带新同事一样逐步演示。需要时展示相关代码或使用调试器。通过开放式回忆题或 AskUserQuestion 选择题测验,掌握后才勾选该项,出现缺口则回到清单补充。全部项目完成后总结用户已理解的内容。

适用场景:理解提交、PR、未提交改动或会话产出的实现细节,适合需要真正弄懂变更动机与业务逻辑的开发者。

限制:资料未说明具体平台依赖、安装方式、收费与价格;使用前需存在待讲解的变更上下文。