用途:semantius-optimizer 是 semantius-* 技能家族中唯一反向运行的成员,把线上 Semantius 模块(在 UI 中直接搭建或已偏离原规格的模块)还原为 *-semantic-spec.md 规格文件。产出的规格与 semantius-analyst 写出的文件可互换,可交给 semantius-analyst 的 Extend/Audit 模式或 semantius-modeler 重新部署。
主要能力:读取模块、实体(按创建顺序)、字段(按 field-order,剔除自动字段)、权限、角色与权限层级,发现被引用的内置项,并写出规格。输出为确定性结果,映射规则集中在 references/spec-extract-lib.ts 中,脚本对平台只读、幂等、无副作用。
使用方式:先加载 use-semantius 与 semantius-analyst 的模板等上下文;若未指定模块,可用 semantius call crud read_module '{"order": "module_name.asc"}' 列出候选;写入前先检查输出文件是否存在,存在则必须询问用户是替换、改名还是停止;随后运行 bun run references/spec-extract-lib.ts <module_slug> <chosen_outfile>,仅在用户选择替换时加 --force。完成后给出简短报告:文件路径、可信范围、需手工补写的内容。
适用场景:线上已有模块但缺少规格,或规格与线上状态不一致时,用于生成可被流水线治理的规格。
限制:对 Semantius 只读,不写入平台,任何修改只作用于 .md,需经 semantius-modeler 重新部署才能生效。线上未持久化的内容无法还原,如概述、字段描述、部分标签标题、§6/§7 交接、§8.2 业务规则、§9.2 功能归属及 RACI 相关内容,需手工补写。审计仅在用户明确要求时执行。文件版本为 5.9,需与 analyst 模板保持同步。