mcpField
D
distill

distill

github.com/camachoエージェントワークフロー300 回インストール
リポジトリ

distill について

distillは、エージェント指示ファイルを構造化ルールに抽出し、ポリシーと図にまとめるスキルです。段階ごとに再開できるため、増大したルールの監査や再構成に役立ちます。

主な機能

  1. 01指示をJSONLに抽出
  2. 02ポリシー代数でルールを合成
  3. 03判断図を生成
  4. 04段階ごとの再開に対応

活用シーン

  1. 01AGENTS.mdのルール監査
  2. 02ルール体系の再構成準備
  3. 03大規模な指示ファイルの整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/camacho/ai-skills --skill distill

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

詳細

/distill

エージェントの指示ファイルを構造化された命令に抽出し、ポリシー代数で合成して、ルールシステムを可視化します。3 段階のパイプラインです。

使用方法

/distill                                    # full pipeline on default files
/distill ai-workspace/rules/*.md            # specific targets
/distill --stage imperatives                # run only extraction
/distill --stage compose                    # run only policy algebra (requires prior extraction)
/distill --stage visualize                  # run only visualization (requires prior composition)

パイプライン

  ┌─────────────┐     ┌──────────────┐     ┌─────────────┐
  │ /imperatives │────▶│/policy-algebra│────▶│ /visualize  │
  │  extract     │     │  compose     │     │  render     │
  └─────────────┘     └──────────────┘     └─────────────┘
        │                    │                    │
    JSONL file         Starlark block      Mermaid diagrams
ステージ 1 — 抽出（/imperatives）
  1. 対象ファイル（またはデフォルトの ai-workspace/rules/*.md と AGENTS.md）を指定して /imperatives を実行します。
  2. 出力を ai-workspace/research/<name>-imperatives.jsonl に保存します。
  3. 概要（件数、レベル別の内訳、スコープ別の内訳）を提示します。

ユーザーに次のように尋ねます：「合成する前に抽出結果を確認しますか？（y/continue）」

  • はいの場合：確認用に JSONL を提示し、フィードバックを待ち、必要に応じて再抽出します。
  • continue の場合：ステージ 2 に進みます。
ステージ 2 — 合成（/policy-algebra）
  1. JSONL を自然言語の箇条書きに変換します：<level>[ NOT] <subject> <predicate>[ when <when>] — 命令ごとに 1 項目です。
  2. 変換した箇条書きを指定して /policy-algebra を実行します。
  3. Starlark による合成結果を ai-workspace/research/<name>-policy.md に保存します。
  4. 明らかになった構造（判定関数、分岐点）を提示します。
ステージ 3 — 可視化（/visualize）
  1. Starlark の出力に含まれる主要な判定関数ごとに /visualize を実行します。
  2. 通常はグラフ（決定木）から Mermaid フローチャートを生成します。
  3. 図をポリシードキュメントに追加します。

命名規則

<name> のスラッグは、デフォルトで現在の日付 + "distill" です（例：2026-05-04-distill）。--name <slug> で上書きできます。

出力

すべての成果物は ai-workspace/research/ に保存されます。

  • <name>-imperatives.jsonl — 抽出結果の構造化データ
  • <name>-policy.md — Starlark による合成結果 + 図

失敗時の動作

条件動作
/imperatives が命令を 1 つも検出しない報告して停止します。入力が空のままでは合成する意味がありません。
/policy-algebra を利用できないステージ 2 をスキップして警告します。ステージ 3 では引き続き JSONL を直接可視化できます。
ステージ間でユーザーが中断する完了したステージの成果物は保持されます。--stage を指定して再開します。

使用する場面

  • AGENTS.md または rules/ がサイズのしきい値を超えて大きくなり、整理が必要な場合
  • エージェントの指示ファイルを大規模に再構成する前
  • 実際に存在するルールと、存在すると思っているルールを監査する場合
  • ルールシステムを変更する計画への入力として

コメント

Markdown 対応