aboutsummaryrefslogtreecommitdiffstats
path: root/.agents/skills/results-report/SKILL.md
diff options
context:
space:
mode:
authorsillylaird <sillyfanboy@gmail.com>2026-09-03 00:33:59 +0000
committersillylaird <sillyfanboy@gmail.com>2026-09-03 00:33:59 +0000
commit898b52edcb47bcb3e9d6106e74ca73e74ea01e70 (patch)
tree85c6ee5ad58b860144551184d4cf86b560c62b91 /.agents/skills/results-report/SKILL.md
downloadwww-main.tar.gz
www-main.zip
import live www.sillylaird.ca webrootHEADmain
Diffstat (limited to '.agents/skills/results-report/SKILL.md')
-rw-r--r--.agents/skills/results-report/SKILL.md180
1 files changed, 180 insertions, 0 deletions
diff --git a/.agents/skills/results-report/SKILL.md b/.agents/skills/results-report/SKILL.md
new file mode 100644
index 0000000..d533539
--- /dev/null
+++ b/.agents/skills/results-report/SKILL.md
@@ -0,0 +1,180 @@
+---
+name: results-report
+description: This skill should be used when the user asks to "write an experiment report", "summarize experimental results", "do experiment retrospection", "write a results report", "写实验总结报告", "写实验复盘", or mentions turning completed experiment artifacts into a structured, decision-oriented research report. It assumes strict analysis should come from `results-analysis` first.
+version: 0.1.0
+tags: [Research, Reporting, Experiments, Obsidian]
+---
+
+# Results Report
+
+Write the **complete post-experiment summary report** after analysis artifacts are ready.
+
+This skill is for the stage **after** `results-analysis`.
+
+## Role boundary
+
+### `results-analysis` does
+- strict statistics,
+- real figures,
+- figure interpretation scaffolding,
+- stats appendix.
+
+### `results-report` does
+- complete experiment wrap-up report,
+- decision-oriented narrative,
+- figure-by-figure interpretation inside a coherent structure,
+- limitations, failure cases, and next actions,
+- Obsidian write-back into `Results/Reports/`.
+
+Do not replace strict analysis with confident prose. If the analysis bundle is missing, first identify the blocker and request or produce the missing bundle.
+
+## Default output
+
+The default report is an **internal research report**, not manuscript prose.
+
+It should be named as:
+
+```text
+YYYY-MM-DD--{experiment-line}--r{round}--{purpose}.md
+```
+
+Example:
+- `2026-03-18--freezing--r03--transfer-summary.md`
+- `2026-03-18--contrastive-adversarial--r02--ablation-report.md`
+
+The note title should be:
+
+```text
+{Experiment Line} / Round {N} / {Purpose} / {YYYY-MM-DD}
+```
+
+Read `references/report-naming.md` before finalizing the filename or note title.
+
+## Required frontmatter
+
+```yaml
+---
+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
+---
+```
+
+## Default report structure
+
+The report must include all sections below.
+
+1. **Executive Summary**
+2. **Experiment Identity and Decision Context**
+3. **Setup and Evaluation Protocol**
+4. **Main Findings**
+5. **Statistical Validation**
+6. **Figure-by-Figure Interpretation**
+7. **Failure Cases / Negative Results / Limitations**
+8. **What Changed Our Belief**
+9. **Next Actions**
+10. **Artifact and Reproducibility Index**
+
+Read `references/report-structure.md` before writing.
+
+## Workflow
+
+### 1. Confirm the report object
+
+Lock these fields first:
+- date,
+- experiment line,
+- round,
+- purpose,
+- linked experiment note,
+- linked durable result note if one already exists.
+
+If round is unknown, do not silently invent a semantic round. Use `r00` only as a temporary placeholder and state that it should be normalized later.
+
+### 2. Read the strict analysis bundle
+
+Minimum required inputs:
+- `analysis-report.md`
+- `stats-appendix.md`
+- `figure-catalog.md`
+- actual figures, if available
+
+If these are missing, either generate them first with `results-analysis` or explicitly state which claims cannot be supported.
+
+### 3. Write the report as a decision object
+
+This report is not a transcript of outputs.
+
+Each section must answer a real question:
+- What did we test?
+- What changed numerically?
+- What is actually supported?
+- What failed or remains uncertain?
+- What should we do next?
+
+Read `references/decision-oriented-analysis.md` for the expected reasoning depth.
+
+### 4. Interpret figures inside the report
+
+Do not only attach figures.
+
+For each main figure:
+- introduce why it is included,
+- state the key observation,
+- explain the supported interpretation,
+- explain the decision implication.
+
+Read `references/figure-interpretation.md` and `references/statistical-completeness.md` as needed.
+
+### 5. Choose the write target explicitly
+
+If the current repo is bound to an Obsidian project knowledge base:
+- create or update `Results/Reports/{report-name}.md`,
+- link back to the relevant `Experiments/` note,
+- update the matching canonical `Results/` note when a durable conclusion is now supported,
+- append a short trace to today's `Daily/` note,
+- update `.claude/project-memory/<project_id>.md`.
+
+If the repo is **not** bound:
+- write the report as a local markdown artifact in the requested output location or next to the analysis bundle,
+- keep the same filename contract,
+- explicitly say that no Obsidian write-back was attempted.
+
+Use `obsidian-project-memory` conventions only for bound repos. Internal experiment reports belong in `Results/Reports/`, not `Writing/`.
+
+### 6. End with explicit next actions
+
+The report must end with operational decisions, for example:
+- stop a weak branch,
+- schedule one missing ablation,
+- promote a stable finding into manuscript-facing writing,
+- update the active plan.
+
+## Required quality bar
+
+- The report must be dateable, searchable, and attributable to one experiment line and one round.
+- The report must cite actual evidence from the analysis bundle.
+- The report must include negative results when they matter.
+- The report must separate stable conclusion from tentative interpretation.
+- The report must say what changed in project belief and what should happen next.
+
+## Reference files
+
+Load only what is needed:
+- `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`