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
- 現在のユニットを特定する:
projects/<name>/配下での作業 -> そのプロジェクト。research/<name>/配下での作業 -> そのリサーチドメイン。ただし、サブモジュールに独自のHandoff.mdがある場合は除く。- 保管庫ガバナンスまたは保管庫横断ルール -> ルート
Handoff.mdおよびglobal/llm-wiki/。
- 現在のプロジェクト状態を主張する前に、現在のユニットの
Handoff.mdを読む。ユニットが不明な場合は、ルートHandoff.mdをアクティブプロジェクトインデックスとして読む。それでも不明な場合は、簡潔な質問を1つ行う。 - 実際に何か変更されたかどうかを判断する:
- 復旧ポイントが変更された -> 現在のユニット
Handoff.mdを更新する。 - 別のスレッドが長期的に知っておくべき安定した結論 -> 一致する既存の
llm-wiki/ページを更新する。 - 復旧または長期的な変更がない -> 何も書き込まず、その理由を述べる。
- 復旧ポイントが変更された -> 現在のユニット
- 書き込む前に、各安定した結論を再利用範囲に応じてルーティングする:
- 問いかけ:この結論は、明日類似したタスクを行う別のプロジェクトでも真実であり有用だろうか?はい -> 一般的な事実を一致する
global/llm-wiki/<topic>.mdページに書き込み、プロジェクト固有の適用詳細とプロジェクトWikiへのウィキリンクポインタのみを保持する。不明 -> プロジェクトレベルに留める(デフォルトでダウン)。 - 2つのルール:このセッションが別のプロジェクトのWikiに存在する結論を使用または書き換えた場合、その結論を今すぐグローバルトピックページに昇格させる。
- 読み取り前に書き込まない:対象トピックページを最初に読み、既存の同一主題エントリがある場合はそれにマージする。決して盲目的に追加しない。既存のトピックが適合しない場合にのみ新しいトピックページを作成し、同じパスで
global/llm-wiki/index.mdの## Triggersを更新する。
- 問いかけ:この結論は、明日類似したタスクを行う別のプロジェクトでも真実であり有用だろうか?はい -> 一般的な事実を一致する
- 正しいレイヤーのみに書き込む:
Handoff.mdには、現在のステータス、アクティブファイル、未解決の質問、次のアクション、再開コンテキストを含める。llm-wiki/には、安定した決定、方法、落とし穴、メモリ、エンティティ/コンセプト、またはエビデンスエントリを含める。log.mdは、真に主要な知識操作のためだけに使用し、日常的な結晶化には使用しない。- ツールプライベートメモリ、プロセス再生、エージェントキャッシュは、決して保管庫の権限とならない。
Handoff.mdに## Tracksがある場合、最終確定する前にすべてのライブトラックをスイープする。作業が明示的に閉じない限り、非フォーカストラックは保持する。- 完了を報告する前に、以下のレビューチェックリストを実行する。
コマンド: distill
ユーザーが明示的に distill、蒸馏、または具体的な情報源を追跡可能なエビデンスに変換するよう依頼した場合にのみ使用します。
入力:
- ソース:ファイルパス、貼り付けられたテキスト、取得したURLコンテンツ、メモ、PDF、会話の抜粋。
- 対象ユニット:ソースパスまたは現在のタスクから推測する。曖昧な場合は、簡潔な質問を1つ行う。
- 宛先:対象ユニット
llm-wiki/evidence-log.md。
ワークフロー:
- 対象ユニットの
Handoff.mdを読む。 global/agent-rules/llm-wiki-protocol.mdのセクション## Evidence Logと## Pending Contradictionsを読む。- ソースをソース順に番号付きブロック
B1、B2、B3、... に分割する。生の長いソースはsources/またはnotes/に保持し、ポインタと簡潔なエビデンスのみをllm-wiki/に配置する。 - エビデンスと推論を分離する。エビデンスの主張は
(src: Bn)を引用する。推論は依存するソースブロックに名前を付ける。 - 結論ごとに信頼度を割り当てる:
high、medium、low、またはunverified。 - 新しいエビデンスが既存の
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 / 验证于 を更新してください。 |