create-yss-spec 3.3.0 → 3.3.3

package/template/.qoder/skills/yss-stage-decision/SKILL.md

@@ -1,55 +0,0 @@
----
-name: yss-stage-decision
-description: 编排 Discovery 到 Spec 入口的方案决策与业务边界、协作和规则设计；当需求、业务责任区、统一业务词汇或下游影响尚未稳定时使用。
----
-
-# YSS Stage Decision
-
-`yss-stage-decision` 是由生命周期主控调度的上游决策技能，负责把需求、产品、商务输入和业务边界与规则设计结果整理成可审查、可版本化、可被下游消费的方案决策包。它不替代生命周期主控，也不生成产品代码、原型、OpenAPI 或垂直切片 Ticket。
-
-## 适用边界
-
-- 适用于 `project-instance` 的 Discovery → Spec 入口。
-- `template-source` 只维护本技能、Schema、验证器和合成 Fixture，不生成具体产品领域资产。
-- 业务边界与协作工作单元只回答：有哪些业务板块、每个业务责任区负责什么、不同责任区如何交接、使用哪些统一业务词汇、发生哪些业务事实、有哪些待确认的关键业务对象和不可违反的业务规则。
-- Entity、Aggregate、Repository、Java 类、数据库表和 OpenAPI Freeze 留给下游工作单元。
-
-## 执行顺序
-
-1. 读取 `yss-project.yaml`、`CONTEXT.md`、既有 Discovery/Spec、ADR 和父 Ticket/checkpoint。
-2. 分离事实、决策、假设、约束和未决项；技术事实走 `yss-research` 的 `technical-evidence`，领域边界、业务规则、MVP、非目标、成功标准或阶段推进依据等决策证据走 `strategy-evidence`，市场/竞品事实走 `competitive-intelligence`。
-3. 从业务故事、已发生的事实、规则、责任人和失败路径识别业务板块与业务责任区，不从数据库表或调用链直接反推边界。
-4. 为每个业务责任区建立统一业务词汇；对跨责任区协作记录规则提供方、规则使用方、业务决策权、信息传递方向和口径转换负责人。
-5. 记录待确认的关键业务对象，不提前指定技术模型。
-6. 生成 schema v2 `domain_strategy` 和 `stage_decision_package`，使用 `context_snapshot` 绑定根 `CONTEXT.md`、术语身份、完整文档 digest、引用术语 digest、证据和下游影响映射。
-7. 运行 Schema、根路径、术语引用、digest、语义一致性和传播验证；发现关键冲突时返回 `blocked`，不得生成 `approved` 包。v1 字符串引用只读并返回 `migration-required`；可唯一定位的旧锚点用 `scripts/migrate-context-references.mjs` 迁移，歧义引用不得猜测。
-
-## 语义方向规则
-
-内部字段 `semantic_upstream` 表示规则提供方，`semantic_downstream` 表示规则使用方。二者不等于 HTTP、消息或数据库的技术方向。每条协作关系必须独立记录 `transport_direction` 和 `translation_responsibility`；同一对业务责任区可以存在多条相反方向的信息关系。
-
-## 产物与批准
-
-- 业务边界与规则设计是本类事实的权威资产，方案决策包只通过内部字段 `domain_strategy_ref` 引用它。两个合同的 `context_snapshot.context_ref` 必须精确为仓库根 `CONTEXT.md`，禁止子目录、`CONTEXT-MAP.md`、绝对路径和 Markdown 伪锚点。
-- 进入 `gate.domain-strategy-approved` 或 `gate.stage-decision-package-approved` 的外部决策证据必须引用通过校验的 `yss-research` `evidence-audited` 研究包；研究包只提供证据，不得直接修改本技能资产或批准门禁。
-- `stage_decision_package` 必须经过 `draft → ready-for-human → approved`；起草者不得自签。
-- 建议门禁为 `gate.domain-strategy-approved` 和 `gate.stage-decision-package-approved`，实际状态由 `yss-product-lifecycle` 维护；阶段包批准引用必须通过 `scripts/verify-approval-record`，不得用不可读路径或聊天确认替代。
-- 下游只能消费批准且版本当前的包；发现语义冲突返回 `drift` / `new_impacts`，不得静默修改上游。
-
-## 结果合同
-
-返回标准 `Workflow Execution Result`，至少包含 `work_unit`、`workflow_reference`、`result`、`evidence_refs`、`changed_artifacts`、`new_impacts`、`stale_candidates`、`next_route` 和 `blocking_signals`。`blocked` 必须包含冲突、责任人、恢复条件和下一工作单元。
-
-## 禁止事项
-
-- 不把方案决策包当作第二套业务事实源。
-- 不按数据库、微服务、菜单或 HTTP 调用方向自动划分上下文。
-- 不把同名术语强行合并为全局概念。
-- 不在业务方案设计阶段生成技术模型、生产代码或 API 契约。
-- 不把模板 Fixture 当作具体项目的业务事实。
-
-详细合同、字段和验证规则见 `references/domain-strategy-contract.md`、`references/stage-decision-package-contract.md` 与 `references/validation-rules.md`。机器可读合同分别为 `references/domain-strategy.schema.json` 和 `references/stage-decision-package.schema.json`；对应验证器为 `scripts/validate-domain-strategy.mjs` 与 `scripts/validate-stage-decision-package.mjs`。
-
-## 战略交接快照包
-
-跨仓交接使用 `scripts/strategic-handoff export / verify / import`。正式导出前补齐源战略的稳定规则 ID、关键场景和当前批准绑定；源资产原字节冻结、包内路径通过清单解析。目标导入只产生快照和对账/承接草案，正式 reconciliation 通过后才能进入战术设计。流程与字段见 `docs/process/strategic-handoff-package.md`。

package/template/.qoder/skills/yss-stage-decision/references/domain-strategy-contract.md

@@ -1,32 +0,0 @@
-# 业务边界与规则设计合同
-
-## 顶层结构
-
-机器可读合同使用 `references/domain-strategy.schema.json`。顶层必须包含：
-
-- `schema_version: 2`、`domain_strategy_id`、`domain_version`、`status`；
-- `contexts`、`subdomains`、`relationships`、`scenarios`；
-- `concept_candidates`、`invariants`、`context_snapshot`；
-- `downstream_mapping`、`evidence_refs`、`approval`。
-
-## 业务责任区
-
-每个业务责任区声明内部 `context_id`、职责边界、非职责、业务板块分类、责任人、关键场景和本地词汇引用。`context_id` 是稳定身份，由 Agent 维护；不得使用代码模块、数据库 schema 或菜单路径替代。
-
-`context_snapshot.context_ref` 固定为 `CONTEXT.md`，`term_refs` 使用 `<ContextId>/<EnglishIdentifier>` 或 `Global/<EnglishIdentifier>`；同时记录完整文档 `document_digest` 与引用术语集 `referenced_terms_digest`。v1 `terminology_refs` 只读并进入迁移检查，只有唯一映射时才可确定性迁移。
-
-## 关系
-
-协作关系必须声明内部字段 `relationship_pattern`、`semantic_upstream`、`semantic_downstream`、`business_authority`、`model_change_impact`、`transport_direction` 和 `translation_responsibility`。业务人员只需确认协作方式、规则提供方和使用方、业务决策权、信息方向与口径转换负责人；Agent 再映射到合同允许值。
-
-## 待确认的关键业务对象
-
-使用内部类型 `domain_concept_candidate` 表达待确认的关键业务对象，记录识别特征、生命周期、不可违反规则引用、可能的技术映射和置信度。不得在该合同中直接批准技术模型。
-
-## 方案决策包
-
-方案决策包应通过内部字段 `domain_strategy_ref` 引用本合同的当前版本和 digest，并使用 `domain_to_downstream_mapping` 描述业务变化对 Spec、设计、API、数据、Ticket 和测试 seam 的传播。
-
-## 便携交付的逐条追溯
-
-正式导出要求 `traceability_version: 1`、`rule_catalog`、场景 `rule_refs / critical / success_results` 和不变量 `rule_ref`。已有 v2 文档继续只读兼容；缺稳定规则 ID 或未重新批准时禁止正式导出。具体合同见 `docs/process/strategic-handoff-package.md`，不得由导出器发明业务身份。

package/template/.qoder/skills/yss-stage-decision/references/domain-strategy.schema.json

@@ -1,146 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://yss.local/schemas/domain-strategy-v2.json",
-  "title": "YSS 业务边界与规则设计",
-  "type": "object",
-  "required": ["schema_version", "domain_strategy_id", "domain_version", "status", "contexts", "subdomains", "relationships", "scenarios", "concept_candidates", "invariants", "context_snapshot", "downstream_mapping", "evidence_refs", "approval"],
-  "properties": {
-    "traceability_version": {"const": 1},
-    "rule_catalog": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["rule_id", "statement", "responsible_context", "status"], "properties": {"rule_id": {"type": "string", "pattern": "^rule\\.[a-z0-9][a-z0-9-]*$"}, "statement": {"type": "string", "minLength": 1}, "responsible_context": {"type": "string", "minLength": 1}, "status": {"const": "confirmed"}}}, "minItems": 1},
-    "schema_version": {"const": 2},
-    "domain_strategy_id": {"type": "string", "pattern": "^domain-strategy\\.[a-z0-9][a-z0-9-]*$"},
-    "domain_version": {"type": "string", "pattern": "^v[0-9]+$"},
-    "status": {"enum": ["draft", "ready-for-human", "approved", "stale", "blocked"]},
-    "contexts": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/context"}},
-    "subdomains": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/subdomain"}},
-    "relationships": {"type": "array", "items": {"$ref": "#/$defs/relationship"}},
-    "scenarios": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/scenario"}},
-    "concept_candidates": {"type": "array", "items": {"$ref": "#/$defs/concept"}},
-    "invariants": {"type": "array", "items": {"$ref": "#/$defs/invariant"}},
-    "context_snapshot": {"$ref": "#/$defs/contextSnapshot"},
-    "downstream_mapping": {"type": "array", "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"],
-      "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": {
-      "type": "object",
-      "required": ["context_id", "name", "responsibilities", "non_responsibilities", "subdomain_type", "owner", "status"],
-      "properties": {
-        "context_id": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
-        "name": {"type": "string", "minLength": 1},
-        "responsibilities": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "non_responsibilities": {"type": "array", "items": {"type": "string", "minLength": 1}},
-        "subdomain_type": {"enum": ["Core Domain", "Supporting Subdomain", "Generic Subdomain"]},
-        "owner": {"type": "string", "minLength": 1},
-        "status": {"enum": ["candidate", "confirmed", "stale"]}
-      }
-    },
-    "subdomain": {
-      "type": "object",
-      "required": ["subdomain_id", "name", "type", "rationale", "evidence_refs"],
-      "properties": {
-        "subdomain_id": {"type": "string", "pattern": "^subdomain\\.[a-z0-9][a-z0-9-]*$"},
-        "name": {"type": "string", "minLength": 1},
-        "type": {"enum": ["Core Domain", "Supporting Subdomain", "Generic Subdomain"]},
-        "rationale": {"type": "string", "minLength": 1},
-        "evidence_refs": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}
-      }
-    },
-    "relationship": {
-      "type": "object",
-      "required": ["relationship_id", "from_context", "to_context", "relationship_pattern", "semantic_upstream", "semantic_downstream", "business_authority", "model_change_impact", "transport_direction", "translation_responsibility", "direction_explanation"],
-      "properties": {
-        "relationship_id": {"type": "string", "pattern": "^relationship\\.[a-z0-9][a-z0-9-]*$"},
-        "from_context": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
-        "to_context": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
-        "relationship_pattern": {"enum": ["Partnership", "Customer/Supplier", "Conformist", "Anti-Corruption Layer", "Open Host Service", "Published Language", "Shared Kernel", "Separate Ways"]},
-        "semantic_upstream": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
-        "semantic_downstream": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
-        "business_authority": {"type": "string", "minLength": 1},
-        "model_change_impact": {"type": "string", "minLength": 1},
-        "transport_direction": {"type": "string", "minLength": 1},
-        "translation_responsibility": {"type": "string", "minLength": 1},
-        "direction_explanation": {"type": "string", "minLength": 1}
-      }
-    },
-    "scenario": {
-      "type": "object",
-      "required": ["scenario_id", "actor", "preconditions", "commands", "rules", "events", "failure_results", "responsible_context", "consumers", "status"],
-      "properties": {
-        "rule_refs": {"type": "array", "items": {"type": "string", "minLength": 1}, "minItems": 1},
-        "critical": {"type": "boolean"},
-        "success_results": {"type": "array", "items": {"type": "string", "minLength": 1}, "minItems": 1},
-        "scenario_id": {"type": "string", "pattern": "^scenario\\.[a-z0-9][a-z0-9-]*$"},
-        "actor": {"type": "string", "minLength": 1},
-        "preconditions": {"type": "array", "items": {"type": "string"}},
-        "commands": {"type": "array", "minItems": 1, "items": {"type": "string"}},
-        "rules": {"type": "array", "minItems": 1, "items": {"type": "string"}},
-        "events": {"type": "array", "items": {"type": "string"}},
-        "failure_results": {"type": "array", "minItems": 1, "items": {"type": "string"}},
-        "responsible_context": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
-        "consumers": {"type": "array", "items": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"}},
-        "status": {"enum": ["candidate", "confirmed", "stale"]}
-      }
-    },
-    "concept": {
-      "type": "object",
-      "required": ["concept_id", "name", "context_id", "identity_features", "lifecycle", "confidence", "status"],
-      "properties": {
-        "concept_id": {"type": "string", "pattern": "^domain-concept\\.[a-z0-9][a-z0-9-]*$"},
-        "name": {"type": "string", "minLength": 1},
-        "context_id": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
-        "identity_features": {"type": "array", "minItems": 1, "items": {"type": "string"}},
-        "lifecycle": {"type": "array", "minItems": 1, "items": {"type": "string"}},
-        "invariant_refs": {"type": "array", "items": {"type": "string"}},
-        "possible_tactical_role": {"type": "string"},
-        "confidence": {"enum": ["low", "medium", "high"]},
-        "status": {"enum": ["candidate", "confirmed", "stale"]}
-      }
-    },
-    "invariant": {
-      "type": "object",
-      "required": ["invariant_id", "statement", "responsible_context", "scenario_refs", "verification_method"],
-      "properties": {
-        "rule_ref": {"type": "string", "minLength": 1},
-        "invariant_id": {"type": "string", "pattern": "^invariant\\.[a-z0-9][a-z0-9-]*$"},
-        "statement": {"type": "string", "minLength": 1},
-        "responsible_context": {"type": "string", "pattern": "^[A-Z][A-Za-z0-9]+$"},
-        "scenario_refs": {"type": "array", "minItems": 1, "items": {"type": "string"}},
-        "verification_method": {"type": "string", "minLength": 1}
-      }
-    },
-    "mapping": {
-      "type": "object",
-      "required": ["domain_change", "impacts", "propagation", "reapproval_condition"],
-      "properties": {
-        "domain_change": {"type": "string", "minLength": 1},
-        "impacts": {"type": "array", "minItems": 1, "items": {"type": "string"}},
-        "propagation": {"enum": ["direct", "transitive", "stale"]},
-        "reapproval_condition": {"type": "string", "minLength": 1}
-      }
-    },
-    "approval": {
-      "type": "object",
-      "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]+$"}
-      }
-    }
-  }
-}

package/template/.qoder/skills/yss-stage-decision/references/stage-decision-package-contract.md

@@ -1,22 +0,0 @@
-# 方案决策包合同
-
-内部对象 `stage_decision_package` 是 Discovery、需求/产品/商务决策与业务边界和规则设计之间的冻结入口。它记录“做什么、为什么做、范围是什么、哪些仍未决”，不复制业务边界与规则事实。
-
-## 必须包含
-
-- 问题陈述、目标用户、MVP、非目标、成功标准和可执行的测试 seam；
-- 已确认决策、假设、约束和未决项；
-- `context_snapshot`：只引用根 `CONTEXT.md`，并绑定结构化术语身份、全文摘要和引用集摘要；
-- `domain_strategy_ref`：领域战略合同的稳定 ID、版本、digest 和批准状态；
-- UI/API/Data/Backend/Frontend/跨仓/高风险影响面布尔值；
-- 每个下游消费者的传播方式、重新批准条件、证据引用和批准记录。`approval.approval_ref` 必须指向可读取且通过 `scripts/verify-approval-record` 的 `gate.stage-decision-package-approved` 会签记录；`approval.approver` 必须与记录中的 `role_id` 一致。
-
-## 未决项规则
-
-`blocker` 必须阻断批准；`deferred` 必须同时记录责任人、下一动作和目标版本/发布日期。没有责任人或恢复路径的未决项不得隐藏在备注中。
-
-## 下游消费规则
-
-只有 `approved` 且引用的领域战略为 `approved`、版本当前的阶段包，才可以进入 Spec synthesis。任何领域战略 digest、版本或影响面变化都使阶段包 `stale`，并要求重新评估。
-
-阶段包使用 `schema_version: 2`。旧版字符串路径或 Markdown 锚点只能通过迁移器读取；无法唯一映射到 `<ContextId>/<EnglishIdentifier>` 时返回 `migration-required`，不得猜测。

package/template/.qoder/skills/yss-stage-decision/references/stage-decision-package.schema.json

@@ -1,98 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$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"],
-  "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"}
-  },
-  "$defs": {
-    "contextSnapshot": {
-      "type": "object",
-      "additionalProperties": false,
-      "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}
-      }
-    },
-    "unresolved": {
-      "type": "object",
-      "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}
-      }
-    },
-    "domainRef": {
-      "type": "object",
-      "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}
-      }
-    },
-    "impact": {
-      "type": "object",
-      "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"}
-      }
-    },
-    "mapping": {
-      "type": "object",
-      "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}
-      }
-    },
-    "approval": {
-      "type": "object",
-      "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]+$"}
-      }
-    }
-  }
-}

package/template/.qoder/skills/yss-stage-decision/references/validation-rules.md

@@ -1,18 +0,0 @@
-# 验证规则
-
-验证分为结构、引用和语义三层：
-
-1. **结构**：Schema 版本、稳定 ID、状态枚举、必填字段、条件字段和证据格式。
-2. **引用**：上下文端点、场景、不变量、`context_snapshot.term_refs` 和下游资产引用必须可解析；`context_ref` 必须精确为根 `CONTEXT.md`，双摘要必须与当前内容一致。
-3. **语义**：禁止关系自环、未知上下文、未批准 Shared Kernel、未解释的语义/技术方向差异、职责重叠、无责任人的不变量和跨上下文直接共享实体。
-
-以下情况必须 `blocked`：关键规则所有权未知、关键术语冲突、上下文边界未定、关键失败场景缺失、事件语义无法解释、领域专家确认缺失。
-
-以下变化应触发精确传播：
-
-- 术语含义变化 → Spec、验收、原型或 API；
-- 上下文边界变化 → 系统架构、OpenAPI、数据和切片；
-- Context Map 关系变化 → 集成契约和模型翻译；
-- 不变量变化 → 测试 seam、实现合同和验证策略。
-
-验证器允许“语义方向 ≠ 技术方向”，但要求 `direction_explanation` 和翻译责任非空。

package/template/.qoder/skills/yss-stage-decision/scripts/migrate-context-references.mjs

@@ -1,62 +0,0 @@
-#!/usr/bin/env node
-import { readFile } from "node:fs/promises";
-import process from "node:process";
-import { parseArgs } from "node:util";
-import { parseDocument } from "../../../../scripts/vendor/yaml.mjs";
-import { parseContextContract, resolveContextTermRefs } from "../../../../scripts/lib/context-contract.mjs";
-
-function migrationRequired(message) {
-  const error = new TypeError(`migration-required: ${message}`);
-  error.code = "migration-required";
-  throw error;
-}
-
-function migrateReference(reference, context) {
-  if (typeof reference !== "string") migrationRequired(`术语引用必须是字符串: ${String(reference)}`);
-  const scoped = reference.match(/^contexts\/([A-Z][A-Za-z0-9]+)\/CONTEXT\.md#([A-Z][A-Za-z0-9]+)$/);
-  if (scoped) {
-    const termRef = `${scoped[1]}/${scoped[2]}`;
-    if (!context.terms_by_ref.has(termRef)) migrationRequired(`旧引用无法唯一定位根 CONTEXT.md 术语: ${reference}`);
-    return termRef;
-  }
-  const root = reference.match(/^CONTEXT\.md#([A-Z][A-Za-z0-9]+)$/);
-  if (root) {
-    const matches = context.business_terms.filter((term) => term.english_identifier === root[1]);
-    if (matches.length !== 1) migrationRequired(`旧引用无法唯一定位根 CONTEXT.md 术语: ${reference}`);
-    return matches[0].term_ref;
-  }
-  migrationRequired(`旧引用无法唯一定位根 CONTEXT.md 术语: ${reference}`);
-}
-
-try {
-  const { values, positionals } = parseArgs({ options: { root: { type: "string", default: process.cwd() } }, allowPositionals: true, strict: true });
-  const file = positionals[0];
-  if (!file) migrationRequired("用法: migrate-context-references.mjs <contract.yaml> [--root <project-root>]");
-  const source = await readFile(file, "utf8");
-  const document = parseDocument(source, { maxAliasCount: 0, uniqueKeys: true });
-  if (document.errors.length) migrationRequired(`YAML 非法: ${document.errors[0].message}`);
-  const value = document.toJS({ maxAliasCount: 0 });
-  if (!value || typeof value !== "object" || Array.isArray(value)) migrationRequired("合同必须是对象");
-  if (value.schema_version !== 1) migrationRequired("只迁移 schema_version: 1 合同");
-  if (!Array.isArray(value.terminology_refs)) migrationRequired("v1 合同缺少 terminology_refs");
-
-  const context = parseContextContract({ root: values.root });
-  const termRefs = [...new Set(value.terminology_refs.map((reference) => migrateReference(reference, context)))].sort();
-  const resolved = resolveContextTermRefs(context, termRefs);
-  const migrated = {
-    ...value,
-    schema_version: 2,
-    context_snapshot: {
-      context_ref: "CONTEXT.md",
-      context_schema_version: 1,
-      document_digest: context.document_digest,
-      referenced_terms_digest: resolved.referenced_terms_digest,
-      term_refs: termRefs,
-    },
-  };
-  delete migrated.terminology_refs;
-  process.stdout.write(`${JSON.stringify(migrated, null, 2)}\n`);
-} catch (error) {
-  process.stderr.write(`${JSON.stringify({ result: "blocked", reason_code: error.code || "migration-required", errors: [error.message] }, null, 2)}\n`);
-  process.exitCode = 1;
-}