mcpField
A
argument-selfloop

argument-selfloop

github.com/willoscar文档处理51739 次安装3 周前更新
代码仓库

关于 argument-selfloop

面向论文写作流程的技能，可根据章节草稿生成最终论证快照。它记录结构标签、一致性契约和章节哈希，并标记缺失或过短的文本，但不会自行修复。

主要功能

  1. 01汇总预期的 H3 章节
  2. 02标注段落论证动作
  3. 03生成一致性契约
  4. 04更新章节内容哈希
  5. 05标记缺失或过短文本

适用场景

  1. 01合并前审查章节草稿
  2. 02检查段落级论证结构
  3. 03将未通过的章节交回修订

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill argument-selfloop

安装后在 Claude Code 中输入/argument-selfloop确认已加载。

附带文件scripts/run.py

详细介绍

论证快照

触发条件与路由

  • 触发词：argument snapshot、section ledger、consistency contract、final section manifest、论证快照、一致性契约。
  • 适用场景：各章节的修改已完成，合并时需要最新的论证台账和内容哈希。

创建供合并和后续审计使用的最终 C5 快照。

虽然 Skill 名称沿用历史叫法，但当前实现并非自主重写循环。它会读取最终的 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
  • 刷新的 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 均达到配置文件要求的段落下限；
  • 每个段落至少包含一种允许的移动；
  • ARGUMENT_SKELETON.md 包含 ## Consistency Contract；
  • sections_manifest.jsonl 包含最新的 bytes 和 sha256 值。

若 FAIL，请检查 ARGUMENT_SELFLOOP_TODO.md，并将其中指定的章节交回撰写者或证据负责人。本 Skill 不会自行执行修复。

运行

uv run python .codex/skills/argument-selfloop/scripts/run.py \
  --workspace workspaces/<name>

可选的 runner 字段包括 --unit-id、--inputs、--outputs 和 --checkpoint。

评论

支持 Markdown