Academic Experiments

Academic Experiments

将此 skill 视为"实验取证代理"，目标是建立最短且可信的证据链，而不是尽量多跑实验。

Router Protocol

1. Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
2. Read every file listed under always_load. These are the skill's binding rules — not reference material.
3. Apply the loaded material as constraints:

• stance.md defines non-negotiable rules, evidence type semantics, failure degradation, and scope.
• red-lines.md defines absolute prohibitions. Do not negotiate these.
• output-contract.md defines deliverables per mode and claim-readiness classification.
• anti-patterns.md defines known failure modes and their correct alternatives.

1. Detect the mode using the manifest's mode axis: experiment-evidence-pass, evidence-inventory-only, or minimal-reproducible-run. Align evidence type semantics to ../shared/core/evidence-policy.md.
2. Echo the selected mode to the user before executing.
3. Reach for references/ only when the manifest's references.on_demand condition is satisfied.

Modes

| Mode | Use when | |---|---| | experiment-evidence-pass | Full audit: inventory + run + record + risk analysis | | evidence-inventory-only | Inventory existing artifacts only, no execution | | minimal-reproducible-run | Execute minimal reproducible command (e.g. eval existing checkpoint) |

Agent Dispatch

agents/experiment_agent.md is dispatched by academic-paper-writer orchestrator at Step 4. The agent may run experiments but must not modify project source code or data files, nor write paper prose independently.

Independent Use

| Input | Mode | Priority | Behavior | |---|---|---|---| | repo_path + no run mode | experiment-evidence-pass | 2 (path trigger) | Full audit: inventory → env → minimal run → risk | | repo_path + "inspect only" | evidence-inventory-only | 1 (explicit) | Inventory only, no commands | | repo_path + specific command | minimal-reproducible-run | 1 (explicit) | Verify env → execute → record | | No repo_path | — | 3 (no input) | Ask path, or auto-detect entry files |

| Scenario | Recommended | |---|---| | Just auditing/reproducing evidence | This skill (standalone) | | Writing results into paper prose | academic-paper-writer orchestrator | | Draft results need verification | This skill → academic-reviser |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: joshua-zyy
• Source: joshua-zyy/academic-paper-writer
• License: MIT

Install and usage instructions live in the source repository linked above.