create-yss-spec 3.3.0 → 3.3.3

package/template/.qoder/skills/yss-technical-design/scripts/generate-schema.mjs

@@ -1,20 +0,0 @@
-#!/usr/bin/env node
-import { readFileSync, writeFileSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-const load = ref => JSON.parse(readFileSync(new URL(ref, import.meta.url), 'utf8'));
-const schema = load('../references/technical-design-common.schema.json');
-const branches = [
-  ['domain-driven', '../../yss-tactical-design/references/tactical-design.schema.json'],
-  ['layered-mvc', '../../yss-mvc-design/references/mvc-design.schema.json']
-];
-schema.$comment = 'Generated by scripts/generate-schema.mjs from common and specialist schemas. Do not hand-edit.';
-schema.allOf = branches.map(([family, ref]) => {
-  const branch = load(ref); delete branch.$id; delete branch.$schema;
-  return { if: { properties: { architecture: { properties: { family: { const: family } } } } }, then: { properties: { design: branch } } };
-});
-const output = fileURLToPath(new URL('../references/technical-design.schema.json', import.meta.url));
-const bytes = `${JSON.stringify(schema, null, 2)}\n`;
-if (process.argv.includes('--check')) {
-  if (readFileSync(output, 'utf8') !== bytes) throw new Error('技术设计 Schema 投影漂移，请运行 generate-schema.mjs');
-} else writeFileSync(output, bytes);
-process.stdout.write('技术设计分支 Schema 已同步\n');

package/template/.qoder/skills/yss-technical-design/scripts/validate-technical-design.mjs

@@ -1,134 +0,0 @@
-#!/usr/bin/env node
-import { readFileSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
-import { parseArgs } from 'node:util';
-import { assertScaffoldUserDecision } from '../../../../scripts/lib/user-decision.mjs';
-import { validateJsonSchema } from '../../../../scripts/lib/json-schema.mjs';
-import { read, safe, hash, digest, ensure } from '../../../../scripts/lib/strategic-handoff-io.mjs';
-import { validate as validateDdd } from '../../yss-tactical-design/scripts/validate-tactical-design.mjs';
-import { designTargets } from '../../../../scripts/lib/strategic-handoff-design-targets.mjs';
-import { verifyConsumption } from '../../../../scripts/lib/strategic-handoff-consumption.mjs';
-
-const schema = fileURLToPath(new URL('../references/technical-design.schema.json', import.meta.url));
-const text = x => typeof x === 'string' && x.trim().length > 0;
-const nonempty = xs => Array.isArray(xs) && xs.length > 0 && xs.every(text);
-export const technicalDigest = data => digest(Object.fromEntries(Object.entries(data).filter(([key]) => key !== 'digest')));
-
-
-function validateMvc(design) {
-  const modules = new Map(design.module_catalog.map(item => [item.module_id, item]));
-  const cases = new Map(design.use_case_catalog.map(item => [item.use_case_id, item]));
-  const rules = new Set(design.rule_catalog.map(item => item.rule_id));
-  const permitted = {
-    server: ['service','core','client'], service: ['repository','adapter'], core: ['repository','adapter'],
-    repository: [], adapter: ['client','feign-client'], client: [], 'feign-client': ['client']
-  };
-  for (const module of modules.values()) for (const ref of module.depends_on) {
-    ensure(modules.has(ref) && permitted[module.layer].includes(modules.get(ref).layer), `模块依赖越界: ${module.module_id} -> ${ref}`);
-  }
-  for (const item of cases.values()) {
-    ensure(['service','core'].includes(modules.get(item.module_ref)?.layer), `用例必须属于 service/core: ${item.use_case_id}`);
-    ensure(item.rule_refs.every(ref => rules.has(ref)), `用例引用未声明规则: ${item.use_case_id}`);
-  }
-  for (const rule of design.rule_catalog) ensure(rule.use_case_refs.every(ref => cases.has(ref) && cases.get(ref).rule_refs.includes(rule.rule_id)), `规则与用例未双向关联: ${rule.rule_id}`);
-  for (const item of design.state_transition_catalog) ensure(cases.has(item.use_case_ref), '状态转换引用未声明用例');
-  if (!design.state_transition_catalog.length) ensure(text(design.state_not_applicable_reason), '无状态转换必须说明原因');
-  for (const item of design.persistence_mapping) ensure(cases.has(item.use_case_ref) && modules.get(item.repository_ref)?.layer === 'repository', '持久化映射的用例或 Repository 引用无效');
-  for (const item of design.integration_catalog) ensure(modules.get(item.adapter_ref)?.layer === 'adapter', '外部集成必须关联 Adapter');
-  if (!design.integration_catalog.length) ensure(text(design.integration_not_applicable_reason), '无外部集成必须说明原因');
-}
-
-export function verifyArchitecture(data, root) {
-  const binding = data.architecture;
-  const file = safe(root, binding.decision_ref);
-  ensure(hash(readFileSync(file)) === binding.decision_digest, '架构来源摘要漂移');
-  const record = read(file);
-  if (binding.source_kind === 'scaffold-decision') {
-    const decision = record.decisions?.find(item => item.project_id === binding.project_id);
-    ensure(record.status === 'current' && record.template === false, '架构选择记录必须为当前正式记录');
-    ensure(decision && ['user-confirmed','lifecycle-approved','consumed'].includes(decision.status), '分支设计前必须确认项目架构');
-    ensure(decision.confirmed_architecture === binding.family, '技术设计与确认架构不匹配');
-    ensure(text(decision.user_confirmation?.confirmation_ref) && text(decision.user_confirmation?.confirmed_by), '缺少真实架构确认引用');
-    assertScaffoldUserDecision(decision, { root });
-  } else {
-    // Registration formats differ by repository; bind the actual registered identity,
-    // never infer architecture from a directory or a design's self-declaration.
-    const entry = record.repositories?.find(item => item.project_id === binding.project_id) ?? record;
-    ensure(entry.project_id === binding.project_id && entry.architecture_identity?.architecture_family === binding.family, '技术设计与既有工程登记架构不匹配');
-    ensure(!['stale','blocked'].includes(record.status) && !['stale','blocked'].includes(entry.status), '工程登记已失效');
-  }
-}
-
-function validateLocalTraceability(data, root, sliceRef) {
-  const { ids, seams } = designTargets(data);
-  const sources = new Map(data.source_items.map(item => [item.source_id, item]));
-  ensure(sources.size === data.source_items.length, '源规则或场景 ID 重复');
-  const rows = new Map(data.traceability.map(item => [item.source_id, item]));
-  ensure(rows.size === data.traceability.length, '承接记录重复');
-  ensure(data.strategic_handoff || sources.size > 0, '无战略包时必须列出需求规则与场景');
-  for (const source of sources.values()) ensure(data.inputs.some(item => item.ref === source.source_ref), '源规则或场景未绑定当前输入');
-  for (const id of rows.keys()) ensure(sources.has(id), `未知承接来源: ${id}`);
-  for (const [id, source] of sources) {
-    const row = rows.get(id);
-    ensure(row, `缺少规则或场景承接: ${id}`);
-    if (row.disposition === 'implemented') {
-      ensure(nonempty(row.tactical_refs) && row.tactical_refs.every(ref => ids.has(ref)), `设计落点悬空: ${id}`);
-      ensure(nonempty(row.test_seam_refs) && row.test_seam_refs.every(ref => seams.has(ref) && row.tactical_refs.includes(seams.get(ref).subject_ref)), `测试 seam 未关联设计落点: ${id}`);
-      if (source.kind === 'scenario' && source.critical) ensure(['success','failure'].every(outcome => row.scenario_tests?.some(test => test.outcome === outcome && row.test_seam_refs.includes(test.seam_ref))), `关键场景缺少成功/失败测试: ${id}`);
-      ensure(nonempty(row.evidence_refs), `缺少承接证据: ${id}`);
-    } else if (row.disposition === 'not-applicable') {
-      ensure(text(row.reason) && nonempty(row.evidence_refs), `不适用缺少依据: ${id}`);
-    } else {
-      if (row.disposition === 'deferred') for (const key of ['reason','risk','owner','followup_ticket_ref','verification_plan','target_version']) ensure(text(row[key]), `延期缺少 ${key}: ${id}`);
-      ensure(sliceRef && row.dependency_status === 'known' && nonempty(row.dependent_slice_refs) && !row.dependent_slice_refs.includes(sliceRef), `未闭合承接阻断当前范围: ${id}`);
-    }
-    for (const ref of row.evidence_refs || []) safe(root, ref);
-  }
-}
-
-export async function validateTechnicalDesign(data, { root = process.cwd(), sliceRef, legacyDdd = false } = {}) {
-  if (data?.schema_version === 1) {
-    ensure(legacyDdd, '旧 v1 合同需要显式 --legacy-ddd，仅按 DDD 兼容读取');
-    const errors = validateDdd(data);
-    ensure(!errors.length, errors.join('; '));
-    if (sliceRef) ensure(data.status === 'approved', '切片只能消费 approved 设计');
-    if (data.strategic_handoff || data.strategic_context_import_ref || data.upstream_impact?.source_kind === 'strategic-handoff') {
-      const result = await verifyConsumption(data, { root, sliceRef });
-      ensure(result.result === 'verified', JSON.stringify(result));
-    }
-    return { result: 'legacy-ddd-read-only', architecture_family: 'domain-driven', status: data.status };
-  }
-  validateJsonSchema(data, schema, { label: '技术设计合同' });
-  ensure(data.digest === technicalDigest(data), '技术设计合同摘要不匹配');
-  ensure(!['stale','blocked','drift','new_impacts'].includes(data.status), '设计状态不可消费');
-  if (sliceRef) ensure(data.status === 'approved', '切片只能消费 approved 设计');
-  verifyArchitecture(data, root);
-  ensure(data.inputs.some(item => item.kind === 'context' && item.ref === 'CONTEXT.md') && data.inputs.some(item => item.kind === 'spec'), '共同输入缺少根 CONTEXT.md 或 Spec');
-  for (const input of data.inputs) ensure(hash(readFileSync(safe(root, input.ref))) === input.digest, `输入摘要漂移: ${input.ref}`);
-  for (const ref of data.evidence_refs) safe(root, ref);
-  if (data.status === 'approved') ensure(data.evidence_refs.length > 0, '已批准设计缺少评审证据');
-  if (data.architecture.family === 'domain-driven') {
-    const errors = validateDdd(data.design);
-    ensure(!errors.length, errors.join('; '));
-    ensure(data.design.status === data.status, 'DDD 分支状态与共同合同不一致');
-    ensure(data.inputs.some(item => item.kind === 'strategic'), 'DDD 分支缺少战略领域输入');
-    ensure(!data.design.strategic_handoff && !data.design.strategic_context_import_ref, '战略绑定只允许在共同合同中维护');
-  } else validateMvc(data.design);
-  const { ids, seams } = designTargets(data);
-  for (const seam of seams.values()) ensure(ids.has(seam.subject_ref), `测试 seam 设计对象悬空: ${seam.seam_id}`);
-  validateLocalTraceability(data, root, sliceRef);
-  if (data.strategic_handoff) {
-    const result = await verifyConsumption(data, { root, sliceRef });
-    ensure(result.result === 'verified', JSON.stringify(result));
-  }
-  return { result: 'ready-for-lifecycle-review', technical_design_id: data.technical_design_id, architecture_family: data.architecture.family, status: data.status, digest: data.digest };
-}
-
-async function main() {
-  const { values, positionals } = parseArgs({ allowPositionals: true, options: { root: { type: 'string', default: process.cwd() }, slice: { type: 'string' }, 'legacy-ddd': { type: 'boolean', default: false } } });
-  ensure(positionals.length === 1, '用法: validate-technical-design.mjs <合同> --root <项目根> [--slice <ID>] [--legacy-ddd]');
-  const result = await validateTechnicalDesign(read(path.resolve(positionals[0])), { root: values.root, sliceRef: values.slice, legacyDdd: values['legacy-ddd'] });
-  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-}
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) main().catch(error => { process.stderr.write(`${JSON.stringify({ result: 'blocked', errors: [error.message] })}\n`); process.exitCode = 1; });

package/template/.qoder/skills/yss-technical-design/tests/fixtures.mjs

@@ -1,32 +0,0 @@
-import { writeFileSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-import { hash } from '../../../../scripts/lib/strategic-handoff-io.mjs';
-import { technicalDigest } from '../scripts/validate-technical-design.mjs';
-export function mvcFixture(root) {
-  const files = {
-    'CONTEXT.md': '# 业务上下文\n',
-    'spec.md': '# 需求\nrule.valid: 必填材料完整。scenario.submit: 提交成功或校验失败。\n',
-    'registration.json': JSON.stringify({ project_id: 'example', status: 'current', architecture_identity: { architecture_family: 'layered-mvc' } }),
-    'review.md': '设计评审测试证据；不构成真实批准。\n'
-  };
-  for (const [ref, bytes] of Object.entries(files)) writeFileSync(path.join(root, ref), bytes);
-  const data = {
-    schema_version: 2, technical_design_id: 'technical-design.example', version: 'v1', status: 'ready-for-human', context_ref: 'CONTEXT.md',
-    architecture: { family: 'layered-mvc', project_id: 'example', source_kind: 'existing-registration', decision_ref: 'registration.json', decision_digest: hash(readFileSync(path.join(root, 'registration.json'))) },
-    inputs: ['CONTEXT.md','spec.md'].map((ref,index) => ({ kind: index ? 'spec' : 'context', ref, version: 'v1', digest: hash(readFileSync(path.join(root,ref))) })),
-    source_items: [{ source_id: 'rule.valid', kind: 'rule', critical: false, source_ref: 'spec.md' }, { source_id: 'scenario.submit', kind: 'scenario', critical: true, source_ref: 'spec.md' }],
-    traceability: ['rule.valid','scenario.submit'].map(source_id => ({ source_id, disposition: 'implemented', tactical_refs: ['use-case.submit'], test_seam_refs: ['test-seam.success','test-seam.failure'], evidence_refs: ['spec.md'], dependency_status: 'known', dependent_slice_refs: ['slice.submit'], scenario_tests: [{ outcome: 'success', seam_ref: 'test-seam.success' }, { outcome: 'failure', seam_ref: 'test-seam.failure' }] })),
-    design: {
-      module_catalog: [{ module_id: 'module.server', layer: 'server', responsibility: 'HTTP 适配', depends_on: ['module.service'] }, { module_id: 'module.service', layer: 'service', responsibility: '提交用例和事务', depends_on: ['module.repository'] }, { module_id: 'module.repository', layer: 'repository', responsibility: '数据持久化', depends_on: [] }],
-      use_case_catalog: [{ use_case_id: 'use-case.submit', module_ref: 'module.service', flow: ['校验材料','保存申请'], rule_refs: ['rule.valid'], failure_handling: '材料不完整拒绝提交，写入失败回滚' }],
-      rule_catalog: [{ rule_id: 'rule.valid', statement: '材料必须完整', use_case_refs: ['use-case.submit'] }],
-      state_transition_catalog: [], state_not_applicable_reason: '本范围只登记申请，无状态流转',
-      consistency_policy: { transaction_boundary: '一次提交同一事务', rollback: '写入失败整体回滚', concurrency: '唯一约束拒绝竞争提交', idempotency: '请求键唯一' },
-      persistence_mapping: [{ mapping_id: 'mapping.application', use_case_ref: 'use-case.submit', repository_ref: 'module.repository', storage_model: 'application', notes: '请求键唯一' }],
-      integration_catalog: [], integration_not_applicable_reason: '无外部集成',
-      test_seams: [{ seam_id: 'test-seam.success', kind: 'service', subject_ref: 'use-case.submit', assertion: '完整材料保存成功' }, { seam_id: 'test-seam.failure', kind: 'service', subject_ref: 'use-case.submit', assertion: '缺材料时不写入' }]
-    }, evidence_refs: ['review.md']
-  };
-  data.digest = technicalDigest(data);
-  return data;
-}

package/template/.qoder/skills/yss-technical-design/tests/run-scenarios.mjs

@@ -1,82 +0,0 @@
-#!/usr/bin/env node
-import assert from 'node:assert/strict';
-import { mkdtempSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { attachScaffoldDecisionFixture } from '../../../../scripts/fixtures/user-decision/build-fixture.mjs';
-import { mvcFixture } from './fixtures.mjs';
-import { technicalDigest, validateTechnicalDesign } from '../scripts/validate-technical-design.mjs';
-import { hash, read } from '../../../../scripts/lib/strategic-handoff-io.mjs';
-import { enforceTechnicalDesign } from '../../../../scripts/lib/technical-design-boundary.mjs';
-import { compileDefaultImplementationContract, evaluateContractFreshness, loadCompilerContract } from '../../../../scripts/lib/implementation-contract-compiler.mjs';
-import { loadSkillRegistry } from '../../../../scripts/lib/skill-registry.mjs';
-const root = mkdtempSync(path.join(tmpdir(), 'yss-technical-design-'));
-let checks = 0;
-try {
-  const mvc = mvcFixture(root);
-  const validate = data => validateTechnicalDesign(data, { root });
-  assert.equal((await validate(mvc)).architecture_family, 'layered-mvc'); checks++;
-  async function rejected(change, pattern) {
-    const data = structuredClone(mvc); change(data); data.digest = technicalDigest(data);
-    await assert.rejects(() => validate(data), pattern); checks++;
-  }
-  await rejected(d => { d.architecture.family = 'mixed'; }, /not one of/);
-  await rejected(d => { d.architecture.project_id = 'wrong'; }, /登记架构不匹配/);
-  await rejected(d => { d.architecture.decision_digest = `sha256:${'0'.repeat(64)}`; }, /来源摘要漂移/);
-  await rejected(d => { d.traceability.pop(); }, /缺少规则或场景承接/);
-  await rejected(d => { d.traceability[1].scenario_tests.pop(); }, /成功\/失败测试/);
-  await rejected(d => { d.traceability[0].tactical_refs = ['aggregate.fake']; }, /设计落点悬空/);
-  await rejected(d => { d.design.module_catalog[0].depends_on = ['module.repository']; }, /模块依赖越界/);
-  await rejected(d => { d.design.consistency_policy.transaction_boundary = ''; }, /non-empty/);
-  await rejected(d => { d.design.aggregate_catalog = []; }, /Additional properties/);
-  await rejected(d => { d.design.test_seams[0].subject_ref = 'missing'; }, /设计对象悬空/);
-  await rejected(d => { d.status = 'stale'; }, /状态不可消费/);
-  await rejected(d => { d.traceability[0].disposition = 'conflict'; }, /未闭合承接/);
-  const deferred = structuredClone(mvc); deferred.status = 'approved';
-  Object.assign(deferred.traceability[0], { disposition: 'deferred', reason: '下一版', risk: '提交不可用', owner: '维护者', followup_ticket_ref: 'ticket.next', verification_plan: '回归提交', target_version: 'v2' });
-  deferred.digest = technicalDigest(deferred);
-  await assert.rejects(() => validateTechnicalDesign(deferred, { root, sliceRef: 'slice.submit' }), /未闭合承接/); checks++;
-  assert.equal((await validateTechnicalDesign(deferred, { root, sliceRef: 'slice.other' })).architecture_family, 'layered-mvc'); checks++;
-  deferred.traceability[0].dependency_status = 'unknown'; deferred.digest = technicalDigest(deferred);
-  await assert.rejects(() => validateTechnicalDesign(deferred, { root, sliceRef: 'slice.other' }), /未闭合承接/); checks++;
-  writeFileSync(path.join(root, 'spec.md'), 'changed');
-  await assert.rejects(() => validate(mvc), /输入摘要漂移/); checks++;
-  mvcFixture(root);
-  const old = read(fileURLToPath(new URL('../../yss-tactical-design/tests/fixtures/valid-tactical-design.yaml', import.meta.url)));
-  await assert.rejects(() => validate(old), /显式 --legacy-ddd/); checks++;
-  assert.equal((await validateTechnicalDesign(old, { root, legacyDdd: true })).result, 'legacy-ddd-read-only'); checks++;
-  const ddd = structuredClone(mvc); ddd.architecture.family = 'domain-driven';
-  writeFileSync(path.join(root, 'registration.json'), JSON.stringify({ project_id: 'example', status: 'current', architecture_identity: { architecture_family: 'domain-driven' } }));
-  ddd.architecture.decision_digest = hash(readFileSync(path.join(root, 'registration.json'))); ddd.design = old;
-  ddd.inputs.push({ kind: 'strategic', ref: 'spec.md', version: 'v1', digest: hash(readFileSync(path.join(root, 'spec.md'))) });
-  for (const row of ddd.traceability) Object.assign(row, { tactical_refs: [old.test_seams[0].subject_ref], test_seam_refs: [old.test_seams[0].seam_id], scenario_tests: ['success','failure'].map(outcome => ({ outcome, seam_ref: old.test_seams[0].seam_id })) });
-  ddd.digest = technicalDigest(ddd);
-  assert.equal((await validate(ddd)).architecture_family, 'domain-driven'); checks++;
-  ddd.design.aggregate_catalog[0].api_exposure = 'public'; ddd.digest = technicalDigest(ddd);
-  await assert.rejects(() => validate(ddd), /internal-only/); checks++;
-  const scaffold = mvcFixture(root);
-  const decision = attachScaffoldDecisionFixture(path.join(root, 'decision-evidence'), { project_id: 'example', status: 'user-confirmed', confirmed_architecture: 'layered-mvc', decision_inputs_digest: `sha256:${'1'.repeat(64)}`, user_confirmation: { confirmation_ref: 'user-message', confirmed_by: 'user' } });
-  const record = { status: 'current', template: false, decisions: [decision] };
-  const recordFile = path.join(root, 'decision.json');
-  writeFileSync(recordFile, JSON.stringify(record));
-  scaffold.architecture = { ...scaffold.architecture, source_kind: 'scaffold-decision', decision_ref: 'decision.json', decision_digest: hash(readFileSync(recordFile)) }; scaffold.digest = technicalDigest(scaffold);
-  assert.equal((await validate(scaffold)).architecture_family, 'layered-mvc'); checks++;
-  record.decisions[0].status = 'awaiting-user-decision'; writeFileSync(recordFile, JSON.stringify(record)); scaffold.architecture.decision_digest = hash(readFileSync(recordFile)); scaffold.digest = technicalDigest(scaffold);
-  await assert.rejects(() => validate(scaffold), /分支设计前必须确认/); checks++;
-  record.decisions[0].status = 'user-confirmed'; record.decisions[0].user_confirmation.user_decision_ref = 'missing-user-decision.json'; writeFileSync(recordFile, JSON.stringify(record)); scaffold.architecture.decision_digest = hash(readFileSync(recordFile)); scaffold.digest = technicalDigest(scaffold);
-  await assert.rejects(() => validate(scaffold), /user-decision/); checks++;
-  const current = mvcFixture(root); current.status = 'approved'; current.digest = technicalDigest(current);
-  const file = path.join(root, 'design.json'); writeFileSync(file, JSON.stringify(current));
-  const technical_design = { ref: 'design.json', version: 'v1', digest: hash(readFileSync(file)) };
-  const identity = { architecture_family: 'layered-mvc', architecture_profile: 'layered-mvc-service', generator_skill: 'yss-layered-mvc-scaffold-generator', requested_capabilities: [], resolved_modules: ['server','service','repository'], verification_database: 'h2', production_database: 'not-bound', contract_digest: 'a'.repeat(64) };
-  const state = { technical_design, slice_id: 'slice.submit', architecture_identity: identity, conditions: ['backend-technical-design-impact'] };
-  enforceTechnicalDesign(state, { root }); checks++;
-  assert.throws(() => enforceTechnicalDesign({ ...state, technical_design: undefined }, { root }), /缺少已批准技术设计/); checks++;
-  assert.throws(() => enforceTechnicalDesign({ ...state, architecture_identity: { architecture_family: 'domain-driven' } }, { root }), /架构不匹配/); checks++;
-  const resolution = compileDefaultImplementationContract({ ...state, root, requiredCapabilities: ['contract.request-validation'], architecture_evidence: { engineering_baseline: identity, repository_registration: identity, manifest: identity } });
-  assert.deepEqual(resolution.technical_design, technical_design); assert(!resolution.required_skills.includes('yss-domain')); checks++;
-  writeFileSync(path.join(root, 'spec.md'), 'changed again');
-  assert.equal(evaluateContractFreshness({ schema_version: 2, resolution }, { registry: loadSkillRegistry(), compilerContract: loadCompilerContract(), root }).freshness, 'stale'); checks++;
-} finally { rmSync(root, { recursive: true, force: true }); }
-process.stdout.write(`技术设计场景通过：${checks} 项（MVC、DDD、兼容、架构、承接、切片与漂移）\n`);

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

@@ -1,172 +0,0 @@
----
-name: "yss-ui"
-description: Use when implementing or reviewing YSS Vue pages that combine YSS wrappers with Ant Design Vue, including component selection, version compatibility, layout, Formily, tables, trees, hooks, overlays, themes, accessibility, API integration, and delivery verification.
----
-
-# YSS UI 统一路由与交付门禁
-
-本技能是 YSS Vue 生产页面的统一入口。它负责组件路由、版本预检、跨组件约束和交付证据；具体组件、请求、表单和高度实现交给最小专项 skill，避免重复维护 API 细节。
-
-## 1. 权威事实顺序
-
-发生冲突时按以下顺序决策：
-
-1. 冻结的项目工程基线和批准的 Slice Implementation Contract。
-2. lockfile 中实际安装版本与 TypeScript 类型。
-3. 当前项目已通过测试的既有用法。
-4. 与安装版本匹配的 YSS UI 文档和本地快照。
-5. 与安装版本匹配的 Ant Design Vue 官方文档。
-6. 最新官网只用于发现信息，不直接作为生产 API 依据。
-
-内部文档入口见 `references/frontend-docs.md`。Ant Design Vue 组件概览是底层补充资料，不得越过 YSS 组件映射和项目基线。
-
-## 2. 执行前版本预检
-
-采用专职前端 profile 或显式 `frontend_delivery` 绑定时，先按 `docs/process/frontend-backend-delivery.md` 实际核验战略与后端联合交付。缺任一输入只能诊断和回交；输入通过后准备计划/合同，正式实现、生成和恢复仍须当前批准的 Slice Contract 冻结接收摘要。接口或部署版本漂移时重新接收，不复用旧成功输出。
-
-进入实现前从前端工程根目录执行：
-
-```bash
-pnpm why vue @yss-ui/components @yss-ui/hooks ant-design-vue vxe-table
-```
-
-记录实际版本、lockfile、验证命令和环境阻塞。完整策略见 `references/antdv-compatibility.md`。
-
-产品设计使用的 Antdv Next 或 Ant Design v6 视觉/token 语义，不等于 Vue 生产实现 API。生产代码必须使用项目安装的 Ant Design Vue 4.x API，禁止把原型 props、events、slots、hook 或组件写法当作生产合同。`yss-antdv-next-design` 只用于默认 H2 Vue 原型，`yss-antd-design` 只用于显式 React 兼容原型；原型阶段不得调用本技能。只有进入前端实现计划、已批准切片的生产实现或实现还原验证后，才从目标 lockfile、类型、本地文档和既有用法取得真实组件事实。
-
-## 3. 组件选型门禁
-
-决策顺序：
-
-1. 查询 `references/component-routing.md`。
-2. YSS 标记为 `required` 的封装必须使用 `@yss-ui/components`。
-3. YSS 未封装时才允许直接使用 `ant-design-vue`。
-4. YSS 封装缺少必要能力时，可以受控回退，但必须记录能力缺口、依赖版本和验证证据。
-5. 禁止引入其他重型表格、树或表单方案绕过 YSS。
-
-典型强制路由：
-
-- `YTable` 替代 AntDV `Table`，列使用 `field/type` 和字段同名插槽。
-- `YTree` 替代 AntDV `Tree`。
-- `YFormily` 是新代码 canonical name；`YssFormily` 仅作为已确认导出的历史兼容 alias。
-- `YSplitPane`、`YButton`、`YCard` 等已有封装优先使用 YSS。
-
-## 4. 最小专项 skill 路由
-
-| 任务 | 必须路由 |
-|---|---|
-| 新建或改造完整业务页面 | `yss-ui-business-page-generation` |
-| 页面布局、组件和交互 | `yss-components` |
-| 请求、分页、参数、树数据映射 | `yss-hook` |
-| Formily schema、联动、校验、详情态 | `yss-formily` |
-| 表格高度 | `yss-use-table-height` |
-| 树高度 | `yss-use-tree-height` |
-| Orval、API、useRequest 接入 | `yss-api-integration` |
-| 视觉、token、响应式体验 | `yss-design-system` |
-
-不得引用不存在的复数 Hook skill 名称。
-
-## 5. 页面职责边界
-
-```text
-views/PageName/
-  components/
-  hooks/
-  schemas/
-  index.vue
-  style.less
-```
-
-- `index.vue` 只做页面编排和事件转发。
-- `components/` 承载区块展示和局部交互。
-- `hooks/` 承载请求、分页、参数单一来源、映射和错误兜底。
-- `schemas/` 承载 `YFormily` schema。
-- 页面内禁止复制请求流程、分页状态和复杂字段转换。
-
-## 6. 跨组件强制约束
-
-### 数据与状态
-
-- 列表查询统一维护 `currentParams`；新查询回到第一页，翻页保留筛选条件。
-- 页面至少处理 `loading`、`empty`、`error`、`disabled/no-access` 和依赖上下文的 `selected` 状态。
-- 成功和失败均需反馈与数据兜底。
-- OpenAPI 未冻结时不得把生成客户端当作稳定契约。
-
-### 主题、locale 与浮层
-
-- 主题、暗色和紧凑模式通过项目 `ConfigProvider`、YSS theme 或语义 token 实现。
-- 禁止页面级硬编码主题色、任意 z-index 或自行反转暗色。
-- locale、时区、日期库和金额/日期格式化由项目统一配置。
-- Modal、Drawer、Dropdown、Tooltip、Select 等遵循项目 popup container、Teleport 和微应用根节点策略。
-
-详细规则见 `references/theme-locale-overlay.md`。
-
-### 可访问性与性能
-
-- 图标按钮提供可访问名称，状态不得只依赖颜色。
-- Modal/Drawer 处理焦点进入、捕获和关闭后的恢复。
-- Table/Tree 大数据量使用项目已验证的虚拟化能力。
-- 远程搜索节流或防抖，复杂组件按需加载。
-- 窄屏明确布局降级、横向滚动和操作收敛策略。
-
-详见 `references/accessibility.md`。
-
-## 7. AntDV 受控回退记录
-
-直接使用 AntDV 时，实施记录至少包含：
-
-```yaml
-component: Select
-yss_wrapper: none
-fallback_reason: YSS 当前无独立 Select 封装
-antdv_version: 4.x.x
-theme_locale_overlay_checked: true
-verification: pnpm type-check
-```
-
-`message`、`notification`、Modal 等服务式 API 仍需确认是否通过项目 `App` / `ConfigProvider` 获取上下文。
-
-## 8. 实施顺序
-
-1. 读取批准合同、项目版本和组件映射。
-2. 选择最小专项 skills。
-3. 搭页面目录和布局。
-4. 接 `YFormily`、`YTable`、`YTree` 等 YSS 主体组件。
-5. 下沉请求、分页和映射到 `yss-hook`。
-6. 接高度、主题、locale、浮层和无障碍约束。
-7. 联调冻结 API、Mock、路由和权限。
-8. 按 `references/verification.md` 完成分层验证。
-
-## 9. 最小验收
-
-- [ ] 已记录 Vue、YSS UI、AntDV、VXE 实际版本。
-- [ ] 组件选型符合 `component-routing.md`，回退有证据。
-- [ ] 新代码使用 `YFormily` 和真实存在的 `yss-hook`。
-- [ ] YTable/YTree/Formily/高度 Hook 遵循专项 skill。
-- [ ] 主题、locale、浮层容器和微应用隔离已检查。
-- [ ] loading/empty/error/no-access/selected 状态按影响面覆盖。
-- [ ] 键盘、焦点、标签和颜色对比度已检查。
-- [ ] 已执行 lint、type-check、组件测试及必要的 E2E/视觉回归。
-- [ ] 未执行项记录 `not-applicable` 或环境阻塞原因。
-- [ ] 返回 YSS Skill Execution Result 所需 changed/evidence/verification 信息。
-
-## 10. 按需读取
-
-- 组件路由：`references/component-routing.md`
-- 版本兼容：`references/antdv-compatibility.md`
-- 主题/locale/浮层：`references/theme-locale-overlay.md`
-- 可访问性与性能：`references/accessibility.md`
-- 验证：`references/verification.md`
-- AntDV 迁移与 Demo 审计：`references/migration-antdv-to-yss.md`
-- 快速范例：`references/quick-recipes.md`
-- 交付清单：`references/checklist.md`
-- 本地文档与 Demo 索引：`assets/reference-index.md`、`assets/scenario-index.md`、`assets/keyword-index.md`
-
-## 11. 禁止项
-
-- 禁止根据 AntDV 最新官网直接覆盖项目已安装版本事实。
-- 禁止在已有 YSS required wrapper 时直接使用底层同类组件。
-- 禁止把 React Ant Design v6 API 写入 Vue 生产代码。
-- 禁止引用不存在的 skill、未验证 Demo 或未冻结 API 契约。
-- 禁止省略错误、权限、空态、焦点和验证证据。
-- 禁止在原型阶段调用本技能，或用生产组件实现冒充原型资产。

package/template/.qoder/skills/yss-ui/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS UI"
-  short_description: "YSS 页面、组件、Hook 与 API 一体化规范"
-  default_prompt: "Use $yss-ui to build a YSS page with standard layout, query form, table, tree, hooks, and API integration."

package/template/.qoder/skills/yss-ui/assets/demos/button/auth-basic.vue

@@ -1,24 +0,0 @@
-<template>
-  <div style="display: flex; gap: 12px; align-items: center">
-    <YButton permission-code="r_security-m_security_datamask-b_datamask_add" type="primary" @click="log('add')">
-      新建
-    </YButton>
-    <YButton
-      permission-code="r_1security-m_security_classification-b_classification_add"
-      :fallback="'disable'"
-      @click="log('edit')"
-    >
-      编辑（无权限禁用）
-    </YButton>
-    <YButton @click="log('normal')">普通按钮（无校验）</YButton>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { YButton } from '@yss-ui/components';
-
-const log = (msg: string) => console.log('[auth-basic]', msg);
-
-// 在浏览器控制台可手动模拟：
-// localStorage.setItem('auth_btns', JSON.stringify([{ btnCode:'USER_ADD', btnName:'新建' }]))
-</script>

package/template/.qoder/skills/yss-ui/assets/demos/button/auth-dropdown.vue

@@ -1,29 +0,0 @@
-<template>
-  <div style="display: flex; gap: 12px; align-items: center">
-    <!--  permissionCode="r_security-m_security_level-b_securitylevel_edit" -->
-    <!-- 当给AuthorityDropdown 组件传入permissionCode时，如果无权限，则不显示 -->
-    <AuthorityDropdown :dropdown-items="items" :options="{ label: 'text', value: 'id' }" @command="onCmd">
-      更多操作
-    </AuthorityDropdown>
-  </div>
-</template>
-
-<script setup lang="ts">
-import { AuthorityDropdown } from '@yss-ui/components';
-
-const items = [
-  { text: '查看', id: 'view' },
-  { text: '编辑', id: 'edit', permissionCode: 'r_security-m_security_datamask-b_datamask_edit' },
-  { text: '删除', id: 'delete', permissionCode: 'DELETE' },
-];
-
-const onCmd = (rec: any) => {
-  console.log('[auth-dropdown]', rec);
-};
-
-// 模拟权限：
-// localStorage.setItem('auth_btns', JSON.stringify([
-//   { btnCode:'r_security-m_security_level-b_securitylevel_edit', btnName:'更多操作' },
-//   { btnCode:'r_security-m_security_datamask-b_datamask_edit', btnName:'编辑' }
-// ]))
-</script>

package/template/.qoder/skills/yss-ui/assets/demos/button/permission.vue

@@ -1,10 +0,0 @@
-<script setup lang="ts">
-import { YButton } from '@yss-ui/components';
-</script>
-
-<template>
-  <div style="display: flex; gap: 12px; align-items: center">
-    <YButton permission-code="USER_ADD" type="primary">新建</YButton>
-    <YButton permission-code="USER_EDIT" :fallback="'disable'">编辑（无权限禁用）</YButton>
-  </div>
-</template>

package/template/.qoder/skills/yss-ui/assets/demos/button/size.vue

@@ -1,12 +0,0 @@
-<script setup lang="ts">
-import { YButton } from '@yss-ui/components';
-</script>
-
-<template>
-  <div style="display: flex; gap: 12px; align-items: center">
-    <YButton size="small">Small</YButton>
-    <YButton size="middle">Middle</YButton>
-    <YButton size="large">Large</YButton>
-    <YButton block>Block（铺满）</YButton>
-  </div>
-</template>

package/template/.qoder/skills/yss-ui/assets/demos/button/states.vue

@@ -1,12 +0,0 @@
-<script setup lang="ts">
-import { YButton } from '@yss-ui/components';
-</script>
-
-<template>
-  <div style="display: flex; gap: 12px; align-items: center">
-    <YButton type="primary" loading>加载中</YButton>
-    <YButton disabled>禁用</YButton>
-    <YButton ghost type="primary">幽灵</YButton>
-    <YButton danger type="primary">危险</YButton>
-  </div>
-</template>

package/template/.qoder/skills/yss-ui/assets/demos/card/basic/index.vue

@@ -1,54 +0,0 @@
-<script setup lang="ts">
-import { YCard } from '@yss-ui/components';
-import './style.less';
-</script>
-
-<template>
-  <div class="basic-demo">
-    <div class="cards-grid">
-      <!-- 1. 基础卡片 -->
-      <YCard title="基础卡片">
-        <p>这是一个基础的卡片组件，使用默认的样式和配置。</p>
-        <p>内容区域使用默认的内边距（16px）。</p>
-      </YCard>
-
-      <!-- 2. 自定义 padding -->
-      <YCard title="自定义 Padding" :padding="32">
-        <p>这个卡片使用了自定义的 padding 属性。</p>
-        <p>padding 设置为 32px，内容区域有更大的内边距。</p>
-      </YCard>
-
-      <!-- 3. 标题插槽 -->
-      <YCard>
-        <template #title>
-          <span style="color: var(--primary-color, #1890ff); font-weight: 600"> 标题插槽 </span>
-        </template>
-        <p>这个卡片使用了标题插槽，可以自定义标题的样式和内容。</p>
-        <p>标题使用了自定义颜色和字体粗细。</p>
-      </YCard>
-
-      <!-- 4. 自定义 customStyle 样式 -->
-      <YCard
-        title="自定义 Style"
-        :custom-style="{
-          background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
-          color: '#fff',
-          border: 'none',
-        }"
-      >
-        <p style="color: rgb(255 255 255 / 90%)">这个卡片使用了 customStyle 属性，直接设置样式对象。</p>
-        <p style="color: rgb(255 255 255 / 90%)">可以设置背景、颜色、边框等任何 CSS 样式。</p>
-      </YCard>
-
-      <!-- 5. 自定义 className 样式 -->
-      <YCard title="自定义 ClassName" class-name="custom-card-style">
-        <p>这个卡片使用了 className 属性，通过 CSS 类名来定制样式。</p>
-        <p>适合需要复用样式或使用主题变量的场景。</p>
-      </YCard>
-    </div>
-  </div>
-</template>
-
-<style scoped lang="less">
-@import url('./style.less');
-</style>