SuperAPI AI 工具集

re0-order

办公与效率

查看项目

更新于 11-09 16:50

技能介绍

用途

re0-order 用于整理那些因随手追加而变得杂乱无章的清单:一个列表、一张表格、一份目录、一组章节或一个枚举。它的目标是在只改变条目位置的前提下,让相关条目沿一条读者能说清的主轴排列在一起,使清单重新具有可读的逻辑含义。

主要能力

  • 锁定目标:确定需要排序的条目集合,以及人类指定或管道传入的范围。
  • 选择唯一原则:从工作流或生命周期顺序、依赖关系、按种类分组、严重程度、频率、字母顺序等中选定一个最能赋予顺序意义的原则;若已存在潜在顺序,则显现并补全它,而不是强加新顺序。
  • 依赖优先:在按原则排序前,把被依赖的条目放在依赖它的条目之前,并保持人类明确陈述的优先级;依赖只作为约束,不作为第二排序原则。产生知识类成果(研究、调查、测量)的条目即使未被点名,也要排在会被其影响的计划或构建之前。
  • 计数辅助:当原则涉及可测量的计数(如使用频率、搜索频率)时,仅将计数作为起始参考,不作为排序键本身;先放置通向其他条目的入口项,保持同类相邻,让阅读或工作顺序决定其余部分,计数只用于填补该顺序留下的空白,并说明偏离计数的每一处原因。
  • 镜像同步:在仓库中按条目标识符或独特短语搜索两三个条目,并查找自称副本(如翻译文件)的文件,凡是包含同一集合的文件都视为镜像,应用完全相同的顺序。
  • 安全编辑:移动前断言每个条目存在,缺失则报告 MISS 而非静默丢弃;支持 Unicode 安全编辑;大型结构性移动通过脚本完成。

使用方式

先由人类指定要整理的清单及其范围,然后按上述工作流执行排序,并在完成后进行验证:保存移动前的清单,运行 node scripts/same-set.mjs <before-file> <after-file> [--json] 检查前后条目集合是否一致(退出码 0 表示多重集相同,1 列出新增、删除或改动的条目,2 为用法错误);对每个镜像副本另用 --mirror <file> 运行同一脚本,退出码 1 时指出第一处分歧。

适用场景

适合需要把已经存在但顺序混乱的清单整理成可命名顺序的场合,例如文档章节、配置枚举、目录表格、多语言副本需要保持一致顺序的项目。

限制

  • 只调整顺序,绝不改写、新增、删除、拆分或合并条目。
  • 必须使用一个读者可命名的原则,不在同一清单中混合不兼容的排序方式。
  • 只作用于人类指定或管道传入的范围,不自行选择清单。
  • 当前顺序是否刻意不明确时,须交由人类决定,决定前不移动任何条目。