digital-twin

数字孪生

使用此技能设计和运行可信的数字孪生，尤其是软件产品、工程流程、交付系统、基础设施资产或智能体工厂的孪生。

核心立场

数字孪生并不自动等同于仪表板、3D 视图、依赖关系图、仿真器、测试夹具或 LLM 包装器。使用这个术语之前，应先明确所代表的原始对象、同步约定、模型/服务、预期决策、不确定性和行动边界。

对此技能，采用以下工作定义：

• **数字模型：**一种表示，不要求具备实时同步循环。
• **数字影子：**从原始对象流向表示的可观测数据流，没有受治理的返回路径。
• **数字孪生：**对具名实体或流程进行版本化表示，按明确的频率和保真度同步，并配备支持已声明决策或行动的模型/服务，以及与原始对象之间受治理的反馈关系。如果它已同步且有用，但没有受治理的返回路径，应称为只读孪生或数字影子，而不是暗示其具备闭环决策权。
• **数字线程：**跨系统、工件、决策和结果的溯源与生命周期关联。许多孪生都需要数字线程，但数字线程本身并非孪生。
• **孪生宇宙：**由用途范围明确的孪生构成的联邦或组合，具有明确的身份、时间、溯源、语义、所有权和权限边界。

这些是操作性定义，并非普遍标准共识。NIST IR 8356 明确指出，目前尚无统一定义，同时允许将抽象实体和流程作为孪生对象。

选择运行模式

情况	从此模式开始	升级前所需的证据
你只需要清点或说明	只读	身份、来源映射、时效性、溯源信息
你需要探索反事实情景	仿真	固定的快照/模型/情景、隔离、不确定性、拆除方案
你需要比较建议但不产生影响	影子	独立的结果比较、拒绝决策、操作员意见分歧
你需要执行可逆、低影响的操作	监督式或受限式	策略、限定范围的凭据、前置条件、回滚、调和
你需要执行高影响或不可逆操作	人工批准的例外，或不要自动化	临近执行时的审批、独立验证、紧急停止

不要仅仅因为模型有信心或用户将系统称为暗工厂，就采用权限更高的模式。

选择切入点

当前已有内容	从这里开始	首要问题
模糊的想法或拟议用例	界定用例	实际涉及哪些原始对象、决策、负责人和危害边界？
图、仪表板或事件流	对表示进行分类	这是模型、影子、仿真器还是孪生？还缺少什么？
状态过时或相互冲突的可运行孪生	独立评估	哪个健康平面失效了？权限是否应降级为 hold？
已验证的影子建议	治理行动路径	授权了哪些确切能力、前置条件、回滚措施和有效期？
已退役或已被取代的原始对象	有计划地退役	还剩下哪些使用方、凭据、证据和孤立路径？

然后按编号工作流推进，并从导航表中加载匹配的参考资料。

运行工作流

采取行动前，先加载对应的参考文档：

决策	加载
架构或联邦	references/architecture.md
事件、身份、状态、溯源、语义、图、模型或仿真	references/implementation.md
VVUQ、健康状态、漂移、SLO 或 Agent 评估	references/evaluation.md
安全、隐私、权限或逐步获得的自主权	references/governance.md
变更、事件恢复或退役	references/lifecycle.md
源范围或标准对比	references/source-index.md

1. 界定用例。 说明原始对象、决策、期望结果、权威来源、更新／保真要求、运行领域、负责人、风险等级、禁止的操作，以及更简单的替代方案。
2. 对表示形式分类。 判断该产物是模型、影子、孪生体、仿真器、模拟器还是复合宇宙。没有同步、模型可信度和受治理的反馈路径作为证据时，不要升级其标签。
3. 设计契约。 定义稳定标识、事件封装、时间戳、架构版本、溯源信息、新鲜度、不确定性、有效时间区间、权限和操作语义。
4. 优先构建证据。 捕获不可变的源事件和产物，然后创建可重放的时态投影。将原始证据与声明及可丢弃的视图分开保存。
5. 添加模型和场景。 登记模型用途、假设、领域、参数、版本、校准、不确定性、测试和禁止用途。固定场景输入、模型摘要、种子、时钟、夹具和输出。
6. 运行只读和影子模式。 在允许产生副作用前，将重建的状态和建议与独立捕获的现实情况进行比较。将缺失、陈旧、矛盾或未经身份验证的证据视为 unknown 或 hold，而非通过。
7. 治理操作路径。 将观察、仿真、建议、批准、执行、回滚和停止分开。将授权放入确定性的策略执行机制，而非模型文本中。要求具备幂等性、限定范围的凭据、前置条件、有效期、回滚和协调机制。
8. 独立评估。 将被表示系统的健康状态、同步／数据健康状态、模型可信度、平台健康状态，以及 Agent／操作质量作为彼此独立的层面。孪生体不得自我评估。
9. 运行和演进。 监控新鲜度、丢失、顺序、架构／拓扑漂移、残差、校准、不确定性、场景缺口、平台 SLO、Agent 轨迹、权限和结果价值。发生重大变更后重新验证。
10. 有序退役。 撤销操作权限，使使用方逐步退出并完成迁移，保留必要的溯源记录，按策略移除机密和敏感数据，将端点标记为已退役，检测孤立调用，并验证没有仍在运行的工作流依赖该孪生体。

加载参考文档

运行工作流导航表是规范依据：采取行动前，先加载其中对应的参考文档。也可直接访问相同的参考文档进行深入了解：architecture、implementation、evaluation、governance、lifecycle 和 source-index。

Agentic 软件工厂边界

软件工厂的类比方式是将代码仓库、修订版本、需求、构建、产物、依赖项、服务、环境、部署、事件、人类、Agent、策略和运行时观测映射为孪生实体和事件。可执行的代码仓库环境、服务仿真器、流量镜像、IaC 沙箱和学习型世界模型都是有用的组件，但它们各自都有仿真与现实之间的边界。对于影响重大的代码和基础设施变更，真实执行仍是发布的判定依据。

暗工厂是一种权限状态，而非孪生体类型。自动化程度越高，越需要加强独立验证、溯源、分阶段发布、回滚和负责制升级处理。不要将较高的模型置信度等同于权限。

选择交付物

用户需求	交付物	模板／参考资料
定义孪生体及其权限	孪生体清单	templates/twin-manifest.yaml + references/architecture.md
测试保真度、同步情况或 Agent 行为	评估计划	templates/evaluation-plan.md + references/evaluation.md
决定是否授予或扩大权限	发布证据包	templates/release-evidence.md + references/governance.md
更改、恢复或退役孪生体	生命周期记录	references/lifecycle.md

使用足以支撑决策的最小交付物；如果有界模型、影子模型、仿真器或常规可观测性记录就足够，不要构建一整个孪生宇宙。

最小发布证据包

在授予任何超出只读范围的权限之前，保留以下证据包。这是发布门槛，不是建议：

• 预期用途、风险和权限约定；
• 来源和身份映射；
• 事件／架构／来源信息约定；
• 假设、有效性限制和不确定性预算；
• 验证和独立确认结果；
• 同步／数据质量基准测试；
• 场景和回放清单；
• Agent 任务和执行轨迹评估；
• 安全、隐私和供应链审查；
• 影子／金丝雀测试和回滚证据；
• 健康 SLO 及告警责任人；
• 已签署的 approve、conditional approve、hold 或 block 决策。

何时不应使用

对于常规仪表板构建、静态资产清点、通用依赖关系映射、通用 AI 治理、通用 DevOps 设计或特定工具的日常操作，不要加载此技能。应将这些任务转交给相关的可观测性、AI 治理、平台、数据或特定工具技能。在本仓库中，通用 Agent 评估／遥测使用 agent-evals-and-observability，组织级 AI 治理使用 ai-governance，通用数据平台设计使用 data-architect，特定平台的操作使用相关工具技能。当问题涉及表示本身、其同步、模拟／预测、组合、权限或生命周期时，才加载此技能。

退出标准

当所请求的孪生体设计或决策交付物已经完成、主张已区分为证据和推断、相关评估／治理门槛已明确，且未解决的差距已有负责人或明确的升级范围时，即可停止。绝不能仅因架构、图谱、仪表板或组件测试通过，就声称孪生体可信、自主、可用于生产或安全。