用途
argument-selfloop 用于研究写作流水线中生成最终的论证快照。当章节级修改已经完成、合并需要一份最新的论证台账与内容哈希时使用。它创建供合并及后续审计消费的最终 C5 快照。
尽管该技能名称带有历史含义，当前实现并不是一个自主重写循环。它读取最终的 H3 文件，分配有界的结构性动作标签，写出紧凑的一致性契约，刷新章节哈希，并在必需正文缺失或过于单薄时失败。
在工作流中的位置
section writing -> style and numeric hygiene -> logic polish -> paragraph compaction -> argument snapshot -> optional transitions -> merge
在每个章节修改器之后运行快照，可防止台账和清单描述的是较早的草稿。
输入
- sections/
- outline/outline.yml
- queries.md
- output/PARAGRAPH_CURATION_REPORT.md
输出
- output/ARGUMENT_SELFLOOP_TODO.md
- output/SECTION_ARGUMENT_SUMMARIES.jsonl
- output/ARGUMENT_SKELETON.md
- refreshed sections/sections_manifest.jsonl
SECTION_ARGUMENT_SUMMARIES.jsonl 为每个预期 H3 包含一条记录，并为每个段落包含一条记录。当前动作标签是从以下集合中抽取的确定性信号：
setup, thesis, contrast, evidence, evaluation, limitation, synthesis, takeaway
这些标签使章节形态可被检查；它们并不证明论证在科学上有效。ARGUMENT_SKELETON.md 包含一个 ## Consistency Contract 以及章节级映射。它是面向写作者的审计产物，绝不是面向读者的论文内容。
PASS 契约
- 每个预期 H3 都存在；
- 每个 H3 满足 profile 段落下限；
- 每个段落至少有一个允许的动作；
- ARGUMENT_SKELETON.md 包含 ## Consistency Contract；
- sections_manifest.jsonl 携带当前字节数与 sha256 值。
失败时，检查 ARGUMENT_SELFLOOP_TODO.md，并将指定章节路由回其撰写者或证据负责人。该技能本身不应用修复。
运行
uv run python .codex/skills/argument-selfloop/scripts/run.py
--workspace workspaces/<name>
可选运行器字段为 --unit-id、--inputs、--outputs 和 --checkpoint。
触发与路由
触发词：argument snapshot、section ledger、consistency contract、final section manifest、论证快照、一致性契约。
使用时机：章节级修改已完成，且合并需要一份最新的论证台账加内容哈希。
适用场景与限制
适用于研究写作流水线中需要在合并前生成论证快照、刷新章节指纹并检查章节结构完整性的场景。限制包括：它不执行自主重写，不应用修复，动作标签仅为结构性信号而非科学有效性证明，且 ARGUMENT_SKELETON.md 仅供写作者审计使用，不作为读者可见的论文内容。