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 に対して 1 つ、各段落に対して 1 つのレコードが含まれます。現在の移動ラベルは、次から抽出される決定論的なシグナルです。

setup, thesis, contrast, evidence, evaluation, limitation, synthesis, takeaway

これらのラベルによってセクションの構成を確認できますが、論証の科学的妥当性が証明されるわけではありません。ARGUMENT_SKELETON.md には ## Consistency Contract と章レベルのマップが含まれます。これは執筆者向けの監査成果物であり、読者向けの論文本文には含めません。

PASS 契約

  • 予期されるすべての H3 が存在すること。
  • すべての H3 がプロファイルで定められた段落数の下限を満たすこと。
  • 各段落に、許可された移動が 1 つ以上含まれること。
  • 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>

オプションのランナーフィールドは --unit-id、--inputs、--outputs、--checkpoint です。

コメント

Markdown 対応