写作与公文
实验分析完成后:把分析产物写成可追溯…
当 `results-analysis` 已产出严格分析包,且需要把某条实验线某一轮的统计结果、图表、失败案例与后续行动汇成内部报告时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
实验分析完成后:把分析产物写成可追溯、面特定
解决思路
- 仅在本技能对应阶段使用:在 `results-analysis` 之后,等分析产物就绪后,撰写完整的 post-experiment summary report。
- 明确角色边界:`results-analysis` 负责严格统计、真实图表、图表解读脚手架、统计附录;`results-report` 不重复这些工作。
- 用 `results-report` 负责完整实验收尾报告、面向决策的叙事、在连贯结构内逐图解读、限制/失败案例/后续行动,以及写入 Obsidian `Results/Reports/`。
- 当任务是创建或重新设计论文级图表/表格本身时,改用 `publication-chart-skill`,不要扩展 `results-report` 来做图表/表格生产。
- 不要用自信的散文替代严格分析;如果分析包缺失,先识别 blocker,再请求或生成缺失的分析包。
- 遵守硬性门禁:当 `analysis-report.md`、`stats-appendix.md`、`figure-catalog.md`、provenance 或 primary comparison question 缺失时,不要写完整报告;只写 blocker summary 并转回 `results-analysis`。
- 默认输出内部研究报告,而不是论文手稿式 prose。
- 按命名约定命名报告文件:`YYYY-MM-DD--{experiment-line}--r{round}--{purpose}.md`。
- 例如使用 `2026-03-18--freezing--r03--transfer-summary.md` 或 `2026-03-18--contrastive-adversarial--r02--ablation-report.md` 这类文件名。
- 笔记标题使用:`{Experiment Line} / Round {N} / {Purpose} / {YYYY-MM-DD}`。
- 最终确定文件名或笔记标题前,先阅读 `references/report-naming.md`。
- 添加必需的 YAML frontmatter,字段包括 `type: results-report`、`date`、`experiment_line`、`round`、`purpose`、`status`、`source_artifacts`、`linked_experiments`、`linked_results`。
- 在 `source_artifacts` 中列出分析产物,例如 `analysis-output/analysis-report.md`、`analysis-output/stats-appendix.md`。
- 在 `linked_experiments` 和 `linked_results` 中关联实验笔记与结果笔记,例如 `Experiments/Freezing-Study.md`、`Results/Freezing-vs-Adapter.md`。
- 报告必须包含全部默认章节:执行摘要(Executive Summary)、实验身份与决策背景(Experiment Identity and Decision Context)、设置与评估协议(Setup and Evaluation Protocol)、主要发现(Main Findings)、统计验证(Statistical Validation)、逐图解读(Figure-by-Figure Interpretation)、失败案例/负面结果/局限性(Failure Cases / Negative Results / Limitations)、信念变化(What Changed Our Belief)、后续行动(Next Actions)、产物与可复现性索引(Artifact and Reproducibility Index)。
- 写报告前阅读 `references/report-structure.md`。
- Workflow 1:确认报告对象,先锁定字段:date、experiment line、round、purpose、linked experiment note、以及已存在的 linked durable result note。
- 如果 round 未知,不要静默发明一个语义 round;只用 `r00` 作为临时占位符,并说明之后需要规范化。
- Workflow 2:读取严格分析包;最低必需输入为 `analysis-report.md`、`stats-appendix.md`、`figure-catalog.md`,以及可用时的实际图表。
- 如果这些输入缺失,先用 `results-analysis` 生成,或明确说明哪些 claims 无法被支持。
- 不要把松散的 CSV/Markdown artifacts 直接变成 polished report,除非严格分析包已验证 unit of analysis、primary metric 和 claim wording。
- Workflow 3:把报告写成决策对象,而不是输出记录。
- 报告每个章节都必须回答真实问题:我们测试了什么?数值上改变了什么?实际支持了什么?什么失败或仍不确定?下一步该做什么?
- 按需阅读 `references/decision-oriented-analysis.md` 以获得期望的推理深度。
- Workflow 4:在报告内解读图表,不要只附上图表。
- 对每个主图:介绍为什么包含它、陈述关键观察、解释受支持的解读、解释决策含义。
- 按需阅读 `references/figure-interpretation.md` 和 `references/statistical-completeness.md`。
- Workflow 5:明确选择写入目标。
- 如果当前 repo 绑定到 Obsidian project knowledge base:创建或更新 `Results/Reports/{report-name}.md`。
- 如果绑定:链接回相关 `Experiments/` 笔记。
- 如果绑定:当现在有持久结论支持时,更新匹配的 canonical `Results/` 笔记。
- 如果绑定:向今天的 `Daily/` 笔记追加一条简短 trace。
- 如果绑定:更新 `.claude/project-memory/<project_id>.md`。
- 如果 repo 未绑定:把报告写成请求输出位置或分析包旁边的本地 markdown artifact。
- 如果 repo 未绑定:保持相同 filename contract。
- 如果 repo 未绑定:明确说明未尝试 Obsidian write-back。
- 只对绑定的 repo 使用 `obsidian-project-kb-core` 约定。
- 内部实验报告属于 `Results/Reports/`,不放 `Writing/`。
- Workflow 6:报告必须以明确的后续行动结束,例如停止弱分支、安排一个缺失的 ablation、把稳定发现提升到面向手稿的写作、更新 active plan。
- 达到必需质量门槛:报告必须可标日期、可搜索,并可归因到一条 experiment line 和一个 round。
- 报告必须引用来自分析包的实际证据。
- 当负面结果重要时,报告必须包含它们。
- 报告必须区分稳定结论与暂定解读。
- 报告必须说明项目信念中改变了什么,以及接下来应该发生什么。
- 报告必须保留 Claim Candidate wording,且不得把 `speculative` 或 `observed` claims 提升为决定性结论。
- 只加载需要的 reference 文件:`references/report-structure.md`、`references/report-naming.md`、`references/figure-interpretation.md`、`references/statistical-completeness.md`、`references/decision-oriented-analysis.md`、`references/EVIDENCE-PROPAGATION.md`、`examples/example-results-report.md`。
适用边界 · 注意事项
- 当 `analysis-report.md`、`stats-appendix.md`、`figure-catalog.md`、provenance 或 primary comparison question 缺失时,不适用;只能写 blocker summary 并回到 `results-analysis`。
- 当任务本身是创建或重新设计论文级图表/表格时,不适用;应使用 `publication-chart-skill`。
- 当分析包未验证 unit of analysis、primary metric 和 claim wording,或只有松散 CSV/Markdown artifacts 时,不适用;不要写 polished report。