| name | analysis-artifact |
| description | 为 Julia_RelaxTime 的正式数值产物、诊断产物或研究结果生成可追溯分析包。适用于 docs/analysis 分析产物沉淀、输入证据审计、派生表和关键图生成、机制/归因边界判定、claim ledger、论文写作前的 evidence package；可覆盖 transport、relaxtime、phase structure、meson 或其他仓库内数值产物。 |
analysis-artifact
Purpose
把“看结果后写解释”的过程收束为可审计分析产物：输入证据、派生表、关键图、机制边界、claim ledger 和论文写作素材都能追溯到仓库文件。
本 skill 负责分析正式或诊断产物，不负责重跑 production、不晋升数值产物、不发明外部文献解释。
Hard Rules
- 只使用仓库内证据，除非用户明确要求新增文献检索或外部对比。
- 不修改正式 result/figure 产物；分析输出默认写入
docs/analysis/...。
- 先验证输入，再写结论：CSV 行数、关键字段、manifest/hash、failed points、convergence gate 和 figure manifest 必须先检查。
- 区分四层表述：
- observation：结果表/图直接支持的趋势和局部结构。
- attribution：可分解诊断表支持的贡献来源。
- mechanism：传播子分母、阈值、上游解分支、算法误差等因果解释；必须有定点机制诊断或等价证据。
- paper claim：可写入论文的表述；必须绑定 evidence file、字段、点位或图。
- 证据不足时标为
author_check、inconclusive 或 candidate，不要用流畅文字掩盖证据缺口。
- 不把具体 case 的数值结论写进 skill；case 信息放在分析脚本参数、README 和派生表中。
Standard Workflow
-
Scope lock
- 明确 artifact case、物理/数值口径、观测量、输出目录和不做事项。
- 默认生成中文分析主文档；英文 caption 或论文正文另起任务。
-
Evidence inventory
- 读取 result-side
README.md、PRODUCTION_AUDIT.md、manifest.json、effective_config.json 或等价审计文件。
- 读取主结果 CSV、诊断 CSV、failed/error points。
- 读取 convergence gate 摘要和 CSV。
- 读取 figure-side
plot_manifest.json 和关键 PNG；必要时抽查图像。
-
Input validation
- 检查所有输入存在、row count 符合 audit、关键字段存在。
- 检查 NaN/Inf、失败点、负贡献、重复 key。
- 记录输入 hash、生成命令、repo HEAD 和脚本 hash。
-
Derived evidence
- 生成全局趋势摘要：端点差、极值、turning count、单调性分类。
- 生成收敛风险摘要：高相对差异点、阈值分档和 gate 边界。
- 生成 attribution 摘要：按 case 合适的维度汇总主导贡献与局部变化。
- 若要写 mechanism，生成机制候选窗口和定点诊断表；没有机制表时不要升级解释。
- 生成 claim ledger：每条论文候选陈述绑定证据文件、字段、点位或图号。
-
Figures
- 生成全局 overview 图、局部结构放大图和 attribution/mechanism 图。
- 写
figures/plot_manifest.json，记录输入 hash、图 hash、生成命令和脚本信息。
-
Analysis document
- 写中文主文档，至少包含：数据与口径、全局观察、收敛风险、局部结构、机制判定、论文写作候选、作者确认项。
- 对机制解释使用逐窗口 verdict：
supported、supported_indirect、not_dominant、inconclusive。
- 对旧产物只写 supersession 和不足边界，不把旧图作为当前 production-grade 证据。
-
Validation
- 运行生成脚本 smoke，确认派生表无 NaN/Inf、key 唯一、claim 引用文件和字段存在、图文件非空。
- 运行仓库治理检查：
git diff --check、julia --project=. scripts/dev/check_docs_consistency.jl；新增脚本时加跑 script governance checks。
- 汇报哪些结论可直接用于论文，哪些仍需作者确认或补充诊断。
Output Contract
分析包目录建议为：
docs/analysis/<domain>/<case>_analysis/
├── README.md
├── manifest.json
├── figures/
│ ├── *_overview*.png
│ ├── *_local*.png
│ ├── *_attribution*.png
│ └── plot_manifest.json
└── tables/
├── global_trend_summary.csv
├── convergence_risk_summary.csv
├── attribution_summary.csv
├── mechanism_*summary.csv
└── claim_ledger.csv
若已有 case 专用生成脚本，优先复用脚本并更新参数；否则在 scripts/analysis/ 的合适子目录新增只读分析脚本。
