用途:当 PL/SQL 变更(CREATE OR REPLACE、修复、从 journal 恢复等任何写入)准备落库时使用本技能,通过六步流程保证每次写入都先被开发者看到并批准。核心原则:未经开发者查看和批准不得写入,任何写入都适用,包括看似微小的一行改动。
主要能力与流程:先运行 pythia apply <file> 进行预览,它不写入任何内容,而是做快照、计算影响、打印 diff、警告块和确认令牌;将预览原样转达开发者,等待明确同意;随后执行 pythia 打印的 To apply: 命令(含令牌)。退出码即结论:0 表示已应用且编译干净、无新 INVALID,报告完成并说明 restore id;1 表示被拒绝(策略、分类、令牌过期),转达原因及修复方式,不得绕过;3 表示已写入但损坏,须如实说明并展示编译错误与新增 INVALID 对象,提供 To undo: 命令。恢复用 pythia journal restore <id>,它同样是一次写入,走同样六步与审批。
批量模式:--yes 只跳过暂停,不跳过预览;仅在开发者明确要求无人值守应用时使用,遇到第一个 exit 3 立即停止,并列出未应用的文件。限制:当 pythia apply 可用时不要通过 SQLcl MCP run-sql、sqlplus 或驱动脚本写入;回滚并非总是可行(data_dml 提交后仅剩 Flashback Query,structural 几乎不可回滚),不要泛泛承诺可回滚。读取或探索用 plsql-explore,评估影响用 plsql-impact。示例中的 pythia 按项目提供方式运行(如 python scripts/pythia.py ...)。