create-yss-spec 2.2.9 → 3.0.0

package/template/.trae/skills/yss-research/assets/evidence-template.yaml

@@ -0,0 +1,68 @@
+{
+  "schema_version": 1,
+  "profile": "strategy-evidence",
+  "mode": "evidence-audited",
+  "scope": {
+    "topic": "<topic>",
+    "audience": "<audience>",
+    "time_horizon": "<time horizon>",
+    "research_questions": ["<question>"],
+    "inclusion_criteria": ["<criterion>"],
+    "exclusion_criteria": ["<criterion>"]
+  },
+  "ownership": {
+    "research_owner": "yss-research",
+    "downstream_owner": "<lifecycle skill or role>",
+    "decision_ref": null
+  },
+  "search_log": [
+    {
+      "id": "search-001",
+      "channel": "<channel or corpus>",
+      "query_or_corpus": "<query or inspected material>",
+      "searched_at": "YYYY-MM-DD",
+      "result": "results-found"
+    },
+    {
+      "id": "search-002",
+      "channel": "<counter-signal channel>",
+      "query_or_corpus": "<counter-signal query>",
+      "searched_at": "YYYY-MM-DD",
+      "result": "none-found"
+    }
+  ],
+  "evidence_items": [
+    {
+      "id": "evidence-001",
+      "source_level": "direct-experience",
+      "visibility": "internal",
+      "source_class": "<interview, support, ticket, docs, specification, source-code, dataset, report>",
+      "source_ref": "<URL or repository reference>",
+      "locator": "<line, section, record, timestamp, or comment>",
+      "stance": "support",
+      "observed_at": "YYYY-MM-DD",
+      "evidence_date": "YYYY-MM-DD",
+      "observation": "<what the source directly shows>",
+      "limitations": ["<sampling, recency, access, or independence limit>"]
+    }
+  ],
+  "claims": [
+    {
+      "id": "claim-001",
+      "claim_kind": "user-problem",
+      "statement": "<decision-bearing claim>",
+      "decision_bearing": true,
+      "evidence_refs": ["evidence-001"],
+      "counter_signal_refs": ["search-002"],
+      "audit_status": "supported",
+      "confidence": "medium",
+      "disposition": "publish"
+    }
+  ],
+  "source_gaps": [],
+  "audit_summary": {
+    "status": "complete",
+    "audited_claim_ids": ["claim-001"],
+    "notes": []
+  }
+}

package/template/.trae/skills/yss-research/assets/research-brief-template.md

@@ -0,0 +1,36 @@
+# <Topic> Research Brief
+
+## Research Scope
+
+- Profile: `technical-evidence` or `strategy-evidence`
+- Mode: `evidence-audited`
+- Decision informed:
+- Audience:
+- Time horizon:
+- Inclusion criteria:
+- Exclusion criteria:
+- Access limitations:
+
+## Executive Read
+
+Summarize the evidence-backed answer and its decision boundary.
+
+## Findings
+
+For every decision-bearing finding, cite its `claim-*` ID and source links. Separate observation, inference, hypothesis, and recommendation.
+
+## Counter-Signals
+
+Describe conflicting evidence and unsuccessful counterexample searches without treating `none-found` as proof of absence.
+
+## Source Map
+
+Explain what each source class contributed, exclusions, access failures, and weak areas.
+
+## Decision Handoff
+
+Identify the downstream owner and asset. State explicitly that this research does not approve or mutate that asset.
+
+## Evidence Limitations
+
+List sampling, recency, independence, access, and provenance limits plus any `needs-deeper-research` claims.

package/template/.trae/skills/yss-research/references/evidence-contract.md

@@ -0,0 +1,42 @@
+# YSS Research Evidence Contract
+
+This contract defines the persisted `evidence-audited` package. The Markdown brief is the readable narrative; the adjacent evidence file is the source of truth for search execution, provenance, claim mapping, audit state, and downstream ownership.
+
+## Evidence levels
+
+| Level | Meaning | Allowed use |
+|---|---|---|
+| `primary` | Official specification, official documentation, first-party API, source code, filing, or original dataset | Required for decision-bearing `technical-evidence` claims |
+| `direct-experience` | Interview, support record, ticket, direct observation, telemetry, or original user report | May support `strategy-evidence`; state sampling and access limits |
+| `near-primary` | Dated review, vendor case study, marketplace record, or a report with inspectable methodology | May support strategy claims with qualification |
+| `secondary` | Reputable synthesis that identifies its underlying evidence | Context or corroboration; avoid as the sole basis for high-impact decisions |
+| `lead-only` | Aggregator snippet, unattributed repost, or AI-generated summary | Search lead only; never a supporting evidence reference |
+
+## Search and counter-signals
+
+Each material query or corpus inspection has a stable `search-*` ID, execution date, channel, query/corpus, and result. Allowed results are `results-found`, `none-found`, `access-failed`, and `excluded`.
+
+Each claim must name supporting evidence and at least one counter-signal. A counter-signal is either an `evidence-*` item marked `counter` or a `search-*` entry with `none-found`. A `none-found` search only proves that the declared search did not find a counterexample.
+
+## Claim audit
+
+Allowed outcomes:
+
+- `supported`: the evidence directly supports the wording;
+- `partially-supported`: only a narrower, qualified wording is supportable;
+- `unsupported`: the source does not support the claim;
+- `not-audited`: temporary state, forbidden when the package says audit is complete.
+
+`partially-supported` requires disposition `qualify`. `unsupported` requires `needs-deeper-research`. `lead-only` items cannot be cited as support. In `technical-evidence`, every decision-bearing claim needs at least one `primary` supporting item.
+
+In `strategy-evidence`, decision-bearing kinds are `user-problem`, `business-constraint`, `domain-boundary`, `business-rule`, `mvp`, `non-goal`, `success-criterion`, and `stage-decision-basis`. These claims must all be present in `audit_summary.audited_claim_ids` before downstream lifecycle consumption.
+
+## Ownership and failure
+
+The package names its downstream owner and optional decision reference. It does not change the owned artifact or gate. Structure errors, unresolved references, decision-bearing unaudited claims, or a false `complete` declaration fail validation. Access gaps and conflicting evidence are recorded in `source_gaps`; they do not fail the entire brief unless they leave a decision-bearing claim unsupported.
+
+The evidence file uses JSON syntax, which is valid YAML 1.2, so validation is portable and dependency-free.
+
+## Design provenance
+
+The Search Log, evidence passport, and claim-source alignment concepts are adapted from [Academic Research Skills](https://github.com/Imbad0202/academic-research-skills). This YSS contract omits academic writing, publication, fixed agent teams, and cross-model review machinery, and retains YSS lifecycle ownership boundaries.

package/template/.trae/skills/yss-research/scripts/validate-research-package.mjs

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import path from "node:path";
+
+const PROFILE_VALUES = ["technical-evidence", "strategy-evidence"];
+const SOURCE_LEVELS = ["primary", "direct-experience", "near-primary", "secondary", "lead-only"];
+const CLAIM_KINDS = ["technical-fact", "user-problem", "business-constraint", "domain-boundary", "business-rule", "mvp", "non-goal", "success-criterion", "stage-decision-basis", "background"];
+const STRATEGY_DECISION_KINDS = new Set(["user-problem", "business-constraint", "domain-boundary", "business-rule", "mvp", "non-goal", "success-criterion", "stage-decision-basis"]);
+
+function fail(message) { throw new TypeError(message); }
+function requireString(value, label) { if (typeof value !== "string" || !value.trim()) fail(`${label} must be a non-empty string`); }
+function requireArray(value, label, nonEmpty = false) { if (!Array.isArray(value) || (nonEmpty && value.length === 0)) fail(`${label} must be ${nonEmpty ? "a non-empty" : "an"} array`); }
+function requireChoice(value, choices, label) { if (!choices.includes(value)) fail(`${label} must be one of: ${choices.join(", ")}`); }
+
+function indexed(items, label) {
+  const result = new Map();
+  items.forEach((item, index) => {
+    requireString(item?.id, `${label}[${index}].id`);
+    if (result.has(item.id)) fail(`${label} contains duplicate id: ${item.id}`);
+    result.set(item.id, item);
+  });
+  return result;
+}
+
+function readEvidence(file) {
+  try {
+    const value = JSON.parse(readFileSync(file, "utf8"));
+    if (!value || typeof value !== "object" || Array.isArray(value)) fail("evidence root must be an object");
+    return value;
+  } catch (error) {
+    if (error instanceof TypeError && error.message === "evidence root must be an object") throw error;
+    fail(`${path.basename(file)} must use JSON-compatible YAML 1.2 syntax: ${error.message}`);
+  }
+}
+
+function validate(briefFile, evidenceFile) {
+  if (!briefFile || !evidenceFile) fail("usage: validate-research-package.mjs <brief.md> <evidence.yaml>");
+  const briefPath = path.resolve(briefFile);
+  const evidencePath = path.resolve(evidenceFile);
+  if (path.dirname(briefPath) !== path.dirname(evidencePath)) fail("brief and evidence files must be adjacent");
+  if (!briefPath.endsWith("-research-brief.md") || !evidencePath.endsWith("-evidence.yaml")) fail("expected <slug>-research-brief.md and <slug>-evidence.yaml");
+  const briefSlug = path.basename(briefPath, "-research-brief.md");
+  if (!briefSlug || briefSlug !== path.basename(evidencePath, "-evidence.yaml")) fail("brief and evidence files must use the same non-empty slug");
+
+  const brief = readFileSync(briefPath, "utf8");
+  ["Research Scope", "Executive Read", "Findings", "Counter-Signals", "Source Map", "Decision Handoff", "Evidence Limitations"].forEach((heading) => {
+    if (!brief.includes(`## ${heading}`)) fail(`brief is missing heading: ## ${heading}`);
+  });
+
+  const data = readEvidence(evidencePath);
+  if (data.schema_version !== 1) fail("schema_version must be 1");
+  requireChoice(data.profile, PROFILE_VALUES, "profile");
+  if (data.mode !== "evidence-audited") fail("mode must be evidence-audited");
+  ["topic", "audience", "time_horizon"].forEach((field) => requireString(data.scope?.[field], `scope.${field}`));
+  ["research_questions", "inclusion_criteria", "exclusion_criteria"].forEach((field) => requireArray(data.scope?.[field], `scope.${field}`, true));
+  if (data.ownership?.research_owner !== "yss-research") fail("ownership.research_owner must be yss-research");
+  requireString(data.ownership?.downstream_owner, "ownership.downstream_owner");
+  if (data.ownership.decision_ref !== null && (typeof data.ownership.decision_ref !== "string" || !data.ownership.decision_ref.trim())) fail("ownership.decision_ref must be null or a non-empty string");
+
+  requireArray(data.search_log, "search_log", true);
+  const searches = indexed(data.search_log, "search_log");
+  data.search_log.forEach((entry, index) => {
+    ["channel", "query_or_corpus", "searched_at"].forEach((field) => requireString(entry[field], `search_log[${index}].${field}`));
+    requireChoice(entry.result, ["results-found", "none-found", "access-failed", "excluded"], `search_log[${index}].result`);
+  });
+
+  requireArray(data.evidence_items, "evidence_items", true);
+  const evidence = indexed(data.evidence_items, "evidence_items");
+  data.evidence_items.forEach((item, index) => {
+    requireChoice(item.source_level, SOURCE_LEVELS, `evidence_items[${index}].source_level`);
+    requireChoice(item.visibility, ["public", "internal"], `evidence_items[${index}].visibility`);
+    requireChoice(item.stance, ["support", "counter"], `evidence_items[${index}].stance`);
+    ["source_class", "source_ref", "locator", "observed_at", "observation"].forEach((field) => requireString(item[field], `evidence_items[${index}].${field}`));
+    requireArray(item.limitations, `evidence_items[${index}].limitations`);
+  });
+
+  requireArray(data.claims, "claims", true);
+  const claims = indexed(data.claims, "claims");
+  data.claims.forEach((claim, index) => {
+    requireChoice(claim.claim_kind, CLAIM_KINDS, `claims[${index}].claim_kind`);
+    requireString(claim.statement, `claims[${index}].statement`);
+    if (typeof claim.decision_bearing !== "boolean") fail(`claims[${index}].decision_bearing must be boolean`);
+    requireArray(claim.evidence_refs, `claims[${index}].evidence_refs`, true);
+    requireArray(claim.counter_signal_refs, `claims[${index}].counter_signal_refs`, true);
+    requireChoice(claim.audit_status, ["supported", "partially-supported", "unsupported", "not-audited"], `claims[${index}].audit_status`);
+    requireChoice(claim.confidence, ["low", "medium", "high"], `claims[${index}].confidence`);
+    requireChoice(claim.disposition, ["publish", "qualify", "needs-deeper-research"], `claims[${index}].disposition`);
+
+    const supporting = claim.evidence_refs.map((ref) => {
+      if (!evidence.has(ref)) fail(`${claim.id} has unresolved evidence ref: ${ref}`);
+      const item = evidence.get(ref);
+      if (item.stance !== "support") fail(`${claim.id} support ref is not marked support: ${ref}`);
+      if (item.source_level === "lead-only") fail(`${claim.id} uses lead-only evidence as support: ${ref}`);
+      return item;
+    });
+    claim.counter_signal_refs.forEach((ref) => {
+      if (!evidence.has(ref) && !searches.has(ref)) fail(`${claim.id} has unresolved counter-signal ref: ${ref}`);
+      if (evidence.has(ref) && evidence.get(ref).stance !== "counter") fail(`${claim.id} counter-signal evidence is not marked counter: ${ref}`);
+      if (searches.has(ref) && searches.get(ref).result !== "none-found") fail(`${claim.id} counter-signal search must have result none-found: ${ref}`);
+    });
+    if (data.profile === "technical-evidence" && claim.decision_bearing && !supporting.some((item) => item.source_level === "primary")) fail(`${claim.id} is a decision-bearing technical claim without primary evidence`);
+    if (data.profile === "strategy-evidence" && STRATEGY_DECISION_KINDS.has(claim.claim_kind) && claim.decision_bearing !== true) fail(`${claim.id} strategy claim kind must be decision-bearing: ${claim.claim_kind}`);
+    if (claim.audit_status === "partially-supported" && claim.disposition !== "qualify") fail(`${claim.id} is partially supported and must use qualify`);
+    if (claim.audit_status === "unsupported" && claim.disposition !== "needs-deeper-research") fail(`${claim.id} is unsupported and must use needs-deeper-research`);
+    if (claim.decision_bearing && claim.audit_status === "unsupported") fail(`${claim.id} is decision-bearing and cannot remain unsupported`);
+    if (!brief.includes(claim.id)) fail(`brief does not reference claim: ${claim.id}`);
+  });
+
+  requireArray(data.source_gaps, "source_gaps");
+  if (data.audit_summary?.status !== "complete") fail("audit_summary.status must be complete");
+  requireArray(data.audit_summary.audited_claim_ids, "audit_summary.audited_claim_ids", true);
+  requireArray(data.audit_summary.notes, "audit_summary.notes");
+  const audited = new Set(data.audit_summary.audited_claim_ids);
+  audited.forEach((id) => { if (!claims.has(id)) fail(`audit_summary has unknown claim: ${id}`); });
+  claims.forEach((claim, id) => {
+    if (claim.decision_bearing && !audited.has(id)) fail(`audit_summary is missing decision-bearing claim: ${id}`);
+    if (claim.decision_bearing && claim.audit_status === "not-audited") fail(`${id} remains not-audited`);
+  });
+  return { claims: claims.size, evidence: evidence.size, searches: searches.size, profile: data.profile };
+}
+
+try {
+  const result = validate(process.argv[2], process.argv[3]);
+  process.stdout.write(`YSS research package valid (${result.profile}, ${result.claims} claims, ${result.evidence} evidence items, ${result.searches} searches)\n`);
+} catch (error) {
+  process.stderr.write(`YSS research package invalid: ${error.message}\n`);
+  process.exitCode = 1;
+}

package/template/.trae/skills/yss-research/tests/run-scenarios.mjs

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const validator = path.join(root, "scripts/validate-research-package.mjs");
+const template = JSON.parse(readFileSync(path.join(root, "assets/evidence-template.yaml"), "utf8"));
+const directory = mkdtempSync(path.join(tmpdir(), "yss-research-"));
+const brief = path.join(directory, "sample-research-brief.md");
+const evidence = path.join(directory, "sample-evidence.yaml");
+const headings = ["Research Scope", "Executive Read", "Findings", "Counter-Signals", "Source Map", "Decision Handoff", "Evidence Limitations"];
+
+function run(payload, status, expected) {
+  writeFileSync(brief, `${headings.map((heading) => `## ${heading}`).join("\n\n")}\n\n${payload.claims.map((claim) => claim.id).join(" ")}\n`);
+  writeFileSync(evidence, `${JSON.stringify(payload, null, 2)}\n`);
+  const result = spawnSync(process.execPath, [validator, brief, evidence], { encoding: "utf8" });
+  if (result.status !== status || !`${result.stdout}${result.stderr}`.includes(expected)) throw new Error(`expected ${status}/${expected}, got ${result.status}: ${result.stdout}${result.stderr}`);
+}
+
+try {
+  template.scope.topic = "Example strategy question";
+  template.scope.audience = "Product team";
+  template.scope.time_horizon = "Last 12 months";
+  template.scope.research_questions = ["Which problem should the domain address?"];
+  template.scope.inclusion_criteria = ["Direct experience in scope"];
+  template.scope.exclusion_criteria = ["Untraceable reposts"];
+  template.ownership.downstream_owner = "yss-stage-decision";
+  template.search_log[0].channel = "Support records";
+  template.search_log[0].query_or_corpus = "failed approval workflow";
+  template.search_log[0].searched_at = "2026-09-03";
+  template.search_log[1].channel = "Support records";
+  template.search_log[1].query_or_corpus = "successful approval workflow";
+  template.search_log[1].searched_at = "2026-09-03";
+  template.evidence_items[0].source_class = "support";
+  template.evidence_items[0].source_ref = "support-case-001";
+  template.evidence_items[0].locator = "event-3";
+  template.evidence_items[0].observed_at = "2026-09-03";
+  template.evidence_items[0].evidence_date = "2026-08-30";
+  template.evidence_items[0].observation = "The approval stopped when the owner was missing.";
+  template.evidence_items[0].limitations = ["Single support case"];
+  template.claims[0].statement = "A missing owner can block the approval workflow.";
+  run(template, 0, "YSS research package valid");
+
+  const falseStrategyBackground = structuredClone(template);
+  falseStrategyBackground.claims[0].decision_bearing = false;
+  run(falseStrategyBackground, 1, "strategy claim kind must be decision-bearing");
+
+  const unsupported = structuredClone(template);
+  unsupported.claims[0].audit_status = "unsupported";
+  unsupported.claims[0].disposition = "publish";
+  run(unsupported, 1, "must use needs-deeper-research");
+
+  const unsupportedDecision = structuredClone(template);
+  unsupportedDecision.claims[0].audit_status = "unsupported";
+  unsupportedDecision.claims[0].disposition = "needs-deeper-research";
+  run(unsupportedDecision, 1, "decision-bearing and cannot remain unsupported");
+
+  const falseCounter = structuredClone(template);
+  falseCounter.claims[0].counter_signal_refs = ["search-001"];
+  run(falseCounter, 1, "counter-signal search must have result none-found");
+
+  const technicalWithoutPrimary = structuredClone(template);
+  technicalWithoutPrimary.profile = "technical-evidence";
+  technicalWithoutPrimary.claims[0].claim_kind = "technical-fact";
+  run(technicalWithoutPrimary, 1, "technical claim without primary evidence");
+
+  const leadOnly = structuredClone(template);
+  leadOnly.evidence_items[0].source_level = "lead-only";
+  run(leadOnly, 1, "uses lead-only evidence as support");
+
+  const unaudited = structuredClone(template);
+  unaudited.audit_summary.audited_claim_ids = [];
+  run(unaudited, 1, "must be a non-empty array");
+
+  process.stdout.write("YSS research scenarios passed (8)\n");
+} finally {
+  rmSync(directory, { recursive: true, force: true });
+}

package/template/.trae/skills/yss-router/references/router-contract.yaml

@@ -5,7 +5,7 @@ skill_aliases:
   api-integration: yss-api-integration
   microapp-commit: yss-microapp-commit
   page-module-development: yss-page-module-development
-  yss-ui-business-page-generation: yss-page-module-development
+  research: yss-research
   use-table-height: yss-use-table-height
   use-tree-height: yss-use-tree-height
 implementation_path_policy:
@@ -108,17 +108,41 @@ context_plan:
   missing_context_action: [blocked, reroute]
 
 scaffold_contract_schema:
-  schema_version: 1
+  schema_version: 2
+  identity: service-engineering-baseline
   compiled_by: yss-router
   approved_by: yss-product-lifecycle
   status_by_owner:
     router: [draft, ready-for-lifecycle-review, blocked]
     lifecycle: [approved, stale, blocked]
-  required: [contract_id, contract_version, slice_id, status, router_draft_ref, lifecycle_approval_ref, persisted_ref, current_version, implementation_repository, backend_repository, scaffold_status, target_git_url_or_output_dir, allowed_write_paths, expected_evidence_files, verification_commands, approval, work_unit, overwrite_policy]
+  required: [contract_id, contract_version, scaffold_request_id, status, router_draft_ref, lifecycle_approval_ref, persisted_ref, current_version, implementation_repository, backend_repository, scaffold_status, project_name, target_output_dir, base_package, maven_coordinates, profiles, allowed_write_paths, expected_evidence_files, verification_commands, approval, work_unit, generation_policy]
   approval:
     required: [approval_ref, approver, persisted_ref, current_version]
-  overwrite_policy:
-    required: [force_allowed, overwrite_scope, rollback_ref]
+  generation_policy:
+    required: [mode, existing_target, old_project_migration, template_upgrade]
+    mode: initialize-only
+    existing_target: unsupported
+    old_project_migration: unsupported
+    template_upgrade: unsupported
+  maven_coordinates:
+    required: [group_id, project_version, parent, yss_components_version]
+    parent_required: [group_id, artifact_id, version]
+    yss_components_version: 2.0.0-SNAPSHOT
+  profiles:
+    required: [architecture, persistence, database, platform, validation_namespace, dto_placement, repository]
+    supported_initial:
+      architecture: target-domain-model
+      persistence: mybatis-plus
+      database: mysql
+      platform: spring-boot-2.7-jdk8
+      validation_namespace: javax
+      dto_placement: web
+      repository: yss-internal
+    unsupported: [old-architecture-profile, client-in-domain, mybatis, spring-boot-3, jakarta, separate-client-module]
+  unsupported_inputs:
+    schema_v1: reject-no-auto-upgrade
+    slice_id: forbidden-as-scaffold-identity
+    existing_project: reject-no-scaffold-migration
   lifecycle_boundary:
     router_emits: [draft, ready-for-lifecycle-review, blocked]
     lifecycle_approves: [approved]
@@ -127,12 +151,18 @@ scaffold_contract_schema:
   work_unit:
     required: [id, behavior, primary_skill, supporting_skills, tdd_mode, allowed_write_paths, expected_evidence, verification_commands, controlled_generation]
   generation_boundary:
-    allowed_for: [project_scaffold, pom, mechanical_config, wrapper]
+    allowed_for: [project_scaffold, pom, mechanical_config, wrapper, bootstrap_entrypoint, manifest_v2, architecture_rules, test_infrastructure]
     forbidden_when: [business_behavior, business_fields, business_state, permission, transaction, complex_query, error_mapping, business_example_crud]
+    initialization: initialize-only
+    regeneration: unsupported
+    template_upgrade: unsupported
+    old_project_migration: unsupported-separate-architecture-modernization-initiative
   verification:
     commands: ["./mvnw validate", "./mvnw test", "./mvnw package"]
     requires_execution: true
-    evidence: [command, exit_code, duration_ms, stdout_ref, stderr_ref, executed_at]
+    completion_levels: [generated, empty-scaffold-verified, first-slice-verified]
+    downstream_readiness_claim_requires: first-slice-verified
+    evidence: [preflight, command, exit_code, failure_category, duration_ms, stdout_ref, stderr_ref, executed_at]
 
 applicable_subcontract_nonempty:
   frontend:
@@ -168,10 +198,10 @@ dependency_closure:
     always: [alibaba-java-code-style]
     when_conversion: [mapstruct, lombok]
   yss-repository:
-    always: [mapstruct, lombok, alibaba-java-code-style]
-    when_mybatis: [yss-mybatis]
+    always: [yss-mybatis, mapstruct, lombok, alibaba-java-code-style]
   yss-web-controller:
-    always: [yss-dto, mapstruct, lombok, alibaba-java-code-style]
+    always: [yss-dto, yss-validation, mapstruct, lombok, alibaba-java-code-style]
+    when_error_mapping: [yss-exception]
   yss-userinfo:
     always: [yss-dto]
     when_cache_lookup: [yss-cache]
@@ -183,6 +213,11 @@ dependency_closure:
     always: [yss-exception]
   yss-exception:
     always: [yss-dto]
+  yss-ui-business-page-generation:
+    when_components: [yss-components]
+    when_hooks: [yss-hook]
+    when_form: [yss-formily]
+    when_api: [yss-api-integration]
   yss-page-module-development:
     when_components: [yss-components]
     when_hooks: [yss-hook]
@@ -211,8 +246,11 @@ end_to_end_backend_required:
   - yss-domain
   - yss-application
   - yss-repository
+  - yss-mybatis
   - yss-web-controller
   - yss-dto
+  - yss-exception
+  - yss-validation
   - mapstruct
   - lombok
   - alibaba-java-code-style

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

@@ -17,7 +17,7 @@ description: 编排 Discovery 到 Spec 入口的阶段决策与 DDD 战略设计
 ## 执行顺序
 
 1. 读取 `yss-project.yaml`、`CONTEXT.md`、既有 Discovery/Spec、ADR 和父 Ticket/checkpoint。
-2. 分离事实、决策、假设、约束和未决项；技术事实走 `research`，市场/竞品事实走 `competitive-intelligence`。
+2. 分离事实、决策、假设、约束和未决项；技术事实走 `yss-research` 的 `technical-evidence`，领域边界、业务规则、MVP、非目标、成功标准或阶段推进依据等决策证据走 `strategy-evidence`，市场/竞品事实走 `competitive-intelligence`。
 3. 从业务场景、事件、规则、责任人和失败路径识别子域及限界上下文，不从数据库表或调用链直接反推边界。
 4. 为每个上下文建立本地统一语言；为跨上下文关系记录语义上游/下游、业务决策权、技术传输方向和翻译责任。
 5. 记录核心领域概念候选，不提前锁定 Entity 或 Aggregate。
@@ -31,6 +31,7 @@ description: 编排 Discovery 到 Spec 入口的阶段决策与 DDD 战略设计
 ## 产物与批准
 
 - DDD 资产是事实源，阶段决策包只通过 `domain_strategy_ref` 引用它们。
+- 进入 `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`，不得静默修改上游。

package/template/.trae/skills/yss-ui/SKILL.md

@@ -46,14 +46,15 @@ pnpm why vue @yss-ui/components @yss-ui/hooks ant-design-vue vxe-table
 
 - `YTable` 替代 AntDV `Table`，列使用 `field/type` 和字段同名插槽。
 - `YTree` 替代 AntDV `Tree`。
-- `YssFormily` 是新代码 canonical name；`YFormily` 仅作为已确认导出的 deprecated alias。
+- `YFormily` 是新代码 canonical name；`YssFormily` 仅作为已确认导出的历史兼容 alias。
 - `YSplitPane`、`YButton`、`YCard` 等已有封装优先使用 YSS。
 
 ## 4. 最小专项 skill 路由
 
 | 任务 | 必须路由 |
 |---|---|
-| 完整页面模块 | `yss-page-module-development` |
+| 新建或改造完整业务页面 | `yss-ui-business-page-generation` |
+| 生命周期页面编排与旧触发词兼容 | `yss-page-module-development` |
 | 页面布局、组件和交互 | `yss-components` |
 | 请求、分页、参数、树数据映射 | `yss-hook` |
 | Formily schema、联动、校验、详情态 | `yss-formily` |
@@ -78,7 +79,7 @@ views/PageName/
 - `index.vue` 只做页面编排和事件转发。
 - `components/` 承载区块展示和局部交互。
 - `hooks/` 承载请求、分页、参数单一来源、映射和错误兜底。
-- `schemas/` 承载 `YssFormily` schema。
+- `schemas/` 承载 `YFormily` schema。
 - 页面内禁止复制请求流程、分页状态和复杂字段转换。
 
 ## 6. 跨组件强制约束
@@ -129,7 +130,7 @@ verification: pnpm type-check
 1. 读取批准合同、项目版本和组件映射。
 2. 选择最小专项 skills。
 3. 搭页面目录和布局。
-4. 接 `YssFormily`、`YTable`、`YTree` 等 YSS 主体组件。
+4. 接 `YFormily`、`YTable`、`YTree` 等 YSS 主体组件。
 5. 下沉请求、分页和映射到 `yss-hook`。
 6. 接高度、主题、locale、浮层和无障碍约束。
 7. 联调冻结 API、Mock、路由和权限。
@@ -139,7 +140,7 @@ verification: pnpm type-check
 
 - [ ] 已记录 Vue、YSS UI、AntDV、VXE 实际版本。
 - [ ] 组件选型符合 `component-routing.md`，回退有证据。
-- [ ] 新代码使用 `YssFormily` 和真实存在的 `yss-hook`。
+- [ ] 新代码使用 `YFormily` 和真实存在的 `yss-hook`。
 - [ ] YTable/YTree/Formily/高度 Hook 遵循专项 skill。
 - [ ] 主题、locale、浮层容器和微应用隔离已检查。
 - [ ] loading/empty/error/no-access/selected 状态按影响面覆盖。

package/template/.trae/skills/yss-ui/references/component-routing.md

@@ -9,7 +9,7 @@
 | 数据表格 | `YTable` | VXE Table + AntDV Pagination | specialized | 使用 `yss-components`、`field/type`、字段插槽 |
 | 编辑表格 | `YEditTable` | VXE Table | specialized | 对照 edit-table docs/demo |
 | 树 | `YTree` | AntDV Tree | specialized | 搜索、Tooltip、动作和高度路由 |
-| Schema 表单 | `YssFormily` | Formily + AntDV | specialized | `YssFormily` 为 canonical；加载 `yss-formily` |
+| Schema 表单 | `YFormily` | Formily + AntDV | specialized | `YFormily` 为 canonical；`YssFormily` 仅为历史兼容名；加载 `yss-formily` |
 | 分栏布局 | `YSplitPane` | YSS layout | required | 统一主从页面与容器高度 |
 | 文件导入 | `YFileImport` | Upload/业务适配 | required | 使用 YSS 上传结果和表单适配 |
 | 条件构建 | `YConditionBuilder` | YSS domain component | required | 使用对应 docs/demo |