Communityライティング&編集github.com

Vault Crystallize

Claude/エージェント用スキル。進捗をHandoff.mdにチェックポイントし、ソースを引用・信頼度付きのエビデンスログに蒸留して、エージェント管理の知識保管庫に格納します。

Vault Crystallize とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)が知識保管庫(knowledge vault)内で`crystallize`(結晶化)と`distill`(蒸留)の操作を実行するための行動権限を定義します。`crystallize`は現在の作業状態を`Handoff.md`にチェックポイントとして記録し、安定した長期知識を`llm-wiki/`ページに保存します。`distill`は具体的な情報源(ファイル、テキスト、URLなど)を解析し、引用付きで信頼度(high/medium/low/unverified)を明記したエビデンスエントリに変換して`evidence-log.md`に追加します。このスキルは、プロジェクトやリサーチドメインごとに適切なレイヤー(プロジェクトレベル、グローバルレベル)を自動的に判断して知識をルーティングし、重複や矛盾を防ぐためのレビューチェックリストや検証ツールも提供します。日本語で動作する場合でも、技術的識別子は英語で保持します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add WIHATN/vault-crystallize

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Vault Crystallize は何をしますか?

このスキルは、知識保管庫内での crystallize(結晶化)および distill(蒸留)操作に関する行動権限です。保管庫プロトコルはデータ契約を定義します。

  • AGENTS.md はワークスペースの境界、起動時の階層、書き込み所有権を定義します。
  • global/agent-rules/handoff-protocol.md は Handoff.md の形式を定義します。
  • global/agent-rules/llm-wiki-protocol.md は llm-wiki/ のページスキーマ、エビデンス、矛盾、統合、ヘルスチェックを定義します。
  • global/agent-rules/llm-wiki-format.md は存在する場合のページテンプレートを定義します。

プロトコル内に ## Crystallize セクションを探さないでください。古い保管庫にそれが存在する場合、このスキルの動作を優先し、プロトコルはデータ契約としてのみ使用してください。

境界

専用のトリガー:

  • 结晶、结晶一下、crystallize -> チェックポイントの復旧状態と、変更があった場合のみ安定した長期知識。
  • 蒸馏、distill -> 具体的な情報源を、引用付きで信頼度を明記したエビデンスエントリに変換します。

このスキルを neat-freak、深層監査、広範なドキュメント整理、メモリ同期、または洗練された「结晶版」サマリーのために使用しないでください。ユーザーが明示的にその別タスクを要求した場合を除きます。単なる 收尾、「wrap up」、「整理一下」、「sync my notes」は結晶化のトリガーではありません。

このスキルをインストールしていないエージェントは、インストール/更新の問題であり、結晶化動作を保管庫プロトコルに複製する理由にはなりません。ユーザーが明示的にインストール作業を要求しない限り、.claude/skills、.agents/skills、ジャンクション、またはエージェントごとのインストールパスを作成しないでください。

ネイティブコマンドラッパーは commands/ および commands/<agent>/ に配置されます。共有の通常エイリアススキルは skills/ に配置されます。プラットフォーム固有のディレクトリに重複するエイリアス SKILL.md ファイルを追加しないでください。Codexが再帰的に二重発見する可能性があります。これらすべてを明示的な呼び出しアダプターとして扱い、更新時には SKILL.md を行動権限として維持してください。

言語のデフォルト

Handoff.md と llm-wiki/ の内容はデフォルトで日本語で記述します。コード、コマンド、変数名、パス、API名、パッケージ名、ソースタイトル(元のタイトルを保持することが重要な場合)など、安定した技術的識別子は英語で保持します。

ユーザーが明示的に他の言語を要求した場合、ソース資料を引用する場合、または既存のプロジェクトルールがそのユニットに対してより具体的である場合にのみ、別の言語を使用します。

コマンド: crystallize

  1. 現在のユニットを特定する:
    • projects/<name>/ 配下での作業 -> そのプロジェクト。
    • research/<name>/ 配下での作業 -> そのリサーチドメイン。ただし、サブモジュールに独自の Handoff.md がある場合は除く。
    • 保管庫ガバナンスまたは保管庫横断ルール -> ルート Handoff.md および global/llm-wiki/。
  2. 現在のプロジェクト状態を主張する前に、現在のユニットの Handoff.md を読む。ユニットが不明な場合は、ルート Handoff.md をアクティブプロジェクトインデックスとして読む。それでも不明な場合は、簡潔な質問を1つ行う。
  3. 実際に何か変更されたかどうかを判断する:
    • 復旧ポイントが変更された -> 現在のユニット Handoff.md を更新する。
    • 別のスレッドが長期的に知っておくべき安定した結論 -> 一致する既存の llm-wiki/ ページを更新する。
    • 復旧または長期的な変更がない -> 何も書き込まず、その理由を述べる。
  4. 書き込む前に、各安定した結論を再利用範囲に応じてルーティングする:
    • 問いかけ:この結論は、明日類似したタスクを行う別のプロジェクトでも真実であり有用だろうか?はい -> 一般的な事実を一致する global/llm-wiki/<topic>.md ページに書き込み、プロジェクト固有の適用詳細とプロジェクトWikiへのウィキリンクポインタのみを保持する。不明 -> プロジェクトレベルに留める(デフォルトでダウン)。
    • 2つのルール:このセッションが別のプロジェクトのWikiに存在する結論を使用または書き換えた場合、その結論を今すぐグローバルトピックページに昇格させる。
    • 読み取り前に書き込まない:対象トピックページを最初に読み、既存の同一主題エントリがある場合はそれにマージする。決して盲目的に追加しない。既存のトピックが適合しない場合にのみ新しいトピックページを作成し、同じパスで global/llm-wiki/index.md の ## Triggers を更新する。
  5. 正しいレイヤーのみに書き込む:
    • Handoff.md には、現在のステータス、アクティブファイル、未解決の質問、次のアクション、再開コンテキストを含める。
    • llm-wiki/ には、安定した決定、方法、落とし穴、メモリ、エンティティ/コンセプト、またはエビデンスエントリを含める。
    • log.md は、真に主要な知識操作のためだけに使用し、日常的な結晶化には使用しない。
    • ツールプライベートメモリ、プロセス再生、エージェントキャッシュは、決して保管庫の権限とならない。
  6. Handoff.md に ## Tracks がある場合、最終確定する前にすべてのライブトラックをスイープする。作業が明示的に閉じない限り、非フォーカストラックは保持する。
  7. 完了を報告する前に、以下のレビューチェックリストを実行する。

コマンド: distill

ユーザーが明示的に distill、蒸馏、または具体的な情報源を追跡可能なエビデンスに変換するよう依頼した場合にのみ使用します。

入力:

  • ソース:ファイルパス、貼り付けられたテキスト、取得したURLコンテンツ、メモ、PDF、会話の抜粋。
  • 対象ユニット:ソースパスまたは現在のタスクから推測する。曖昧な場合は、簡潔な質問を1つ行う。
  • 宛先:対象ユニット llm-wiki/evidence-log.md。

ワークフロー:

  1. 対象ユニットの Handoff.md を読む。
  2. global/agent-rules/llm-wiki-protocol.md のセクション ## Evidence Log と ## Pending Contradictions を読む。
  3. ソースをソース順に番号付きブロック B1、B2、B3、... に分割する。生の長いソースは sources/ または notes/ に保持し、ポインタと簡潔なエビデンスのみを llm-wiki/ に配置する。
  4. エビデンスと推論を分離する。エビデンスの主張は (src: Bn) を引用する。推論は依存するソースブロックに名前を付ける。
  5. 結論ごとに信頼度を割り当てる:high、medium、low、または unverified。
  6. 新しいエビデンスが既存の llm-wiki/ と矛盾する場合は、## Pending Contradictions に従う。黙って上書きしない。

エビデンスエントリの形式:

### YYYY-MM-DD · <ソースタイトル>
- **来源:** [[relative/source-or-note]]
- **原文块:**
  - B1: <短いソースロケータまたは抜粋サマリー>
  - B2: <短いソースロケータまたは抜粋サマリー>
- **证据结论:**
  - <主張> (src: B1) - confidence: <high|medium|low|unverified>
- **推断:**
  - <推論> (from: B1+B2) - confidence: <high|medium|low|unverified>
- **待验证:** <具体的な検証必要性、または `无`>

レビューチェックリスト

Handoff レビュー:

  • handoff-protocol.md から必要なセクションのみを含む。## Tracks は並行ライブトラックがある場合のみオプション。
  • ## Tracks が存在する場合、正確に1つのトラックに [focus] がある。
  • ## Last Done は最大4エントリ、逆時系列、各エントリは日付で終わる。
  • ## Next Actions は最大3つの具体的なチェックボックス項目。
  • ## Active Files は各ファイルが今アクティブな理由を説明し、ファイルが何であるかは説明しない。
  • ## Decisions は [[llm-wiki/decisions]] へのウィキリンク、決定ブロックID、または None を含む。
  • ## Resume は次のエージェントに何を読み、どのようなメンタルモデルを保持すべきかを伝える。

LLM Wiki レビュー:

  • 新規または大幅に変更されたページには、llm-wiki-protocol.md で必要なフロントマターがある。
  • ページタイプが内容と一致している:decision、method、pitfall、memory、evidence、entity、concept、glossary、または operation log。
  • 新しいページはローカルの llm-wiki/index.md からリンクされている。
  • 主張には信頼度がある。エビデンスの主張はソースを指している。
  • 未解決の矛盾は、隠されるのではなく、指定された場所に記録されている。
  • プロジェクト横断的に再利用可能な結論は global/llm-wiki/ トピックページにルーティングされている。どのレイヤーにも事実が重複していない(プロジェクトはアプリケーション詳細とポインタを保持する)。
  • エントリの見出しとフィールドセットが、ページタイプの llm-wiki-format.md テンプレートと一致している。主張ページ(method / pitfall / topic)は安定した主題名でキー付けされ、イベントページ(decisions / evidence / log)は日付でキー付けされている。
  • Markdownテーブル内にエイリアス化されたウィキリンクがない。

動作レビュー:

  • 明示的に要求されない限り、neat-freak を実行または呼び出さない。
  • ドキュメント整理、メモリ同期、書式調整に拡大しない。
  • 明示的に要求されない限り、エージェントローカルスキルのインストールを管理しない。
  • 何も変更されていない場合は書き込まない。「何も変更されていません」と報告することは有効な結果です。

検証

ファイルが作成、移動、名前変更された場合、またはユーザーがスレッド/エージェントを切り替える場合、保管庫ルートから読み取り専用のヘルススイートを実行します:

pwsh -NoProfile -File global/tools/vault-health.ps1
pwsh -NoProfile -File global/tools/vault-meta.ps1 -Audit
pwsh -NoProfile -File global/tools/vault-links.ps1

内容のみの編集の場合は、最小の関連チェックを実行し、スキップした内容を報告します。

よくある失敗モード

失敗修正
「スキルを持たない他のエージェントは結晶化しない」インストール/更新の配布がそれを解決します。動作をプロトコルに複製しないでください。
llm-wiki-protocol.md ## Crystallize を読む停止してください。このスキルが結晶化動作を所有します。プロトコルは形式とヘルスチェックのみを定義します。
收尾 や「cleanup docs」を結晶化として扱う専用の単語または明示的なエビデンス意図が現れるまでトリガーしないでください。
プロセスログを llm-wiki/ に書き込む安定した結論のみがそこに属します。
古いHandoffリストに追加する文書化された上限内でスライディングウィンドウを書き換えてください。
マージせずに主張ページ(methods / pitfalls / topic)に新しい日付エントリを追加する主張ページは主題でキー付けされています。既存のエントリを見つけ、その場で書き換え、updated / 验证于 を更新してください。

関連スキル