trace-feature 是一个面向代码理解与功能定位的技能,核心用途是把用户用自然语言点名的某个功能,沿程序中真实的调用路径追踪出来,形成一条从触发入口到执行主体的清晰链路。
用途:用户给出功能名称,例如“导出 PDF”“登录屏幕”“保存按钮”,该技能负责找出这个功能在代码中的完整路径。它适合在阅读陌生代码库、排查某功能由哪段代码实现、梳理调用链、撰写交接文档或做代码讲解时使用。
主要能力:第一,通过 list_strings 在字符串中定位功能相关的文本,包括按钮标签、菜单标题、错误或成功消息以及代码打印的格式字符串,以此作为入口线索。第二,从这些字符串出发跟随交叉引用(xrefs)找到对应代码,并通过 resolve_containing_procedure 确定所在函数名。第三,使用 procedure_callees 向前遍历调用关系,逐个阅读函数的伪代码,直到抵达真正执行工作的代码,而非仅做界面搭建的部分。第四,在需要弄清某个函数由什么触发时,用 procedure_callers 反向回溯。第五,在追踪过程中可用 rename_function 为每一步重命名,用 add_note 记录其作用,并用 open_function 打开正在讲解的函数,使用户能够跟随分析过程。
使用方式:以自然语言指定要追踪的功能名称,技能便按“字符串定位 → 交叉引用 → 确认所在函数 → 向前/向后遍历 → 边追踪边标注与打开函数”的流程进行,最后以简短链条报告路径:触发 → … → 实际工作,说明每个函数的名称和职责,并给出功能实际发生的位置以及值得进一步查看的地方。
适用场景:代码阅读与理解、功能实现位置定位、调用链梳理、代码走查与讲解、项目交接说明等需要弄清“某个功能从哪来到哪去”的任务。
限制:该技能依赖字符串、交叉引用、包含过程解析及调用关系等代码分析信息;资料未说明其支持哪些编程语言或代码库类型、安装与接入方式、性能边界、收费情况以及与其他工具的集成细节,这些内容暂未提供。