mcpField
R
results-report

results-report

github.com/galaxy-dawn文档处理5.9k493 次安装1 周前更新
代码仓库

关于 results-report

results-report 是研究报告技能,在 results-analysis 准备好分析材料后生成面向决策的内部实验报告。它整合图表解读、局限与后续行动,并支持绑定项目仓库写回 Obsidian。

主要功能

  1. 01生成完整实验报告
  2. 02结合上下文解读图表
  3. 03记录局限与失败案例
  4. 04明确后续操作
  5. 05支持写回 Obsidian

适用场景

  1. 01总结已完成的实验
  2. 02评估发现与不确定性
  3. 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.md
references/
decision-oriented-analysis.md
EVIDENCE-PROPAGATION.md
figure-interpretation.md
report-naming.md
report-structure.md
statistical-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.md
  • 2026-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
---

默认报告结构

报告必须包含以下所有章节。

  1. 执行摘要
  2. 实验标识与决策背景
  3. 设置与评估方案
  4. 主要发现
  5. 统计验证
  6. 逐图解读
  7. 失败案例/负面结果/局限性
  8. 哪些结果改变了我们的判断
  9. 后续行动
  10. 产物与可复现性索引

撰写前,请阅读 references/report-structure.md。

工作流

1. 确认报告对象

先确定以下字段:

  • 日期,
  • 实验方向,
  • 轮次,
  • 目的,
  • 关联的实验笔记,
  • 已存在的关联持久化结果笔记(如有)。

如果轮次未知,不要擅自编造有实际含义的轮次。仅将 r00 用作临时占位符,并说明之后应对其进行规范化。

2. 阅读严谨分析资料包

最低限度的必需输入:

  • analysis-report.md
  • stats-appendix.md
  • figure-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.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

评论

支持 Markdown