$npx -y skills add WILLOSCAR/research-units-pipeline-skills --skill argument-selfloopBuild a final, machine-readable argument snapshot from current H3 sections and refresh section fingerprints before merge. Trigger: argument snapshot, section ledger, consistency contract, final section manifest, 论证快照, 一致性契约. Use when: section-level mutations are complete
| 1 | # Argument Snapshot |
| 2 | |
| 3 | Create the final C5 snapshot consumed by merge and later audit. |
| 4 | |
| 5 | Despite the historical Skill name, the current implementation is not an |
| 6 | autonomous rewrite loop. It reads the final H3 files, assigns bounded structural |
| 7 | move labels, writes a compact consistency contract, refreshes section hashes, |
| 8 | and fails when required prose is absent or too thin. |
| 9 | |
| 10 | ## Position In The Workflow |
| 11 | |
| 12 | ```text |
| 13 | section writing |
| 14 | -> style and numeric hygiene |
| 15 | -> logic polish |
| 16 | -> paragraph compaction |
| 17 | -> argument snapshot |
| 18 | -> optional transitions |
| 19 | -> merge |
| 20 | ``` |
| 21 | |
| 22 | Running the snapshot after every section mutator prevents the ledger and |
| 23 | manifest from describing an earlier draft. |
| 24 | |
| 25 | ## Inputs |
| 26 | |
| 27 | - `sections/` |
| 28 | - `outline/outline.yml` |
| 29 | - `queries.md` |
| 30 | - `output/PARAGRAPH_CURATION_REPORT.md` |
| 31 | |
| 32 | ## Outputs |
| 33 | |
| 34 | - `output/ARGUMENT_SELFLOOP_TODO.md` |
| 35 | - `output/SECTION_ARGUMENT_SUMMARIES.jsonl` |
| 36 | - `output/ARGUMENT_SKELETON.md` |
| 37 | - refreshed `sections/sections_manifest.jsonl` |
| 38 | |
| 39 | `SECTION_ARGUMENT_SUMMARIES.jsonl` contains one record per expected H3 and one |
| 40 | record per paragraph. Current move labels are deterministic signals drawn from: |
| 41 | |
| 42 | ```text |
| 43 | setup, thesis, contrast, evidence, evaluation, limitation, synthesis, takeaway |
| 44 | ``` |
| 45 | |
| 46 | They make section shape inspectable; they do not prove that an argument is |
| 47 | scientifically valid. `ARGUMENT_SKELETON.md` contains a |
| 48 | `## Consistency Contract` and a chapter-level map. It is a writer-facing audit |
| 49 | artifact, never reader-facing paper content. |
| 50 | |
| 51 | ## PASS Contract |
| 52 | |
| 53 | - every expected H3 exists; |
| 54 | - every H3 meets the profile paragraph floor; |
| 55 | - each paragraph has at least one allowed move; |
| 56 | - `ARGUMENT_SKELETON.md` contains `## Consistency Contract`; |
| 57 | - `sections_manifest.jsonl` carries current `bytes` and `sha256` values. |
| 58 | |
| 59 | On FAIL, inspect `ARGUMENT_SELFLOOP_TODO.md` and route the named section back to |
| 60 | its writer or evidence owner. This Skill does not apply the repair itself. |
| 61 | |
| 62 | ## Run |
| 63 | |
| 64 | ```bash |
| 65 | uv run python .codex/skills/argument-selfloop/scripts/run.py \ |
| 66 | --workspace workspaces/<name> |
| 67 | ``` |
| 68 | |
| 69 | Optional runner fields are `--unit-id`, `--inputs`, `--outputs`, and |
| 70 | `--checkpoint`. |