digital-twin

デジタルツイン

このスキルは、信頼できるデジタルツインの設計と運用に使用します。特に、ソフトウェア製品、エンジニアリングプロセス、デリバリーシステム、インフラ資産群、またはエージェント型ファクトリーのツインに適しています。

基本方針

デジタルツインは、ダッシュボード、3D ビュー、依存関係グラフ、エミュレーター、テスト用フィクスチャ、LLM ラッパーであるとは限りません。この用語を使う前に、表現対象となる実体、同期の取り決め、モデル／サービス、意図する意思決定、不確実性、アクションの境界を明確にしてください。

このスキルでは、以下の実務上の区別を使用します。

• デジタルモデル： ライブ同期ループを必須としない表現です。
• デジタルシャドウ： 元の実体から表現への観測可能なデータの流れがあり、管理された逆方向の経路はありません。
• デジタルツイン： 名前が付けられた実体またはプロセスを、明示された頻度と忠実度で同期するバージョン管理された表現です。明示された意思決定またはアクションを支援するモデル／サービスを備え、元の実体との管理されたフィードバック関係があります。有用な状態で同期されていても、管理された逆方向の経路がない場合は、閉ループ制御の権限があるかのように示さず、読み取り専用ツインまたはデジタルシャドウと呼んでください。
• デジタルスレッド： システム、成果物、意思決定、結果にまたがる来歴とライフサイクルのつながりです。多くのツインでスレッドは必要ですが、それ自体はツインではありません。
• ツインユニバース： 明示的な識別情報、時間、来歴、意味、所有権、権限の境界を持つ、目的を限定したツインの連合または構成です。

これらは実務上の定義であり、普遍的な標準について合意があるという主張ではありません。NIST IR 8356 は、単一の定義について合意がないことを明記する一方、抽象的な実体やプロセスもツインの対象となり得るとしています。

運用モードを選ぶ

状況	ここから開始	先に進む前に必要な証拠
必要なのはインベントリまたは説明だけ	読み取り専用	識別情報、ソースマップ、鮮度、来歴
反実仮想の探索が必要	シミュレーション	固定されたスナップショット／モデル／シナリオ、隔離、不確実性、後片付け
影響を与えずに推奨内容を比較する必要	シャドウ	独立した結果比較、棄権、オペレーターとの意見の相違
影響が小さく、元に戻せるアクションが必要	監督付きまたは範囲限定	ポリシー、スコープを限定した認証情報、前提条件、ロールバック、照合
影響が大きい、または元に戻せないアクションが必要	人間の承認を要する例外、または自動化しない	実行直前の承認、独立した検証、緊急停止

モデルの確信度が高いから、あるいはユーザーがシステムをダークファクトリーと呼ぶからという理由だけで、より高い権限のモードから始めないでください。

入口を選ぶ

現在あるもの	ここから始める	最初の質問
漠然としたアイデアまたはユースケース案	ユースケースの枠組みを定める	対象とする元の実体、意思決定、所有者、危害の境界は実際に何ですか？
グラフ、ダッシュボード、またはイベントフィード	表現を分類する	これはモデル、シャドウ、エミュレーター、ツインのどれですか？ また、何が不足していますか？
状態が古い、または競合している稼働中のツイン	独立して評価する	どの健全性プレーンに障害が発生しましたか？ 権限を hold に引き下げるべきですか？
検証済みのシャドウ推奨	アクション経路を管理する	具体的にどの機能、前提条件、ロールバック、有効期限が承認されていますか？
廃止済み、または後継に置き換えられた元の実体	計画的に廃止する	残っている利用者、認証情報、証拠、孤立した経路はどれですか？

次に、番号付きワークフローに従い、ナビゲーションテーブルで該当するリファレンスを読み込んでください。

運用ワークフロー

作業を開始する前に、該当するリファレンスを読み込みます。

判断事項	読み込むファイル
アーキテクチャまたはフェデレーション	references/architecture.md
イベント、アイデンティティ、状態、来歴、セマンティクス、グラフ、モデル、またはシミュレーション	references/implementation.md
VVUQ、健全性、ドリフト、SLO、またはエージェントの評価	references/evaluation.md
セキュリティ、プライバシー、権限、または獲得した自律性	references/governance.md
変更、インシデントからの復旧、または廃止	references/lifecycle.md
ソースの範囲または標準の比較	references/source-index.md

1. ユースケースを定義します。 元となる対象、意思決定、望ましい成果、信頼できる情報源、更新頻度／忠実度の要件、運用ドメイン、担当者、リスク層、禁止事項、およびよりシンプルな代替案を明確にします。
2. 表現を分類します。 成果物がモデル、シャドウ、ツイン、エミュレーター、シミュレーター、複合ユニバースのいずれに該当するかを判断します。同期待性、モデルの妥当性、ガバナンスされたフィードバック経路の証拠がない限り、より上位の呼称を付与しないでください。
3. コントラクトを設計します。 安定した ID、イベントエンベロープ、タイムスタンプ、スキーマのバージョン、来歴、鮮度、不確実性、有効期間、権限、およびアクションのセマンティクスを定義します。
4. まず証拠を構築します。 不変のソースイベントと成果物を記録してから、再生可能な時間的プロジェクションを作成します。生の証拠は、主張や破棄可能なビューとは分けて保持します。
5. モデルとシナリオを追加します。 モデルの目的、前提、ドメイン、パラメーター、バージョン、キャリブレーション、不確実性、テスト、および使用禁止事項を登録します。シナリオの入力、モデルのダイジェスト、シード、クロック、フィクスチャ、および出力を固定します。
6. 読み取り専用モードとシャドウモードで実行します。 副作用を許可する前に、再構築した状態と推奨事項を、独立して取得した実際の状態と比較します。欠落、古い、矛盾する、または認証されていない証拠は、合格ではなく unknown または hold として扱います。
7. アクション経路をガバナンスします。 監視、シミュレーション、推奨、承認、実行、ロールバック、停止を分離します。認可はモデルの文章ではなく、決定論的なポリシー適用によって行います。冪等性、範囲を限定した認証情報、前提条件、有効期限、ロールバック、および照合を必須とします。
8. 独立して評価します。 表現対象システムの健全性、同期／データの健全性、モデルの妥当性、プラットフォームの健全性、およびエージェント／アクションの品質を、それぞれ別のプレーンとして維持します。ツイン自身に評価させてはいけません。
9. 運用し、進化させます。 鮮度、欠損、順序、スキーマ／トポロジーのドリフト、残差、キャリブレーション、不確実性、シナリオの不足、プラットフォーム SLO、エージェントの軌跡、権限、および成果の価値を監視します。重大な変更後は再検証します。
10. 計画的に廃止します。 アクション権限を取り消し、利用者を段階的に停止して移行し、必要な来歴を保持し、ポリシーに従って秘密情報と機密データを削除し、エンドポイントに廃止済みの印を付け、孤立した呼び出しを検出し、稼働中のワークフローがツインに依存していないことを確認します。

リファレンスの読み込み

運用ワークフローのナビゲーション表を正とし、作業を開始する前に該当するリファレンスを読み込みます。同じリファレンスは、詳細な確認用に直接参照することもできます。対象は、アーキテクチャ、実装、評価、ガバナンス、ライフサイクル、およびソースインデックスです。

エージェント型ソフトウェアファクトリーの境界

ソフトウェアファクトリーの類似モデルでは、リポジトリ、リビジョン、要件、ビルド、成果物、依存関係、サービス、環境、デプロイ、インシデント、人間、エージェント、ポリシー、およびランタイムの観測結果を、ツインのエンティティとイベントに対応付けます。実行可能なリポジトリ環境、サービスエミュレーター、トラフィックミラー、IaC サンドボックス、および学習済みワールドモデルは有用な構成要素ですが、それぞれにシミュレーターと現実との境界があります。重大なコードやインフラの変更では、実際の実行をリリースの判定基準とします。

ダークファクトリーは権限の状態であり、ツインの種類ではありません。自動化を進めるほど、より強力な独立検証、来歴管理、段階的なロールアウト、ロールバック、および責任あるエスカレーションが必要になります。モデルの高い信頼度を権限と同一視しないでください。

成果物を選択する

ユーザーのニーズ	作成するもの	テンプレート／参照資料
ツインとその権限を定義する	ツインマニフェスト	templates/twin-manifest.yaml + references/architecture.md
忠実度、同期、またはエージェントの動作をテストする	評価計画	templates/evaluation-plan.md + references/evaluation.md
権限を付与または拡大するか決定する	リリース証拠パケット	templates/release-evidence.md + references/governance.md
ツインを変更、復旧、または廃止する	ライフサイクル記録	references/lifecycle.md

判断に答えるために必要な最小限の成果物を使用してください。範囲を限定したモデル、シャドウ、エミュレーター、または通常の可観測性記録で十分な場合に、ツインの世界全体を作らないでください。

リリースパケットの最小要件

読み取り専用を超える権限を付与する前に、以下の証拠パケットを保存してください。これはリリースのゲートであり、単なる提案ではありません。

• 意図する用途、リスク、権限に関する契約
• ソースと ID の対応表
• イベント／スキーマ／来歴に関する契約
• 前提、妥当性の限界、不確実性の予算
• 検証および独立した妥当性確認の結果
• 同期／データ品質のベンチマーク
• シナリオおよびリプレイのマニフェスト
• エージェントのタスクと軌跡の評価
• セキュリティ、プライバシー、サプライチェーンのレビュー
• シャドウ／カナリアおよびロールバックの証拠
• ヘルス SLO とアラートの担当者
• 署名済みの approve、conditional approve、hold、または block の決定

使用しない場合

通常のダッシュボード構築、静的アセットのインベントリ作成、汎用的な依存関係マッピング、汎用的な AI ガバナンス、汎用的な DevOps 設計、または名前が指定されたツールの日常的な運用には、このスキルを読み込まないでください。これらのタスクは、関連する可観測性、AI ガバナンス、プラットフォーム、データ、またはツール固有のスキルに振り分けてください。このリポジトリでは、汎用的なエージェント評価／テレメトリーには agent-evals-and-observability、組織全体の AI ガバナンスには ai-governance、一般的なデータプラットフォーム設計には data-architect、名前が指定されたプラットフォームの運用には該当するツールスキルを使用してください。表現そのもの、その同期、シミュレーション／予測、構成、権限、またはライフサイクルが問題となる場合に、このスキルを読み込んでください。

完了条件

要求されたツインの設計または判断の成果物が作成され、主張が証拠と推論に分けられ、該当する評価／ガバナンスのゲートが明示され、未解決のギャップに担当者または範囲を限定したエスカレーション先が設定されたら、作業を終了してください。スキーマ、グラフ、ダッシュボード、またはコンポーネントのテストに合格したという理由だけで、ツインが信頼できる、自律的である、本番環境に対応している、または安全であると主張しないでください。