knowledge-activation

ナレッジの活用

成熟した .agents コーパスを、オペレーターがすぐに使えるナレッジサーフェスに変換します。

このスキルでできること

問題がもはや「ナレッジをもっと収集すること」ではなく、次のような場合にこのスキルを使います。

• 繰り返し現れる最も有力な主張を、信念体系に昇格させる
• 健全なトピックを、再利用可能なプレイブックに変換する
• 今後の作業に向けた、目標に応じた簡潔なブリーフィングを作成する
• 内容の薄いトピックや昇格の不足を、気づかないうちに固定化する前に明らかにする

$compile は引き続き衛生管理のループを担います。knowledge-activation はコーパスの運用化を担います。

フライホイールにおける位置づけ

ナレッジの活用は、グローバルコーパスのワークフローにおける第 4 のステップです。

1. $harvest — 複数のリグから成果物を収集し、~/.agents/learnings/ に格納します
2. $compile — 生の成果物を .agents/compiled/ に統合します
3. (optional) 一晩かけて $dream を実行 — 範囲を限定した複利効果のループ
4. $knowledge-activation — 統合したナレッジをプレイブック、信念、実行時ブリーフィングに引き上げます

どのスキルが必要ですか？

harvest、compile、dream、knowledge-activation、quickstart を対象とした「次に使うスキルは？」の全判断表については、docs/skills-decision-tree.md を参照してください。

前提条件

このスキルを使うには、現在のワークスペースに次のものがすでにあることが前提です。

• .agents/ ディレクトリ
• ao knowledge activate がカスタムワークスペースロジックからソースマニフェスト、トピック、昇格済みパケット、チャンクバンドルを再構築する必要がある場合に使う、.agents/scripts/ 配下のパケット更新ビルダー
• または .agents/harvest/latest.json。ao knowledge activate はこれをネイティブのフォールバックとして使い、最新の収穫カタログを harvested-praxis トピックパケット、昇格済みパケット、チャンクバンドルに変換できます
• 機械的に更新可能なパケット、トピック、プレイブック、ブリーフィングの各サーフェス

必要なビルダーの一覧とコマンドの担当範囲については、references/script-contracts.md を参照してください。

コマンドの仕様

安定したプロダクトサーフェスは、ao knowledge コマンドファミリーです。

ao knowledge activate --goal "turn agents into usable information"
ao knowledge beliefs
ao knowledge playbooks
ao knowledge brief --goal "fix auth startup"
ao knowledge gaps

このスキルは、ルーティング、順序付け、解釈、次のステップの推奨を担います。信念、プレイブック、ブリーフの各プロダクトサーフェスは、ao が直接管理します。

ao lookup と ao codex start は、これらの出力をオペレーター向けのコンテキストとして利用します。該当するナレッジブリーフィングは、動的な起動サーフェスとして推奨されます。また、選択された信念と健全なプレイブックは、範囲を限定した補助的なガイダンスを提供します。 取得したブリーフィング、信念、プレイブックによって推奨内容が変わった場合は、ao metrics cite "<path>" --type applied 2>/dev/null || true で記録してください。読み込んだものの使わなかったコンテキストには、--type retrieved を使用します。

実行手順

ステップ 1：事前確認

.agents/ が存在することを確認します。ao knowledge activate の実行を予定している場合は、次のエビデンス基盤が少なくとも 1 つ存在することを確認します。

• パケットビルダー：source_manifest_build.py、topic_packet_build.py、corpus_packet_promote.py、knowledge_chunk_build.py
• harvest フォールバック：.agents/harvest/latest.json
• ネイティブのオペレーターサーフェス：ao knowledge beliefs、ao knowledge playbooks、ao knowledge brief、ao knowledge gaps

ステップ 2：エビデンスの統合

パケットレイヤーを次の順序で実行します。

1. ソースマニフェスト
2. トピックパケット
3. 昇格済みパケット
4. 過去のチャンクバンドル

DAG 全体と信頼ゲートについては、references/dag.md を参照してください。

ステップ 3：オペレーターサーフェスの抽出

昇格済みのオペレーターレイヤーを更新します。

ao knowledge beliefs
ao knowledge playbooks

これらにより、.agents/knowledge/ と .agents/playbooks/ 配下に利用者向けサーフェスが生成されます。

ステップ 4：目標に応じたブリーフィングの作成

進行中の目標がある場合は、範囲を限定した起動支援を作成します。

ao knowledge brief --goal "your goal here"

ブリーフィングは簡潔に保ち、出典となるサーフェスを明記し、選択したトピックの内容が薄い場合は警告を含めてください。

ステップ 5：ギャップの明示

次を実行します。

ao knowledge gaps

内容の薄いトピック、昇格の不足、レビューが必要な根拠の弱い主張、および次に推奨されるマイニング作業が報告されます。

ステップ 6：完全な外側のループ

完全な処理を 1 ステップで実行するには、次を実行します。

ao knowledge activate --goal "your goal here"

このコマンドは、エビデンスの統合、信念とプレイブックの更新、任意のブリーフィングの作成、ギャップの要約を順に実行します。

信頼ルール

• パケット化は基盤であり、成果物ではありません
• 信念、プレイブック、ブリーフィングが、オペレーターが実際に利用する画面です
• エビデンスが改善されるまでは、情報の少ないトピックは探索専用のままにします
• 生成される各画面には、その利用者を明記する必要があります
• 変更のない実行を繰り返しても、構造は決定的である必要があります

正式な出力画面と信頼境界については、references/output-surfaces.md を参照してください。

出力画面

利用者向けの出力は次のとおりです。

• .agents/knowledge/book-of-beliefs.md
• .agents/playbooks/index.md
• .agents/playbooks/<topic>.md
• .agents/briefings/YYYY-MM-DD-<goal>.md
• .agents/retro/

基盤となる画面は次のとおりです。

• .agents/packets/
• .agents/topics/
• .agents/packets/chunks/catalog.jsonl

例

進行中の目標に対して完全な外側のループを有効にする

/knowledge-activation
ao knowledge activate --goal "productize knowledge activation"

信念とプレイブックの昇格レイヤーのみを更新する

ao knowledge beliefs
ao knowledge playbooks

コーパスを安全に昇格できるか確認する

ao knowledge gaps

参考資料

• references/dag.md
• references/script-contracts.md
• references/output-surfaces.md
• references/knowledge-activation.feature — 実行可能な仕様：エビデンスを統合し、信念とプレイブックを抽出し、目標の実行時にブリーフィングを作成し、ギャップを明らかにします（soc-qk4b）