mcpField
A
artifact-contract-auditor

artifact-contract-auditor

github.com/willoscarエージェントワークフロー51740 回インストール3 週間前に更新
リポジトリ

artifact-contract-auditor について

artifact-contract-auditorは、完了したユニットやパイプラインの目標で指定されたファイルの有無を確認し、カバレッジレポートを作成します。部分実行と終了済みの実行を区別し、詳細な来歴監査ではなくファイルの網羅性を検査します。

主な機能

  1. 01ロックされたパイプライン契約を読み込み
  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 artifact-contract-auditor

インストール後、Claude Code で/artifact-contract-auditorを入力して読み込まれたか確認します。

同梱ファイルscripts/run.py

詳細

Artifact Contract Auditor

このスキルはカバレッジを測定します。つまり、Unit とロックされた Pipeline が約束したファイルが、必要とされる時点で存在するかを確認します。pipeline.py audit による Attempt、Manifest、Artifact のハッシュ、台帳の詳細なチェックに代わるものではありません。

入力

  • UNITS.csv。
  • PIPELINE.lock.md。
  • ロックされた pipelines/*.pipeline.md のターゲット Artifact 契約。

出力

  • output/CONTRACT_REPORT.md。

手順

1. 有効な契約を解決する

PIPELINE.lock.md を読み込み、このリポジトリ内の Pipeline を解決して、UNITS.csv を解析します。無効なロックや不正な Unit テーブルは、別の Workflow を推測するのではなく、報告対象の契約違反として扱います。

完了条件：1 つの Pipeline 契約と、読み取り可能な 1 つの Unit テーブルが監査対象として確定していること。

2. 完了した Unit の出力を確認する

すべての DONE Unit について、必須出力がそれぞれ存在することを確認します。? が先頭に付いた出力は任意です。必須出力が存在しない場合、Pipeline の実行中であっても Unit レベルの契約ドリフトとなります。

完了条件：すべての DONE Unit が出力完了として分類されるか、不足している必須パスがそれぞれ一覧表示されていること。

3. 該当する場合は、Pipeline の最終ターゲットを確認する

すべての Unit が終端状態（DONE または SKIP）かどうかを判定します。その場合に限り、Pipeline で宣言された任意ではないすべてのターゲット Artifact を必須とします。部分的な Run の間は、最終ターゲットの不足を失敗ではなく想定内として報告します。

完了条件：最終ターゲットの完全性が、単なるファイルの有無ではなく、実際の Run フェーズに基づいて評価されていること。

4. レポートを作成する

必ず output/CONTRACT_REPORT.md を作成し、次のいずれかのステータスを記載します。

  • PASS：終端状態の Run で、Unit の出力が完全かつ Pipeline のターゲットがすべて揃っている。
  • OK：部分的な Run で、完了した Unit の出力に矛盾がない。
  • FAIL：DONE Unit の出力が不足している、または終端状態の Run で最終ターゲットが不足している。

完了条件：レポートに、評価対象の Pipeline、Run フェーズ、ステータス、およびブロック要因となる不足パスがすべて記載されていること。

5. 次のアクションに振り分ける

Unit の出力が不足している場合は、Pipeline アダプターを通じて担当 Unit を再開または再実行します。最終ターゲットが不足している場合は、担当する Unit または Skill を特定します。ファイルのカバレッジに問題がない場合は、来歴の整合性確認に scripts/pipeline.py audit を使用します。

完了条件：すべての FAIL 項目に担当者と修復手順があり、PASS の主張が宣言済みファイルのカバレッジに明示的に限定されていること。

コンテキストへのポインター

  • ターゲット Artifact の唯一の情報源は、ロックされた Pipeline の front matter です。
  • Unit の出力義務の唯一の情報源は UNITS.csv です。
  • Attempt のペアリング、Manifest の識別情報、ハッシュ、Decision、Failure、Evaluation の整合性確認には、詳細な Run Audit を使用します。

スクリプト

クイックスタート
uv run python .codex/skills/artifact-contract-auditor/scripts/run.py \
  --workspace workspaces/<name>
すべてのオプション
  • --workspace <path>：監査対象の Workspace。
  • --unit-id <U###>、--inputs、--outputs、--checkpoint：Pipeline ランナーとの互換性を保つための任意の引数。
例

インターフェースを確認します。

uv run python .codex/skills/artifact-contract-auditor/scripts/run.py --help

カバレッジに問題がなかった後、詳細な来歴監査を実行します。

uv run python scripts/pipeline.py audit --workspace workspaces/<name>

副作用

監査によって output/CONTRACT_REPORT.md が作成または置換される場合があります。研究コンテンツ、Unit のステータス、チェックポイントの承認、ソース Artifact は編集してはなりません。

コメント

Markdown 対応