create-yss-spec 3.5.6 → 3.5.8

package/template/.template-spec/process/schemas/strategic-handoff-stage-decision-package.schema.json

@@ -3,95 +3,456 @@
   "$id": "https://yss.local/schemas/stage-decision-package-v2.json",
   "title": "YSS Stage Decision Package",
   "type": "object",
-  "required": ["schema_version", "stage_decision_id", "package_version", "status", "problem_statement", "target_users", "mvp", "non_goals", "success_criteria", "test_seams", "confirmed_decisions", "assumptions", "constraints", "unresolved_items", "context_snapshot", "domain_strategy_ref", "impact_assessment", "downstream_mapping", "evidence_refs", "approval"],
+  "required": [
+    "schema_version",
+    "stage_decision_id",
+    "package_version",
+    "status",
+    "problem_statement",
+    "target_users",
+    "mvp",
+    "non_goals",
+    "success_criteria",
+    "test_seams",
+    "confirmed_decisions",
+    "assumptions",
+    "constraints",
+    "unresolved_items",
+    "context_snapshot",
+    "domain_strategy_ref",
+    "impact_assessment",
+    "downstream_mapping",
+    "evidence_refs",
+    "approval"
+  ],
   "properties": {
-    "schema_version": {"const": 2},
-    "stage_decision_id": {"type": "string", "pattern": "^stage-decision\\.[a-z0-9][a-z0-9-]*$"},
-    "package_version": {"type": "string", "pattern": "^v[0-9]+$"},
-    "status": {"enum": ["draft", "ready-for-human", "approved", "stale", "blocked"]},
-    "problem_statement": {"type": "string", "minLength": 1},
-    "target_users": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "mvp": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "non_goals": {"type": "array", "items": {"type": "string", "minLength": 1}},
-    "success_criteria": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "test_seams": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "confirmed_decisions": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "assumptions": {"type": "array", "items": {"type": "string", "minLength": 1}},
-    "constraints": {"type": "array", "items": {"type": "string", "minLength": 1}},
-    "unresolved_items": {"type": "array", "items": {"$ref": "#/$defs/unresolved"}},
-    "context_snapshot": {"$ref": "#/$defs/contextSnapshot"},
-    "domain_strategy_ref": {"$ref": "#/$defs/domainRef"},
-    "impact_assessment": {"$ref": "#/$defs/impact"},
-    "downstream_mapping": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/mapping"}},
-    "evidence_refs": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-    "approval": {"$ref": "#/$defs/approval"}
+    "schema_version": {
+      "const": 2
+    },
+    "stage_decision_id": {
+      "type": "string",
+      "pattern": "^stage-decision\\.[a-z0-9][a-z0-9-]*$"
+    },
+    "package_version": {
+      "type": "string",
+      "pattern": "^v[0-9]+$"
+    },
+    "status": {
+      "enum": [
+        "draft",
+        "ready-for-human",
+        "approved",
+        "stale",
+        "blocked"
+      ]
+    },
+    "problem_statement": {
+      "type": "string",
+      "minLength": 1
+    },
+    "target_users": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "mvp": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "non_goals": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "success_criteria": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "test_seams": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "confirmed_decisions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "assumptions": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "constraints": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "unresolved_items": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/unresolved"
+      }
+    },
+    "context_snapshot": {
+      "$ref": "#/$defs/contextSnapshot"
+    },
+    "domain_strategy_ref": {
+      "$ref": "#/$defs/domainRef"
+    },
+    "impact_assessment": {
+      "$ref": "#/$defs/impact"
+    },
+    "downstream_mapping": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/mapping"
+      }
+    },
+    "evidence_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "approval": {
+      "$ref": "#/$defs/approval"
+    }
   },
   "$defs": {
     "contextSnapshot": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["context_ref", "context_schema_version", "document_digest", "referenced_terms_digest", "term_refs"],
+      "required": [
+        "context_ref",
+        "context_schema_version",
+        "document_digest",
+        "referenced_terms_digest",
+        "term_refs"
+      ],
       "properties": {
-        "context_ref": {"const": "CONTEXT.md"},
-        "context_schema_version": {"const": 1},
-        "document_digest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
-        "referenced_terms_digest": {"type": "string", "pattern": "^sha256:[0-9a-f]{64}$"},
-        "term_refs": {"type": "array", "items": {"type": "string", "pattern": "^(Global|[A-Z][A-Za-z0-9]+)/[A-Z][A-Za-z0-9]+$"}, "uniqueItems": true}
+        "context_ref": {
+          "const": "CONTEXT.md"
+        },
+        "context_schema_version": {
+          "const": 1
+        },
+        "document_digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "referenced_terms_digest": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "term_refs": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^(Global|[A-Z][A-Za-z0-9]+)/[A-Z][A-Za-z0-9]+$"
+          },
+          "uniqueItems": true
+        }
       }
     },
     "unresolved": {
       "type": "object",
-      "required": ["item", "type", "owner", "next_action", "target_version"],
+      "required": [
+        "item",
+        "type",
+        "owner",
+        "next_action",
+        "target_version"
+      ],
       "properties": {
-        "item": {"type": "string", "minLength": 1},
-        "type": {"enum": ["blocker", "deferred"]},
-        "owner": {"type": "string", "minLength": 1},
-        "next_action": {"type": "string", "minLength": 1},
-        "target_version": {"type": "string", "minLength": 1}
+        "item": {
+          "type": "string",
+          "minLength": 1
+        },
+        "type": {
+          "enum": [
+            "blocker",
+            "deferred"
+          ]
+        },
+        "owner": {
+          "type": "string",
+          "minLength": 1
+        },
+        "next_action": {
+          "type": "string",
+          "minLength": 1
+        },
+        "target_version": {
+          "type": "string",
+          "minLength": 1
+        }
       }
     },
     "domainRef": {
       "type": "object",
-      "required": ["domain_strategy_id", "domain_version", "digest", "status", "persisted_ref"],
+      "required": [
+        "domain_strategy_id",
+        "domain_version",
+        "digest",
+        "status",
+        "persisted_ref"
+      ],
       "properties": {
-        "domain_strategy_id": {"type": "string", "pattern": "^domain-strategy\\.[a-z0-9][a-z0-9-]*$"},
-        "domain_version": {"type": "string", "pattern": "^v[0-9]+$"},
-        "digest": {"type": "string", "minLength": 1},
-        "status": {"enum": ["approved", "stale", "blocked"]},
-        "persisted_ref": {"type": "string", "minLength": 1}
+        "domain_strategy_id": {
+          "type": "string",
+          "pattern": "^domain-strategy\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "domain_version": {
+          "type": "string",
+          "pattern": "^v[0-9]+$"
+        },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "enum": [
+            "approved",
+            "stale",
+            "blocked"
+          ]
+        },
+        "persisted_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "approval_context": {
+          "type": "object",
+          "required": [
+            "subject_ref",
+            "approval_scope",
+            "basis",
+            "drafter_principal_ref"
+          ],
+          "properties": {
+            "subject_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "subject_digest": {
+              "type": "string",
+              "pattern": "^(sha256:)?[a-f0-9]{64}$"
+            },
+            "approval_scope": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "basis": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "required": [
+                  "ref",
+                  "digest"
+                ],
+                "properties": {
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "digest": {
+                    "type": "string",
+                    "pattern": "^(sha256:)?[a-f0-9]{64}$"
+                  }
+                }
+              }
+            },
+            "drafter_principal_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "review_package": {
+              "type": "boolean"
+            }
+          }
+        }
       }
     },
     "impact": {
       "type": "object",
-      "required": ["ui", "api", "data", "backend", "frontend", "cross_repo", "high_risk"],
+      "required": [
+        "ui",
+        "api",
+        "data",
+        "backend",
+        "frontend",
+        "cross_repo",
+        "high_risk"
+      ],
       "properties": {
-        "ui": {"type": "boolean"},
-        "api": {"type": "boolean"},
-        "data": {"type": "boolean"},
-        "backend": {"type": "boolean"},
-        "frontend": {"type": "boolean"},
-        "cross_repo": {"type": "boolean"},
-        "high_risk": {"type": "boolean"}
+        "ui": {
+          "type": "boolean"
+        },
+        "api": {
+          "type": "boolean"
+        },
+        "data": {
+          "type": "boolean"
+        },
+        "backend": {
+          "type": "boolean"
+        },
+        "frontend": {
+          "type": "boolean"
+        },
+        "cross_repo": {
+          "type": "boolean"
+        },
+        "high_risk": {
+          "type": "boolean"
+        }
       }
     },
     "mapping": {
       "type": "object",
-      "required": ["domain_change", "consumer", "propagation", "reapproval_condition"],
+      "required": [
+        "domain_change",
+        "consumer",
+        "propagation",
+        "reapproval_condition"
+      ],
       "properties": {
-        "domain_change": {"type": "string", "minLength": 1},
-        "consumer": {"type": "string", "minLength": 1},
-        "propagation": {"enum": ["direct", "transitive", "not-applicable", "stale"]},
-        "reapproval_condition": {"type": "string", "minLength": 1}
+        "domain_change": {
+          "type": "string",
+          "minLength": 1
+        },
+        "consumer": {
+          "type": "string",
+          "minLength": 1
+        },
+        "propagation": {
+          "enum": [
+            "direct",
+            "transitive",
+            "not-applicable",
+            "stale"
+          ]
+        },
+        "reapproval_condition": {
+          "type": "string",
+          "minLength": 1
+        }
       }
     },
     "approval": {
       "type": "object",
-      "required": ["approval_ref", "approver", "persisted_ref", "current_version"],
+      "required": [
+        "approval_ref",
+        "approver",
+        "persisted_ref",
+        "current_version"
+      ],
       "properties": {
-        "approval_ref": {"type": "string", "minLength": 1},
-        "approver": {"type": "string", "minLength": 1},
-        "persisted_ref": {"type": "string", "minLength": 1},
-        "current_version": {"type": "string", "pattern": "^v[0-9]+$"}
+        "approval_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "approver": {
+          "type": "string",
+          "minLength": 1
+        },
+        "persisted_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "current_version": {
+          "type": "string",
+          "pattern": "^v[0-9]+$"
+        },
+        "approval_context": {
+          "type": "object",
+          "required": [
+            "subject_ref",
+            "approval_scope",
+            "basis",
+            "drafter_principal_ref"
+          ],
+          "properties": {
+            "subject_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "subject_digest": {
+              "type": "string",
+              "pattern": "^(sha256:)?[a-f0-9]{64}$"
+            },
+            "approval_scope": {
+              "type": "array",
+              "minItems": 1,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
+            },
+            "basis": {
+              "type": "array",
+              "minItems": 1,
+              "items": {
+                "type": "object",
+                "required": [
+                  "ref",
+                  "digest"
+                ],
+                "properties": {
+                  "ref": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "digest": {
+                    "type": "string",
+                    "pattern": "^(sha256:)?[a-f0-9]{64}$"
+                  }
+                }
+              }
+            },
+            "drafter_principal_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "review_package": {
+              "type": "boolean"
+            }
+          }
+        }
       }
     }
   }

package/template/.template-spec/process/subagent-collaboration.md

@@ -8,9 +8,15 @@ Subagent 和其它运行时实例只接收边界清晰的任务包。主控数
 
 凡主控向数字人角色或独立运行时正式派发生命周期工作单元，都必须使用 `.template-spec/process/schemas/digital-human-task-package.schema.json` 定义的任务包，并写明 `task_id`、`work_unit_id`、`actor_id`、数字人角色 ID、`runtime_id`、执行态、工作流状态、从 `.template-spec/agents/digital-human-roles.yaml` 复制的 `core_skills` / `forbidden_skills`（可用 `taskPackageDefaults`）、合同类型和版本、输入资产、目标、允许写路径、禁止事项、验收标准、验证命令及其实际退出码 / 执行时间 / 证据引用、下游消费者和汇合方式。`slice-implementation` 才额外绑定 Slice Implementation Contract；禁止手写第二套技能包；任务包由 `scripts/verify-digital-human-task-package` 校验，`scripts/verify-subagent-task-package` 仅为兼容入口。
 
+正式任务仍用 schema v1；Reviewer / Verifier 专业审查任务增加 `review_context`，绑定检查、所需能力、当前候选、当前策略、批准范围、依据摘要和相互独立的审查 / 起草主体。能力定义及补充只读技能只由角色表 `review_capabilities` 和检查策略编译为 `skill_source.review_skills`；不更改角色 `core_skills` / `forbidden_skills`，也不授予实施权限。缺能力、未声明当前上下文或身份相同即阻断，不能只换职称补足独立性。
+
+主控按阻塞原因推进：专业等待先自主派发或检查原任务并等待，验证失败修复或路由；未知影响先调查，只有真实决定或新授权缺失才展示可审阅资产后询问。等待期间继续无依赖的已授权工作，不因需要专业审查或即将提出完成结论结束整条编排链。
+
 ## 汇合
 
-返回结果必须符合 `workflow-execution-result-v1`，至少包括 `work_unit`、`workflow_reference`、`result`、`skill`、`changed_files` / `changed_artifacts`、`evidence_refs`、实际验证结果、`deferred_seams`、`drift`、`violation`、`new_impacts`、`stale_candidates`、`blocking_signals` 和 `next_route`。主控必须重新执行 fresh verification，并在集中 checkpoint 中保留阶段因果。会签写入 `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml`（形状见 `.template-spec/templates/approval-record-template.yaml`），不能用聊天表情代替。恢复前校验 `scripts/verify-approval-record`。
+返回结果必须符合 `workflow-execution-result-v1`，至少包括 `work_unit`、`workflow_reference`、`result`、`skill`、`changed_files` / `changed_artifacts`、`evidence_refs`、实际验证结果、`deferred_seams`、`drift`、`violation`、`new_impacts`、`stale_candidates`、`blocking_signals` 和 `next_route`。主控必须重新执行 fresh verification，并在集中 checkpoint 中保留阶段因果。会签写入 `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml`（形状见 `.template-spec/templates/approval-record-template.yaml`），不能用聊天表情代替。恢复前校验 `scripts/verify-approval-record --require-approved --checkpoint <current checkpoint>`，期望上下文来自消费者，不复制待验记录来证明当前性。
+
+新会签与组合审查使用 schema v2，绑定当前 `review_task_ref/digest`、`capability_ids` 和 `basis`；组合内保留逐项主体、范围、依据和结论。历史记录只读保留，`--history` 不授予当前放行；旧消费者拒绝 v2 后升级，不降级绕过。首轮完整覆盖适用检查，修复后按差异影响定向复审，复用项说明未受影响依据，并将全部消费结论重新绑定当前候选。摘要变化、UI 或 `new_impacts` 不构成全轴默认复审理由，未知先调查。
 
 ## 只读分诊任务包 v2
 

package/template/.template-spec/templates/approval-record-template.json

@@ -1,22 +1,26 @@
 {
   "actor_kind": "digital-human",
   "approval_scope": [],
+  "basis": [],
   "biological_veto": false,
+  "capability_ids": [],
   "continuation_ref": null,
   "countersigner_role_ids": [
     "role.product-manager"
   ],
-  "decision": "approved",
+  "decision": "pending",
   "drafter_principal_ref": null,
   "drafter_role_id": "role.requirements-manager",
   "evidence_refs": [],
   "gate_id": "gate.spec-baseline-approved",
-  "notes": "会签必须可读取；起草者不得出现在 countersigner_role_ids。运行时表情/reaction 无效。",
+  "notes": "草案/历史阅读不授予批准；正式当前批准须有独立 checkpoint/task 上下文和当前主体、范围、依据及身份绑定。",
   "principal_ref": "instance:role.product-manager",
+  "review_task_digest": null,
+  "review_task_ref": null,
   "role_id": "role.product-manager",
   "runtime_id": "runtime.generic",
   "runtime_instance_ref": "runtime.generic:role.product-manager",
-  "schema_version": 1,
+  "schema_version": 2,
   "subject_digest": null,
   "subject_ref": null,
   "user_decision_ref": null

package/template/.template-spec/templates/approval-record-template.yaml

@@ -1,6 +1,6 @@
-schema_version: 1
+schema_version: 2
 gate_id: gate.spec-baseline-approved
-decision: approved
+decision: pending
 actor_kind: digital-human
 role_id: role.product-manager
 runtime_id: runtime.generic
@@ -22,3 +22,9 @@ continuation_ref: null
 subject_digest: null
 # 专业检查必须与起草者为不同执行实例；不仅仅比较职称。
 drafter_principal_ref: null
+
+# 新批准使用能力审查任务；只读 intake v2 不得作为正式审查任务。
+review_task_ref: null
+review_task_digest: null
+capability_ids: []
+basis: []