关于 results-report
results-report 是研究报告技能,在 results-analysis 准备好分析材料后生成面向决策的内部实验报告。它整合图表解读、局限与后续行动,并支持绑定项目仓库写回 Obsidian。
主要功能
- 01生成完整实验报告
- 02结合上下文解读图表
- 03记录局限与失败案例
- 04明确后续操作
- 05支持写回 Obsidian
适用场景
- 01总结已完成的实验
- 02评估发现与不确定性
- 03在 Obsidian 记录后续决策
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ galaxy-dawn/ claude-scholar --skill results-report安装后在 Claude Code 中输入/results-report确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
examples/example-results-report.mdreferences/decision-oriented-analysis.mdEVIDENCE-PROPAGATION.mdfigure-interpretation.mdreport-naming.mdreport-structure.mdstatistical-completeness.md详细介绍
结果报告
分析产物就绪后,撰写完整的实验后总结报告。
此技能适用于 results-analysis 之后的阶段。
职责边界
results-analysis 负责
- 严谨统计,
- 实际图表,
- 图表解读框架,
- 统计附录。
results-report 负责
- 完整的实验总结报告,
- 面向决策的叙述,
- 在连贯结构中逐图解读,
- 局限性、失败案例和后续行动,
- 写回 Obsidian 的
Results/Reports/目录。
当任务是创建或重新设计适用于论文的图表/表格时,请使用 publication-chart-skill,不要扩展 results-report 的职责来制作图表/表格。
不要用自信的表述取代严谨分析。如果缺少分析资料包,请先指出阻碍,并请求提供或生成缺失的资料包。
硬性要求:如果缺少 analysis-report.md、stats-appendix.md、figure-catalog.md、溯源信息或主要比较问题,不得撰写完整报告。在这种情况下,只写阻碍摘要,并转回 results-analysis。
默认输出
默认报告是内部研究报告,不是论文正文。
文件名应为:
YYYY-MM-DD--{experiment-line}--r{round}--{purpose}.md
示例:
2026-03-18--freezing--r03--transfer-summary.md2026-03-18--contrastive-adversarial--r02--ablation-report.md
笔记标题应为:
{Experiment Line} / Round {N} / {Purpose} / {YYYY-MM-DD}
确定文件名或笔记标题前,请阅读 references/report-naming.md。
必需的前置元数据
---
type: results-report
date: 2026-03-18
experiment_line: freezing
round: 3
purpose: transfer-summary
status: active
source_artifacts:
- analysis-output/analysis-report.md
- analysis-output/stats-appendix.md
linked_experiments:
- Experiments/Freezing-Study.md
linked_results:
- Results/Freezing-vs-Adapter.md
---
默认报告结构
报告必须包含以下所有章节。
- 执行摘要
- 实验标识与决策背景
- 设置与评估方案
- 主要发现
- 统计验证
- 逐图解读
- 失败案例/负面结果/局限性
- 哪些结果改变了我们的判断
- 后续行动
- 产物与可复现性索引
撰写前,请阅读 references/report-structure.md。
工作流
1. 确认报告对象
先确定以下字段:
- 日期,
- 实验方向,
- 轮次,
- 目的,
- 关联的实验笔记,
- 已存在的关联持久化结果笔记(如有)。
如果轮次未知,不要擅自编造有实际含义的轮次。仅将 r00 用作临时占位符,并说明之后应对其进行规范化。
2. 阅读严谨分析资料包
最低限度的必需输入:
analysis-report.mdstats-appendix.mdfigure-catalog.md- 实际图表(如有)
如果缺少这些内容,请先用 results-analysis 生成,或明确说明哪些主张缺乏依据。
只有在严谨分析资料包已验证分析单位、主要指标和主张措辞后,才能将零散的 CSV/Markdown 产物整理成完整报告。
3. 将报告写成决策材料
这份报告不是输出内容的记录。
每个章节都必须回答一个实际问题:
- 我们测试了什么?
- 数值上发生了什么变化?
- 哪些结论确实有依据?
- 哪些地方失败了,或仍不确定?
- 接下来应该怎么做?
请阅读 references/decision-oriented-analysis.md,了解预期的推理深度。
4. 在报告中解读图表
不要只附上图表。
对于每张主要图表:
- 说明将其纳入报告的原因,
- 陈述关键观察结果,
- 解释有依据的结论,
- 说明其对决策的影响。
请根据需要阅读 references/figure-interpretation.md 和 references/statistical-completeness.md。
5. 明确选择写入目标
如果当前仓库已绑定到 Obsidian 项目知识库:
- 创建或更新
Results/Reports/{report-name}.md, - 链接回相关的
Experiments/笔记, - 如果现在有证据支持持久性结论,则更新匹配的规范
Results/笔记, - 在今天的
Daily/笔记中追加简短记录, - 更新
.claude/project-memory/<project_id>.md。
如果仓库未绑定:
- 将报告写为本地 Markdown 文件,放在指定的输出位置或分析资料包旁边,
- 使用相同的文件名约定,
- 明确说明未尝试写回 Obsidian。
仅对已绑定的仓库使用 obsidian-project-kb-core 约定。内部实验报告应放在 Results/Reports/,而不是 Writing/。
6. 以明确的后续行动收尾
报告必须以可执行的决策收尾,例如:
- 停止一个效果较弱的分支,
- 安排一项尚缺的消融实验,
- 将稳定发现纳入面向论文的写作,
- 更新当前计划。
必要的质量标准
- 报告必须注明日期、便于搜索,并能归属到一条实验线和一轮实验。
- 报告必须引用分析资料包中的实际证据。
- 适当时,报告必须包含负面结果。
- 报告必须区分稳定结论和暂定解读。
- 报告必须说明项目认知发生了哪些变化,以及接下来应采取什么行动。
- 报告必须保留 Claim Candidate 的措辞,不得将
speculative或observed声明提升为决定性结论。
参考文件
仅加载所需文件:
references/report-structure.mdreferences/report-naming.mdreferences/figure-interpretation.mdreferences/statistical-completeness.mdreferences/decision-oriented-analysis.mdreferences/EVIDENCE-PROPAGATION.mdexamples/example-results-report.md