用途:对单个已持久化的 skore 报告做只读审计,产出人类可读的叙述文件 audit/NN_<stem>.py(jupytext percent 格式),与 experiments/ 和 journal/ 一一对应。该文件是人工查看的 notebook,不被执行;materialize.py 在一次运行中写出摘要与 HTML 查看器。
主要能力:审计文件允许 skore.Project(...)、project.summarize()、project.get(id) 及所有 report.* 访问器,以及只读导入;禁止 skore.evaluate(...)、project.put(...)、快照写入、help() 循环、对 data/、reports/、src/<pkg>/ 的写入,以及对已加载报告的持久化变更。
使用方式:先运行 python -m skore_skills status 检查 setup;需满足四路配对(journal、experiments、smoke 测试通过、Project 中存在对应 key 的报告)。执行命令形如 python scratch/audit/<stem>/materialize.py;notebooks true 时用 notebook fill audit/<stem>.py [--html]。project.get 按 id 而非 key 查找;hub 模式从 put() 打印的 URL 读取 id,本地模式从 summarize() 的 id 列读取。符号须来自 python -m skore_skills api get,不得凭记忆。
适用场景:在 evaluate 之后、record-outcome 之前由 implement 循环派发;也支持用户直接说“audit 02”“re-audit 04”。
限制:审计文件只读,不写快照;执行产物写入 scratch/audit/<stem>/(gitignored),不提交;每个实验 stem 仅一个审计文件,重跑时原地覆盖;不得过滤警告;缺少 ipython/ipykernel 时须委托 add-python-package 安装,不得自行安装或伪造输出。