用途:读取一个函数或代码块,输出确定性的、编号的分步解释,说明其业务层面的流程,并用子步骤说明每一步内部如何运作。核心保证是:对同一份未改动的代码,每次运行都必须产生相同的步骤、相同的顺序、覆盖相同的内容。
主要能力:输出分两层。顶层步骤说明函数做什么,按业务关注点或领域实体分组,每个关注点一步;子步骤(N.1、N.2……)说明该步骤内部如何运作,列出其中不同的操作。这样读者既能获得整体图景,也能了解机制,而不会陷入代码级细节。
使用方式:按给定算法执行。先确定函数边界,读取完整函数体;若用户提供文件路径加函数名则先定位,若直接粘贴代码则使用该代码。然后识别实体与领域概念,通过仓储或服务调用、赋值中的类型名、表示领域对象的命名变量来识别。接着自上而下遍历函数体,把服务于同一业务关注点的连续语句归为一个顶层步骤,当代码切换到不同实体或关注点时开始新步骤。再为每个顶层步骤拆分子步骤,包含两个及以上不同操作的步骤必须有子步骤,只有一个操作的步骤不需要。最后用业务语言书写,使用代码中的实体或领域名,不引用原始代码标识符,每步一句话,只解释做什么和怎么做,不解释为什么。输出格式为“Steps for <function_name>:”,随后是编号步骤与子步骤;若未提供函数名,则用“Steps for the provided code:”。
适用场景:需要稳定、可复现的代码流程说明时,例如审查业务逻辑、编写文档、向非代码读者解释函数行为。
限制:默认输出语言为英语;若用户用泰语提问或要求泰语,则步骤用泰语输出,但实体名保持原形。空函数输出无步骤;单行函数输出单个步骤且无子步骤;嵌套函数或闭包只解释外层函数流程;类方法按函数同样处理。资料未提供安装命令、收费、价格或平台信息。