create-yss-spec 2.2.7 → 2.2.9

package/template/docs/user-guide//347/224/250/346/210/267/346/211/213/345/206/214/347/264/242/345/274/225.md

@@ -1,31 +1,21 @@
-# 使用手册
+# 用户手册索引
 
-本文档面向使用本模板初始化项目的开发者、产品/架构协作者和 AI Agent 操作者。
+这里集中放置 YSS 模板和生命周期的入门手册。第一次使用时，先看总览，再进入与你当前工作阶段对应的子项目手册。
 
-## 当前范围
+## 推荐阅读顺序
 
-本模板提供文档骨架、契约模板、项目级 Agent skills 和协作约定。
+1. [YSS 用户手册](./用户手册.md)：了解仓库身份、生命周期主链和 Agent 使用模式。
+2. [战略设计子项目用户手册](../../submodules/yss-strategic-design-harness/docs/user-guide/战略设计子项目用户手册.md)：从模糊想法形成 Strategic Design Handoff。
+3. [战术设计子项目用户手册](./战术设计子项目用户手册.md)：把交接包细化为 Tactical Design，供研发实现和评审。
 
-## 推荐流程
+## 按任务查找
 
-1. 在 `docs/.scratch/<feature>/discovery/` 记录机会探索、市场、竞品和用户洞察。
-2. 在 `docs/.scratch/<feature>/spec.md` 维护 Spec、用户故事和验收标准。
-3. 在 `docs/.scratch/<feature>/design/` 维护页面、原型、用户流和交互状态。
-4. 在 `docs/.scratch/<feature>/api/` 维护 OpenAPI 3.1 契约。
-5. 在 `docs/.scratch/<feature>/architecture/` 和 `docs/adr/` 记录业务架构、功能架构、系统总体架构、数据架构和架构决策。
-6. 在 `docs/.scratch/<feature>/verification/` 维护测试策略和质量要求。
-7. 使用项目自己的 CI、harness 或人工流程推进开发、审查、发布和复盘。
+| 你现在要做什么 | 推荐手册 |
+|---|---|
+| 创建、接管或更新 YSS 项目 | [YSS 用户手册](./用户手册.md) |
+| 澄清需求、确定用户和范围 | [战略设计子项目用户手册](../../submodules/yss-strategic-design-harness/docs/user-guide/战略设计子项目用户手册.md) |
+| 设计聚合、状态、不变量和领域事件 | [战术设计子项目用户手册](./战术设计子项目用户手册.md) |
+| 了解完整生命周期和阶段门禁 | [产品生命周期工作流](../../submodules/yss-strategic-design-harness/docs/user-guide/产品生命周期工作流.md) |
+| 查找长期协作习惯和反模式 | [生命周期最佳实践](../../submodules/yss-strategic-design-harness/docs/user-guide/生命周期最佳实践.md) |
 
-## 继续阅读
-
-- [create-yss-spec 外部 CLI 实践指南](./外部命令行工具实践指南.md)
-- [产品全生命周期使用手册](./产品生命周期工作流.md)
-- [全生命周期最佳实践](./生命周期最佳实践.md)
-- [产品研发全生命周期最佳实践](./产品研发全生命周期最佳实践.md)
-- [grill-with-docs 使用手册](./需求澄清指南.md)
-- [grill-with-docs 最佳实践](./需求澄清最佳实践.md)
-- [Excalidraw Diagram Generator 使用手册](./图示生成器使用指南.md)
-- [PDCA × Scrum](../process/PDCA-SCRUM.md)
-- [Matt Pocock Engineering Skills](../process/MATT-POCOCK-ENGINEERING-SKILLS.md)
-- [架构设计](../architecture/README.md)
-- [测试策略](../testing/README.md)
+> 本仓库是 `template-source`。手册中的业务名称和示例只用于教学；真实产品资料应在 `project-instance` 中建立，并遵守对应的生命周期门禁。

package/template/scripts/lib/digital-human-roles.mjs

@@ -12,7 +12,6 @@ const RUNTIME_ID = /^runtime\.[a-z0-9][a-z0-9-]*$/;
 const REQUIRED_ROLES = [
   "role.requirements-manager",
   "role.product-manager",
-  "role.business",
   "role.project-manager",
   "role.frontend-engineer",
   "role.backend-engineer",

package/template/scripts/lib/maintenance-intensity.mjs

@@ -11,13 +11,13 @@ const INTENSITY_POLICY = path.join(root, "docs/process/maintenance-intensity.yam
 const REQUIRED_EVIDENCE = {
   L1: ["relevant-check"],
   L2: ["counterexample", "fresh-verification", "focused-independent-review"],
-  L3: ["red", "green", "refactor", "pressure-scenario", "fresh-verification", "formal-independent-review"]
+  L3: ["fresh-verification", "self-check"]
 };
 
 const REVIEW_MODES = {
   L1: new Set(["self-check", "human-checkpoint"]),
   L2: new Set(["focused-independent"]),
-  L3: new Set(["formal-independent"])
+  L3: new Set(["self-check", "formal-independent"])
 };
 
 function ensure(condition, message) {
@@ -87,9 +87,13 @@ export function validateMaintenanceCheckpoint(data, options = {}) {
     }
     kinds.add(evidence.kind);
   }
-  const reviewKind = data.intensity === "L2" ? "focused-independent-review" : data.intensity === "L3" ? "formal-independent-review" : null;
+  const legacyFormalL3 = data.intensity === "L3" && data.review_mode === "formal-independent";
+  const reviewKind = data.intensity === "L2" ? "focused-independent-review" : data.intensity === "L3" ? (legacyFormalL3 ? "formal-independent-review" : "self-check") : null;
   if (data.schema_version === 2) validateCheckpointState(data, kinds, reviewKind);
-  for (const required of REQUIRED_EVIDENCE[data.intensity]) {
+  const requiredEvidence = legacyFormalL3
+    ? ["red", "green", "refactor", "pressure-scenario", "fresh-verification", "formal-independent-review"]
+    : REQUIRED_EVIDENCE[data.intensity];
+  for (const required of requiredEvidence) {
     const pendingByV2State = data.schema_version === 2 && data.current_state !== "release-ready" && required === reviewKind;
     if ((options.allowPendingReview === true || pendingByV2State) && required === reviewKind) continue;
     ensure(kinds.has(required), `${data.intensity} 缺少 ${required} 证据`);
@@ -118,14 +122,24 @@ function validateCheckpointState(data, evidenceKinds, reviewKind) {
     return;
   }
 
-  ensure(data.candidate_digest !== null, `${data.current_state} 必须绑定 candidate_digest`);
-  ensure(data.review_round >= 1, `${data.current_state} 的 review_round 必须为 1 或 2`);
-  for (const required of ["candidate-verification", "initial-release-verification", "review-task-packages"]) {
-    ensure(evidenceKinds.has(required), `${data.current_state} 缺少 ${required} 证据`);
+  const selfCheckL3 = data.intensity === "L3" && data.review_mode === "self-check";
+  if (!selfCheckL3) {
+    ensure(data.candidate_digest !== null, `${data.current_state} 必须绑定 candidate_digest`);
+    ensure(data.review_round >= 1, `${data.current_state} 的 review_round 必须为 1 或 2`);
+    for (const required of ["candidate-verification", "initial-release-verification", "review-task-packages"]) {
+      ensure(evidenceKinds.has(required), `${data.current_state} 缺少 ${required} 证据`);
+    }
+    validateReleaseVerificationCommand(data, "initial-release-verification");
+  } else {
+    ensure(data.review_round === 0, "L3 self-check 不需要审查轮次");
+    ensure(data.candidate_digest === null, "L3 self-check 不得冻结 candidate_digest");
   }
-  validateReleaseVerificationCommand(data, "initial-release-verification");
   if (data.current_state === "review-ready") {
-    ensure(data.verification_profile === "candidate", "review-ready 必须使用 candidate profile");
+    if (selfCheckL3) {
+      ensure(data.verification_profile === "fast", "L3 self-check 的 review-ready 必须使用 fast profile");
+    } else {
+      ensure(data.verification_profile === "candidate", "review-ready 必须使用 candidate profile");
+    }
     return;
   }
   if (data.current_state === "needs-human") {

package/template/scripts/lib/skill-governance.mjs

@@ -38,6 +38,25 @@ export function validateSkillGovernance({ read = (relative) => readFileSync(path
   if (exists(".agents/skills/high-fidelity-html-prototype") || aliases.has("high-fidelity-html-prototype")) {
     fail("high-fidelity-html-prototype 已退役，不得保留物理目录或运行时 alias");
   }
+  const prototypeStage = read(".agents/skills/yss-prototype-stage/SKILL.md");
+  const prototypeAdapter = read(".agents/skills/yss-prototype-stage/references/product-design-adapter.md");
+  const prototypeEvidence = read("docs/design/templates/prototype-evidence-template.yaml");
+  const projectDesign = read("docs/design/design.md");
+  const antdvCompatibility = read(".agents/skills/yss-ui/references/antdv-compatibility.md");
+  for (const marker of ["product-design-adapter.md", "schema v2", "ant-design-v6", "ant-design-vue-4.x", "accessibility_verification"]) {
+    if (!prototypeStage.includes(marker)) fail(`原型阶段合同缺少 YSS adapter 标记: ${marker}`);
+  }
+  for (const marker of ["antd@6.x", "pnpm", "ConfigProvider", "visual_semantic_mapping", "react_only_api_not_copied", "1440x900", "390x844", "verification/design-qa.md"]) {
+    if (!prototypeAdapter.includes(marker)) fail(`Product Design adapter 缺少执行约束: ${marker}`);
+  }
+  for (const marker of ["schema_version: 2", "design_standard: ant-design-v6", "runtime_component_library: ant-design-vue-4.x", "actual_antd_version", "visual_semantic_mapping", "accessibility_verification", "verification/design-qa.md"]) {
+    if (!prototypeEvidence.includes(marker)) fail(`原型证据模板缺少 schema v2 字段: ${marker}`);
+  }
+  if (prototypeEvidence.includes("与官方 #1677ff / Inter / 8px")) fail("原型证据模板仍把 Inter/8px 误写为官方 v6 默认差异");
+  if (projectDesign.includes("`antdv6-design.md`")) fail("design.md 仍引用不存在的 antdv6-design.md");
+  for (const marker of ["Ant Design v6", "Ant Design Vue 4.x", "版本号不同本身不是冲突", "visual_semantic_mapping"]) {
+    if (!antdvCompatibility.includes(marker)) fail(`AntDV 兼容策略缺少双轨边界: ${marker}`);
+  }
   for (const skill of registry.skills) {
     if (!canonicalIds.has(skill.id)) fail(`注册表 canonical skill 无效: ${skill.id}`);
     if (skill.maturity === "deprecated") {

package/template/scripts/lib/skill-registry.mjs

@@ -9,6 +9,7 @@ const ROUTER_CONTRACT = path.join(ROOT, ".agents/skills/yss-router/references/ro
 const LIFECYCLE_CONTRACT = path.join(ROOT, ".agents/skills/yss-product-lifecycle/references/orchestration-contract.yaml");
 const LAYERS = new Set(["core", "specialist", "compatibility", "maintainer-only"]);
 const MATURITIES = new Set(["draft", "verified", "supported", "deprecated"]);
+const INVOCATION_MODES = new Set(["user", "model", "both"]);
 const ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
 const PLATFORM_ALIAS_PATTERN = /^[a-z0-9][a-z0-9-]*(?::[a-z0-9][a-z0-9-]*)?$/;
 
@@ -51,6 +52,74 @@ function requireObject(value, field) {
   if (!value || typeof value !== "object" || Array.isArray(value)) fail(`${field} 必须是对象`);
 }
 
+function requireStringArray(value, field, { nonEmpty = false } = {}) {
+  if (!Array.isArray(value) || (nonEmpty && value.length === 0) || value.some((item) => typeof item !== "string" || !item.trim())) {
+    fail(`${field} 必须是${nonEmpty ? "非空" : ""}字符串数组`);
+  }
+}
+
+function validateInvocationContract(registry, skill) {
+  const contract = registry.invocation_contract;
+  requireObject(contract, "invocation_contract");
+  if (contract.schema_version !== 1) fail("invocation_contract.schema_version 必须为 1");
+  if (contract.scope !== "routing-and-dependencies-only") fail("invocation_contract.scope 必须限定为 routing-and-dependencies-only");
+  requireStringArray(contract.required_fields, "invocation_contract.required_fields", { nonEmpty: true });
+  const expected = ["invocation_mode", "trigger_conditions", "exclusion_conditions", "primary_output", "required_dependencies", "optional_dependencies"];
+  if (JSON.stringify(contract.required_fields) !== JSON.stringify(expected)) fail("invocation_contract.required_fields 顺序或字段不完整");
+  requireStringArray(contract.allowed_invocation_modes, "invocation_contract.allowed_invocation_modes", { nonEmpty: true });
+  if (![...INVOCATION_MODES].every((mode) => contract.allowed_invocation_modes.includes(mode))) {
+    fail("invocation_contract.allowed_invocation_modes 必须包含 user、model、both");
+  }
+  if (contract.trigger_source !== "impacts" || contract.trigger_encoding !== "impact:<impact>") {
+    fail("invocation_contract 必须从 impacts 生成 impact:<impact> 触发条件");
+  }
+  requireObject(contract.default, "invocation_contract.default");
+  requireObject(contract.layer_defaults, "invocation_contract.layer_defaults");
+  requireObject(contract.overrides, "invocation_contract.overrides");
+  for (const layer of LAYERS) {
+    const layerDefault = contract.layer_defaults[layer];
+    requireObject(layerDefault, `invocation_contract.layer_defaults.${layer}`);
+    if (!INVOCATION_MODES.has(layerDefault.invocation_mode)) fail(`${layer} 的 invocation_mode 无效`);
+    requireString(layerDefault.primary_output, `invocation_contract.layer_defaults.${layer}.primary_output`);
+  }
+  const defaultMode = contract.default.invocation_mode;
+  if (!INVOCATION_MODES.has(defaultMode)) fail("invocation_contract.default.invocation_mode 无效");
+  requireStringArray(contract.default.trigger_conditions, "invocation_contract.default.trigger_conditions", { nonEmpty: true });
+  requireStringArray(contract.default.exclusion_conditions, "invocation_contract.default.exclusion_conditions", { nonEmpty: true });
+  requireString(contract.default.primary_output, "invocation_contract.default.primary_output");
+  requireStringArray(contract.default.required_dependencies, "invocation_contract.default.required_dependencies");
+  requireStringArray(contract.default.optional_dependencies, "invocation_contract.default.optional_dependencies");
+  for (const [skillId, override] of Object.entries(contract.overrides)) {
+    requireObject(override, `invocation_contract.overrides.${skillId}`);
+    if (!ID_PATTERN.test(skillId)) fail(`invocation_contract.overrides id 非法: ${skillId}`);
+    if (override.invocation_mode && !INVOCATION_MODES.has(override.invocation_mode)) fail(`${skillId}.invocation_mode 无效`);
+    if (override.trigger_conditions) requireStringArray(override.trigger_conditions, `${skillId}.trigger_conditions`, { nonEmpty: true });
+    if (override.exclusion_conditions) requireStringArray(override.exclusion_conditions, `${skillId}.exclusion_conditions`, { nonEmpty: true });
+    if (override.primary_output) requireString(override.primary_output, `${skillId}.primary_output`);
+    if (override.required_dependencies) requireStringArray(override.required_dependencies, `${skillId}.required_dependencies`);
+    if (override.optional_dependencies) requireStringArray(override.optional_dependencies, `${skillId}.optional_dependencies`);
+  }
+  const overrideIds = Object.keys(contract.overrides);
+  const knownIds = new Set(registry.skills.map((item) => item?.id).filter(Boolean));
+  for (const skillId of overrideIds) if (!knownIds.has(skillId)) fail(`invocation_contract.overrides 引用了未登记技能: ${skillId}`);
+  const effective = {
+    ...contract.default,
+    ...contract.layer_defaults[skill.layer],
+    ...(contract.overrides[skill.id] ?? {})
+  };
+  effective.trigger_conditions = [...new Set([...(effective.trigger_conditions ?? []), ...skill.impacts.map((impact) => `impact:${impact}`)])];
+  if (!INVOCATION_MODES.has(effective.invocation_mode)) fail(`${skill.id}.invocation_mode 无效`);
+  requireStringArray(effective.trigger_conditions, `${skill.id}.trigger_conditions`, { nonEmpty: true });
+  requireStringArray(effective.exclusion_conditions, `${skill.id}.exclusion_conditions`, { nonEmpty: true });
+  requireString(effective.primary_output, `${skill.id}.primary_output`);
+  requireStringArray(effective.required_dependencies, `${skill.id}.required_dependencies`);
+  requireStringArray(effective.optional_dependencies, `${skill.id}.optional_dependencies`);
+  const impactTriggers = skill.impacts.map((impact) => `impact:${impact}`);
+  if (!impactTriggers.every((trigger) => effective.trigger_conditions.includes(trigger))) {
+    fail(`${skill.id} 的调用契约必须覆盖其 impacts 触发条件`);
+  }
+}
+
 function requireStringSet(value, expected, field) {
   if (!Array.isArray(value)) fail(`${field} 必须是数组`);
   const missing = expected.filter((item) => !value.includes(item));
@@ -209,6 +278,7 @@ export function validateSkillRegistry(registry, { lock, routerContract, lifecycl
     if (!Array.isArray(skill.impacts) || skill.impacts.length === 0 || skill.impacts.some((item) => typeof item !== "string" || !item.trim())) {
       fail(`${skill.id} impacts 不能为空`);
     }
+    validateInvocationContract(registry, skill);
   }
   for (const skill of skills) {
     if (skill.replaced_by && !ids.has(skill.replaced_by)) fail(`${skill.id}.replaced_by 引用了未登记技能: ${skill.replaced_by}`);

package/template/scripts/node-verify-lifecycle-registry.mjs

@@ -42,7 +42,7 @@ try {
       const ignored = run("git", ["check-ignore", "-q", relativePath]);
       if (ignored.status === 0) throw new TypeError(`权威注册表资产不得被 Git 忽略: ${relativePath}`);
     }
-    const stalePaths = ["AGENTS.md", "README.md", "docs/user-guide/产品生命周期工作流.md", ".agents/skills/yss-product-lifecycle/SKILL.md", "docs/process/lifecycle-artifact-map.md"];
+    const stalePaths = ["AGENTS.md", "README.md", "docs/user-guide/用户手册.md", ".agents/skills/yss-product-lifecycle/SKILL.md", "docs/process/lifecycle-artifact-map.md"];
     if (isTemplateSource(ROOT)) stalePaths.push(".template-source/derived/harness-work-unit-map.md");
     for (const relativePath of stalePaths) {
       if (/\d+\s*个(?:主阶段|门禁|工作单元|职责点)/.test(readFileSync(path.join(ROOT, relativePath), "utf8"))) {

package/template/scripts/verify-digital-human-roles-scenarios

@@ -54,7 +54,7 @@ const seven = [
   "role.lifecycle-orchestrator",
   "role.requirements-manager",
   "role.product-manager",
-  "role.business",
+  "role.project-manager",
   "role.frontend-engineer",
   "role.backend-engineer",
   "role.test-engineer"

package/template/scripts/verify-template-verification-scenarios

@@ -38,6 +38,8 @@ const releaseBaseline = [
   "scripts/verify-matt-yss-integration-scenarios",
   "scripts/verify-yss-router-scenarios",
   "scripts/verify-yss-ui-scenarios",
+  "scripts/verify-yss-prototype-contract-scenarios",
+  "node .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs validate-evidence docs/design/templates/prototype-evidence-template.yaml --allow-template",
   "scripts/verify-openapi-yaml-first-scenarios",
   "scripts/verify-openapi-json-handoff-scenarios"
 ].sort();
@@ -57,6 +59,9 @@ const skillChange = planTemplateVerification({ profile: "fast", changedFiles: ["
 assert.ok(skillChange.groups.includes("skills"));
 assert.ok(skillChange.groups.includes("hygiene"));
 
+const prototypeContractChange = planTemplateVerification({ profile: "fast", changedFiles: ["scripts/verify-yss-prototype-contract-scenarios"] });
+assert.ok(prototypeContractChange.groups.includes("implementation"), "原型契约脚本变化必须运行实现压力场景");
+
 const candidate = planTemplateVerification({ profile: "candidate", changedFiles: ["docs/process/harness-process-tailoring.md"] });
 assert.equal(candidate.effective_profile, "candidate");
 assert.ok(candidate.groups.includes("maintenance"));

package/template/scripts/verify-yss-prototype-contract-scenarios

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../.agents/skills/yss-prototype-stage/tests/run-scenarios.mjs";

package/template/skills-lock.json

@@ -513,7 +513,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/maintaining-skills/SKILL.md",
-        "effectiveHash": "580d87f7b0345acbba37f3281857ce1022ad2dd18a21487bfd1c7ab42f70d020",
+        "effectiveHash": "16f8adeeaa8fc3e8abf3ec49f9e96fe74e3dede0a0b70a918bc62931b597bff7",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1068,7 +1068,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-antd-design/SKILL.md",
-        "effectiveHash": "9ebed3a9b0ac94ecf1deafa096c1bfb999264d103d8fcd8cdf6eb4979196124c",
+        "effectiveHash": "09cbc687f2240c7402393c06f499877be432d1fbb2ee36e97dba4aad66d18f15",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1180,7 +1180,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
-        "effectiveHash": "086955517185dd1f2d663747dcda30a89e0467e085acb18ce2f64efe9ce5eebc",
+        "effectiveHash": "2392b5b87fe403ed24b2158f06f6969b2f48afb4b53bfc006b38314c1b08c7b3",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1404,7 +1404,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-page-module-development/SKILL.md",
-        "effectiveHash": "b1eb12cca45150ee776e68b3eb159e291d21bccb0d4b97a703de80c19ee7d7fb",
+        "effectiveHash": "18d91ded9c236a76395c6bc6cab303cf6c5acda6c1d642fcb3363af0d4803c19",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1420,7 +1420,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "b91de01ab2e87b45f5e9b30dc96c54936bbbef995965870dfb188d5b781fc7d0",
+        "effectiveHash": "a7283ff14706ed156d0ed4eea619407b9758e3f2dca521f112ab4bcdfad46f57",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1436,7 +1436,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
-        "effectiveHash": "2d5665a622624c0525f41c919e69c5c0e327d1d9d678b2587cc013d491f92ff2",
+        "effectiveHash": "ac8842d09ecb52bf796f37d4086d7ea0a9a89c9ca5a25b92313c1683155b31b2",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1484,7 +1484,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-router/SKILL.md",
-        "effectiveHash": "29792bb3938257a12e1f4a175808fceeebfb3318116c6c09621c05d5137cb61d",
+        "effectiveHash": "7b1cd0ed4fc3b99a313e125d68f2e7e9bbbf53b4369085575ba06f4d2872a3ca",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1564,7 +1564,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ui/SKILL.md",
-        "effectiveHash": "a060957c82f799fb5403f73a515eb992ef6ec406562aa1d51ad2043051f7e9da",
+        "effectiveHash": "d4acc508059f872f1c9b22fc296cdf224bf6ad91898cd54f12a1a83110177d76",
         "targets": [
           ".agents/skills",
           ".claude/skills",

package/template.manifest.json

@@ -18,6 +18,7 @@
     "AGENTS.md",
     "CLAUDE.md",
     "CONTEXT.md",
+    "DESIGN.md",
     "README.md",
     "skills-lock.json",
     "yss-project.yaml",

package/template.snapshot.json

@@ -3,15 +3,15 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "96fb0900f8f49e42fe17d36e4cac4717b341bcf2",
-  "templateCommit": "96fb0900f8f49e42fe17d36e4cac4717b341bcf2",
-  "manifestHash": "10d161eb3f0e426aeefad5d0b9e6c5522d8a4dbacb9edf6ed64285dcb40b1a65",
+  "requestedRef": "a7f2c1be9cb96569c1f6d41890edd72719a5f2af",
+  "templateCommit": "a7f2c1be9cb96569c1f6d41890edd72719a5f2af",
+  "manifestHash": "387b499e08cf3dfa03e08acbc5b5783ee287c61aca12d995c61e2140f5552f40",
   "encodedPaths": {
     ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
     ".codex/skills/product-design/.npmignore": ".codex/skills/product-design/__yss_dotfile__.npmignore",
     ".codex/skills/product-design/templates/prototype/.npmrc": ".codex/skills/product-design/templates/prototype/__yss_dotfile__.npmrc",
     ".gitignore": "__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "88d47b9a23ea0f1995352b58ad35c7103e40210ec426738b271bf659e328e1d5",
-  "generatedAt": "2026-09-01T15:33:54.062Z"
+  "snapshotHash": "9c3b6db377c9fc29f0ae947bcad5eb7ae181e1027fd2cc7b17cd000759a9ac59",
+  "generatedAt": "2026-09-02T16:32:00.623Z"
 }

package/template/docs/user-guide/templates//347/224/250/346/210/267/346/211/213/345/206/214/346/250/241/346/235/277.md

@@ -1,53 +0,0 @@
----
-pipeline: <feature-id>
-stage: user-guide
-status: draft
-owner: ai
----
-
-# <功能名称>用户手册
-
-> 适用场景：功能发布前或发布后，需要让业务用户、实施顾问或运维人员完成真实工作流。
-> 本文面向使用者，不描述内部实现细节。
-
-## 1. 适用对象
-
-| 用户 / 角色 | 需要完成的任务 | 前置条件 |
-|-------------|----------------|----------|
-|  |  |  |
-
-## 2. 功能入口
-
-- 菜单 / 页面入口：
-- 权限要求：
-- 相关配置：
-
-## 3. 核心流程
-
-| 步骤 | 操作 | 预期结果 | 异常处理 |
-|------|------|----------|----------|
-| 1 |  |  |  |
-
-## 4. 状态与提示
-
-| 状态 / 提示 | 含义 | 用户应如何处理 |
-|-------------|------|----------------|
-|  |  |  |
-
-## 5. 常见问题
-
-| 问题 | 原因 | 处理方式 |
-|------|------|----------|
-|  |  |  |
-
-## 6. 发布与支持信息
-
-- 适用版本：
-- 相关发布说明：
-- 支持 / 反馈渠道：
-
-## 7. 完成标准
-
-- [ ] 目标用户可按本文完成核心流程。
-- [ ] 权限、配置、异常状态和常见问题已说明。
-- [ ] 不暴露不必要的内部实现细节。