Experiment Report Writer 是一个用于将实验证据转化为结构化研究报告的技能，目标是让读者无需重新运行实验即可评估结果。
用途
该技能用于撰写独立文档、论文或实验笔记中的章节、面向导师的进度更新，以及可直接用于演示的实验摘要。它强调以配置、命令、日志、指标、表格、图表、提交哈希或用户提供的笔记为依据，区分观察结果与解释，并保持足够的可复现性，使其他研究者能够识别实际运行的内容。
主要能力
- 支持多种报告模式：single-experiment（单次运行或受控对比）、ablation-report（测试单一因素的多个变体）、batch-summary（来自扫描或批次的多个相关运行）、mentor-update（面向决策的简明进度报告）、paper-section（拟纳入论文的润色文本）。
- 默认使用 Markdown，也可输出 LaTeX、幻灯片大纲或聊天草稿。
- 若用户要求保存文件且未指定路径，默认保存至 docs/reports/experiment_report_YYYY-MM-DD.md。
- 使用 templates/experiment-report.md 作为默认 Markdown 骨架；若仅在聊天中起草，则沿用相同章节顺序。
- 提供固定的报告结构：Summary、1. Experiment Motivation、2. Experiment Setup、3. Core Algorithm or Method、4. Metrics、5. Results、6. How to Read the Figures、7. Interpretation、8. Conclusion and Discussion、9. Limitations and Caveats、10. Next Steps、Reproducibility Notes。无核心算法时写“Not applicable”；无图时可省略图表阅读说明或替换为表格阅读说明。
- 引导收集主证据：实验命令或脚本、配置文件与参数覆盖、随机种子与运行次数、数据集名称/划分/预处理/样本数、模型/方法变体/检查点/算法版本、硬件与运行时间（如相关）、指标/日志/结果表/图表/失败案例、git commit 哈希或代码版本。
- 提供本地检查命令，例如： git rev-parse --short HEAD find . -maxdepth 3 -type f ( -name ".yaml" -o -name ".yml" -o -name ".json" -o -name ".csv" -o -name ".md" ) find . -maxdepth 4 -type f ( -name ".png" -o -name ".jpg" -o -name ".pdf" -o -name "*.svg" )
- 要求每个指标说明定义、方向（越高越好/越低越好/目标区间）、单位、聚合方式（均值/中位数/最佳检查点/最终轮/置信区间/标准差）及其与实验问题的相关性，并标明可能相互冲突的指标。
- 要求每个图表说明其意图、x 轴（变量/单位/尺度）、y 轴（指标/单位/方向）、图例、误差棒或阴影区域、数据点代表个体运行/均值/检查点/轮次/样本，以及读者应注意到的主要视觉模式。对数缩放、归一化、裁剪或无单位轴需明确说明。
- 强调解释时连接动机、是否支持假设、与基线的变化、可能解释、替代解释、意外或负面结果，以及证据是否足以行动；在单一种子、统计证据弱或缺少对照时使用谨慎措辞。
使用方式
用户提供笔记、配置、日志、指标、表格、图表等材料，并指定报告模式、受众、输出格式、保存路径、篇幅和可用证据。技能按步骤分类报告、收集证据、提取实验故事，再按固定结构起草报告。若使用 research-project-memory，报告完成后可写回项目记忆，包括 memory/evidence-board.md、memory/provenance-board.md、memory/claim-board.md、memory/risk-board.md、memory/action-board.md、memory/handoff-board.md、memory/phase-dashboard.md、worktree .agent/worktree-status.md "Local Hot Results"、<ProjectRoot>/memory/hot-results.md、memory/current-status.md。其中 worktree 状态文件默认先记录进行中和中间结果；hot-results.md 仅在结果确认、进入项目前 5–7 且直接改变项目级主张时写入，进行中或 worktree 本地工作不写此处。不得将解释写成测量事实，日志/表格中的指标用 observed，解释用 inferred。
适用场景
适用于结果分析、研究更新、演示准备、论文段落撰写、消融实验报告、批量实验汇总、导师进度汇报，以及需要从实验证据生成可评估报告的研究工作流。
限制
若证据缺失，应标记为缺失并请求最小有用澄清，不得编造。若用户仅提供非正式笔记，可使用但需明确标注缺失的可复现细节。该技能主要面向实验报告写作，不替代实验执行或数据分析工具本身。