SuperAPI AI 工具集

organize-file

编程与开发

查看项目

更新于 10-16 06:19

技能介绍

用途:当需要重新整理整个文件(该模块或测试中的所有定义)时使用本技能。若只想重排当前分支改动过的定义,应改用 surge/skills/doctor/organize-changes/SKILL.md。

主要能力与规则:这些排序规则优先于文件中的本地习惯与一次性布局(例如把辅助函数聚在一起、把私有函数放在调用点附近),当布局与规则冲突时不要保留原布局。通用规则包括:同一函数名与元数的所有子句视为一个单元,单元内按区分性原子或参数字母序排列;若重排会改变模式匹配结果(具体性或兜底顺序),则不要重排;保持回调子句组连续(如所有 handle_params/3 子句在一起);移动的函数体除位置外保持不变;保留模块结构、注释、空行与非函数代码;私有函数 defp 始终放在最后,按函数名字母序。

特定规则:LiveView 模块默认回调顺序为 mount/3、handle_params/3、handle_event/3、handle_info/2、handle_async/3,然后其他处理器,最后 render/1;handle_event/3 子句按事件名字母序。LiveComponent 模块默认顺序为 mount/1、update/2、handle_event/3、handle_info/2、handle_async/3,然后其他处理器,最后 render/1,并保持回调组连续。其他模块遵循通用规则:公有函数 def 在前按字母序,私有函数 defp 在后;若有 defdelegate,则与公有函数混合排序。测试模块在每个 describe 块内应用排序,嵌套 describe 时镜像该顺序;同一行为先写正常路径,紧接着写相关错误与边界测试,不要与其他功能交错。

输出预期:即使跨越文件大段区域,也要把函数移到正确位置;遵守子句与模式顺序;在 LiveView 与 LiveComponent 模块中,回调生命周期顺序优先于回调之间的字母序。

限制:资料未提供安装命令、平台支持、收费方式或具体使用步骤,暂未提供。