create-yss-spec 2.1.5 → 2.1.7

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

@@ -1,47 +0,0 @@
----
-name: yss-variable
-description: Use when 用于 YSS variable 组件、变量命名空间、VariableController、VarNameSpaceController、变量解析、占位符替换和变量导入导出排障。
----
-
-# yss-variable
-
-Use this skill for YSS 变量组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
-
-中文说明：本技能用于 YSS 变量组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
-
-## Source Index First
-
-- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
-- Generated index: `references/source-index.md`
-- Component path hints: `yss-microservice-components/yss-component-variable`
-
-Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
-
-## Workflow
-
-1. Identify whether the task is variable CRUD, namespace management, variable copy/move, import/export, wildcard search, author write handling, or async task status.
-2. Read `references/source-index.md`, then inspect `VariableController`, `VarNameSpaceController`, `VariableService`, mappers, DTOs, and enums.
-3. Keep namespace operations separate from variable definition operations.
-4. Use `VarTypeEnum` and `UserFlagEnum` semantics instead of stringly typed business flags.
-5. For import/copy/move tasks, inspect request/response DTOs and task response/status models.
-
-## Capability Split
-
-- Controllers: namespace and variable APIs.
-- Service/mapper/entity: variable persistence and operations.
-- DTOs: namespace page query, variable definition/copy/move/import/list responses.
-- Common utilities: author write handler, SQL wildcard transform, result wrappers.
-
-## Checklist
-
-- Required dependency or starter module is present.
-- Namespace and variable IDs/paths are handled consistently.
-- Variable type and user flag values use enums.
-- Import errors are returned through existing error response DTOs.
-- Wildcard search escapes SQL-sensitive characters through existing utility behavior.
-
-## Do Not
-
-- Do not invent class names or configuration keys without checking the source index.
-- Do not replace component extension points with business-local framework code.
-- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.trae/skills/yss-variable/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "yss-variable"
-  short_description: "YSS component skill for yss-variable"
-  default_prompt: "Use yss-variable for this YSS backend component task."

package/template/.trae/skills/yss-variable/references/source-index.md

@@ -1,60 +0,0 @@
-# yss-variable Source Index
-
-Generated: 2026-08-08T15:43:04+00:00
-Source commit: `a34644e2dfc4eb2bfa2b0a1c69dc6b61cc98539a`
-Source worktree: `dirty`
-Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
-
-This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. Do not hand-edit generated sections.
-
-Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
-
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-variable` (existed when indexed)
-
-## Documentation Files
-
-- No component documentation files found.
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-variable`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/AuthorWriteHandler.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/DataListener.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/ResultCode.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/YssApiResult.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/common/util/SqlWildcardTransformUtil.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/controller/VarNameSpaceController.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/controller/VariableController.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/PageDto.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/namespace/PageNameSpaceReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/task/TaskResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/task/TaskStatusResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/Excel.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableCopyOrMoveReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableCopyOrMoveResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableDefinitionReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableFindPageReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableImportErrorResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableListResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableReq.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/dto/variable/VariableResp.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/OperUserDo.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/Task.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/entity/Variable.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/enums/UserFlagEnum.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/enums/VarTypeEnum.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/mapper/VarNameSpaceMapper.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/mapper/VariableMapper.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/service/VariableService.java`
-- `yss-microservice-components/yss-component-variable/src/main/java/com/yss/cloud/variable/service/impl/VariableServiceImpl.java`
-
-## Recommended Next Reads
-
-- Start with the documentation files above when learning component usage.
-- Search the key Java entry points for annotations, auto configuration, properties, aspects, interceptors, handlers, and result objects before changing application code.
-- Prefer existing component extension points over rewriting framework logic in business modules.

package/template/.trae/skills/yss-web-controller/scripts/generate_controller.py

@@ -1,293 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-
-import argparse
-import json
-import os
-import re
-import sys
-from string import Template
-
-def to_camel_case(snake_str):
-    components = snake_str.lower().split('_')
-    return "".join(x.title() for x in components)
-
-def to_lower_camel_case(snake_str):
-    camel = to_camel_case(snake_str)
-    if not camel:
-        return ""
-    return camel[0].lower() + camel[1:]
-
-def to_kebab_case(snake_str):
-    return snake_str.lower().replace('_', '-')
-
-def package_to_path(package_name):
-    return package_name.replace(".", os.sep)
-
-def ensure_subdir(root_path, subdir_name):
-    if os.path.basename(os.path.normpath(root_path)) == subdir_name:
-        return root_path
-    return os.path.join(root_path, subdir_name)
-
-TYPE_MAPPING = {
-    "bigint": "Long",
-    "int": "Integer",
-    "integer": "Integer",
-    "smallint": "Integer",
-    "tinyint": "Integer",
-    "number": "Long",
-    "numeric": "BigDecimal",
-    "decimal": "BigDecimal",
-    "float": "Float",
-    "double": "Double",
-    "real": "Float",
-    "varchar": "String",
-    "varchar2": "String",
-    "nvarchar2": "String",
-    "char": "String",
-    "nchar": "String",
-    "text": "String",
-    "clob": "String",
-    "nclob": "String",
-    "date": "LocalDateTime",
-    "datetime": "LocalDateTime",
-    "timestamp": "LocalDateTime",
-    "timestamp with time zone": "LocalDateTime",
-    "boolean": "Boolean",
-    "bool": "Boolean",
-    "bit": "Boolean",
-    "json": "String",
-    "jsonb": "String",
-    "uuid": "String"
-}
-
-def get_java_type(sql_type):
-    sql_type = sql_type.lower()
-    # Handle types like varchar(255)
-    base_type = re.split(r'\(', sql_type)[0]
-    return TYPE_MAPPING.get(base_type, "String")
-
-def generate_fields(columns, skip_pk=False, is_cmd=False, skip_audit=True):
-    fields = []
-    for col in columns:
-        col_name = col["name"]
-        if skip_pk and col.get("primary"):
-            continue
-
-        # Skip audit columns if they are standard
-        if skip_audit and col_name.lower() in ["create_time", "update_time", "create_by", "update_by", "deleted", "version"]:
-            continue
-
-        java_type = get_java_type(col["sql_type"])
-        java_name = to_lower_camel_case(col_name)
-        comment = col.get("comment", "")
-
-        field_str = ""
-        if comment:
-            field_str += f"    /**\n     * {comment}\n     */\n"
-
-        if is_cmd:
-            if not col.get("nullable"):
-                if java_type == "String":
-                    field_str += f"    @NotBlank(message = \"{comment or java_name}不能为空\")\n"
-                else:
-                    field_str += f"    @NotNull(message = \"{comment or java_name}不能为空\")\n"
-
-        field_str += f"    private {java_type} {java_name};"
-        fields.append(field_str)
-
-    return "\n\n".join(fields)
-
-def main():
-    parser = argparse.ArgumentParser(description="Generate YSS Web Controller and DTOs")
-    parser.add_argument("--metadata-file", required=True, help="Path to metadata.json")
-    parser.add_argument("--base-package", required=True, help="Base package name")
-    parser.add_argument("--module-name", required=True, help="Module name")
-    parser.add_argument("--output-dir", default="./output", help="Output directory")
-    parser.add_argument("--domain-project-dir", help="Domain module root directory")
-    parser.add_argument("--web-project-dir", help="Web module root directory")
-    parser.add_argument("--domain-output-dir", help="Domain module output directory (for DTOs/VOs)")
-    parser.add_argument("--web-output-dir", help="Web module output directory (for Controller)")
-    parser.add_argument("--author", default="System", help="Author name")
-    parser.add_argument("--force", action="store_true", help="Overwrite existing files")
-    parser.add_argument("--domain-segment", required=True, help="Domain segment package name")
-    parser.add_argument(
-        "--application-service-package",
-        help="Application Service package; defaults to <base-package>.application.service",
-    )
-    parser.add_argument(
-        "--validation-namespace",
-        choices=("javax", "jakarta"),
-        default="javax",
-        help="Validation API namespace from the target engineering baseline",
-    )
-
-    args = parser.parse_args()
-
-    if not os.path.exists(args.metadata_file):
-        print(f"Error: Metadata file not found: {args.metadata_file}")
-        sys.exit(1)
-
-    try:
-        with open(args.metadata_file, 'r', encoding='utf-8') as f:
-            metadata = json.load(f)
-    except Exception as e:
-        print(f"Error reading metadata file: {e}")
-        sys.exit(1)
-
-    tables = metadata.get("tables", [])
-    if not tables:
-        print("Warning: No tables found in metadata.")
-        return
-
-    script_dir = os.path.dirname(os.path.abspath(__file__))
-    templates_dir = os.path.join(script_dir, "../assets/templates")
-
-    def load_tpl(name):
-        path = os.path.join(templates_dir, name)
-        if not os.path.exists(path):
-            print(f"Warning: Template not found: {path}")
-            return None
-        with open(path, 'r', encoding='utf-8') as f:
-            return f.read()
-
-    controller_tpl = load_tpl("Controller.java.template")
-    web_convertor_tpl = load_tpl("WebConvertor.java.template")
-    vo_tpl = load_tpl("domain/vo/VO.java.template")
-    add_cmd_tpl = load_tpl("domain/dto/cmd/AddCmd.java.template")
-    update_cmd_tpl = load_tpl("domain/dto/cmd/UpdateCmd.java.template")
-    page_query_tpl = load_tpl("domain/dto/query/PageQuery.java.template")
-    package_path = package_to_path(args.base_package)
-
-    if args.domain_output_dir:
-        domain_base_root = args.domain_output_dir
-    elif args.domain_project_dir:
-        domain_base_root = os.path.join(args.domain_project_dir, "src", "main", "java", package_path)
-    else:
-        domain_base_root = os.path.join(args.output_dir, package_path)
-
-    if args.web_output_dir:
-        web_base_root = args.web_output_dir
-    elif args.web_project_dir:
-        web_base_root = os.path.join(args.web_project_dir, "src", "main", "java", package_path)
-    else:
-        web_base_root = os.path.join(args.output_dir, package_path)
-
-    domain_root = ensure_subdir(domain_base_root, "client")
-    web_root = ensure_subdir(web_base_root, "rest")
-
-    for table in tables:
-        table_name = table["table_name"]
-        clean_name = to_camel_case(table_name)
-
-        domain_class = clean_name
-        domain_var = to_lower_camel_case(table_name)
-        domain_desc = table.get("table_comment") or domain_class
-        domain_desc = domain_desc.strip().replace('\n', ' ')
-        domain_pkg_name = args.domain_segment
-        domain_url_path = to_kebab_case(table_name)
-
-        domain_model_pkg = f"{args.base_package}.domain.{domain_pkg_name}.model"
-        web_convertor_pkg = f"{args.base_package}.rest.convertor"
-        application_service_pkg = (
-            args.application_service_package
-            or f"{args.base_package}.application.service"
-        )
-
-        # Field generation for DTOs
-        columns = table.get("columns", [])
-        field_declarations_vo = generate_fields(columns, skip_audit=False)
-        field_declarations_add = generate_fields(columns, skip_pk=True, is_cmd=True, skip_audit=True)
-        field_declarations_update = generate_fields(columns, skip_pk=False, is_cmd=True, skip_audit=True)
-        field_declarations_query = generate_fields(columns, skip_audit=True) # Query usually has all fields as optional filters
-
-        vo_class = f"{domain_class}VO"
-        add_cmd_class = f"{domain_class}AddCmd"
-        update_cmd_class = f"{domain_class}UpdateCmd"
-        query_class = f"{domain_class}PageQuery"
-        domain_import = f"import {domain_model_pkg}.{domain_class};"
-
-        query_call = f"{domain_var}Service.page(query)"
-        detail_call = f"{domain_var}Service.detail(id)"
-        add_call = f"{domain_var}Service.add(cmd)"
-        update_call = f"{domain_var}Service.update(cmd)"
-        delete_call = f"{domain_var}Service.delete(id)"
-
-        application_service_class = f"{domain_class}Service"
-        application_service_import = (
-            f"import {application_service_pkg}.{application_service_class};"
-        )
-        dto_imports = "\n".join([
-            f"import {args.base_package}.client.dto.cmd.{domain_class}AddCmd;",
-            f"import {args.base_package}.client.dto.cmd.{domain_class}UpdateCmd;",
-            f"import {args.base_package}.client.dto.query.{domain_class}PageQuery;",
-            f"import {args.base_package}.client.vo.{domain_class}VO;"
-        ])
-        application_service_field = (
-            f"private final {application_service_class} {domain_var}Service;"
-        )
-        web_convertor_class = f"{domain_class}WebConvertor"
-        web_convertor_import = f"import {web_convertor_pkg}.{web_convertor_class};"
-
-        ctx = {
-            "base_package": args.base_package,
-            "module_name": args.module_name,
-            "domain_class": domain_class,
-            "domain_var": domain_var,
-            "domain_desc": domain_desc,
-            "domain_url_path": domain_url_path,
-            "domain_pkg_name": domain_pkg_name,
-            "author": args.author,
-            "dto_imports": dto_imports,
-            "application_service_import": application_service_import,
-            "domain_import": domain_import,
-            "web_convertor_import": web_convertor_import,
-            "web_convertor_class": web_convertor_class,
-            "application_service_field": application_service_field,
-            "query_call": query_call,
-            "detail_call": detail_call,
-            "add_call": add_call,
-            "update_call": update_call,
-            "delete_call": delete_call,
-            "vo_class": vo_class,
-            "add_cmd_class": add_cmd_class,
-            "update_cmd_class": update_cmd_class,
-            "query_class": query_class,
-            "validation_namespace": args.validation_namespace,
-            "field_declarations": "" # placeholder
-        }
-
-        def write_file(path, content):
-            os.makedirs(os.path.dirname(path), exist_ok=True)
-            if not os.path.exists(path) or args.force:
-                with open(path, 'w', encoding='utf-8') as f:
-                    f.write(content)
-                print(f"Generated: {path}")
-            else:
-                print(f"Skipped (exists): {path}")
-
-        # 1. Controller (Web Layer)
-        write_file(os.path.join(web_root, f"{domain_class}Controller.java"), Template(controller_tpl).substitute(ctx))
-        write_file(
-            os.path.join(web_root, "convertor", f"{web_convertor_class}.java"),
-            Template(web_convertor_tpl).substitute(ctx)
-        )
-
-        # 2. DTOs & VO (Domain Layer)
-        ctx["field_declarations"] = field_declarations_vo
-        write_file(os.path.join(domain_root, "vo", f"{domain_class}VO.java"), Template(vo_tpl).substitute(ctx))
-
-        ctx["field_declarations"] = field_declarations_add
-        write_file(os.path.join(domain_root, "dto/cmd", f"{domain_class}AddCmd.java"), Template(add_cmd_tpl).substitute(ctx))
-
-        ctx["field_declarations"] = field_declarations_update
-        write_file(os.path.join(domain_root, "dto/cmd", f"{domain_class}UpdateCmd.java"), Template(update_cmd_tpl).substitute(ctx))
-
-        ctx["field_declarations"] = field_declarations_query
-        write_file(
-            os.path.join(domain_root, "dto/query", f"{domain_class}PageQuery.java"),
-            Template(page_query_tpl).substitute(ctx),
-        )
-
-if __name__ == "__main__":
-    main()

package/template/.trae/skills/yss-web-controller/scripts/test_generate_controller.py

@@ -1,68 +0,0 @@
-#!/usr/bin/env python3
-import json
-import subprocess
-import sys
-import tempfile
-import unittest
-from pathlib import Path
-
-
-SCRIPT = Path(__file__).with_name("generate_controller.py")
-
-
-class GenerateControllerTest(unittest.TestCase):
-    def test_uses_application_service_and_validation_profile(self):
-        metadata = {
-            "tables": [
-                {
-                    "table_name": "quality_rule",
-                    "table_comment": "质量规则",
-                    "columns": [
-                        {"name": "id", "sql_type": "bigint", "primary": True, "nullable": False},
-                        {"name": "rule_name", "sql_type": "varchar(64)", "nullable": False},
-                    ],
-                }
-            ]
-        }
-        with tempfile.TemporaryDirectory() as temp_dir:
-            root = Path(temp_dir)
-            metadata_path = root / "metadata.json"
-            metadata_path.write_text(json.dumps(metadata), encoding="utf-8")
-            subprocess.run(
-                [
-                    sys.executable,
-                    str(SCRIPT),
-                    "--metadata-file",
-                    str(metadata_path),
-                    "--base-package",
-                    "com.yss.demo",
-                    "--module-name",
-                    "demo",
-                    "--domain-segment",
-                    "quality",
-                    "--output-dir",
-                    str(root / "out"),
-                    "--application-service-package",
-                    "com.yss.demo.application.service",
-                    "--validation-namespace",
-                    "jakarta",
-                ],
-                check=True,
-                capture_output=True,
-                text=True,
-            )
-            controller = next((root / "out").rglob("QualityRuleController.java")).read_text(encoding="utf-8")
-            query = next((root / "out").rglob("QualityRulePageQuery.java")).read_text(encoding="utf-8")
-
-        self.assertIn("import com.yss.demo.application.service.QualityRuleService;", controller)
-        self.assertIn("private final QualityRuleService qualityRuleService;", controller)
-        self.assertNotIn("Gateway", controller)
-        self.assertIn("@Valid @RequestBody QualityRuleAddCmd", controller)
-        self.assertIn("import com.yss.demo.client.dto.query.QualityRulePageQuery;", controller)
-        self.assertNotIn("import com.yss.demo.client.dto.query.QualityRulePage;", controller)
-        self.assertIn("import jakarta.validation.Valid;", controller)
-        self.assertIn("class QualityRulePageQuery extends PageQuery", query)
-
-
-if __name__ == "__main__":
-    unittest.main()

package/template/docs/adr/0004-split-lifecycle-and-router-registry-domains.md

@@ -1,5 +0,0 @@
-# ADR-0004: 分离生命周期注册域与 Router 合同域并迁移到 schema v2
-
-> 状态：proposed。当前仅有 `schema_version: 1` 的生命周期结构注册表 shadow 校验；v2 迁移尚未实施。
-
-生命周期控制和实现合同编译具有不同的变化频率与责任边界，因此拟采用一套逻辑治理体系下的两个结构化职责域：生命周期注册域定义主阶段、门禁、产物、工作单元、证据、状态迁移和人工交互，Router 合同域定义实现子合同、技能闭包、写路径与验证约束，两者只通过稳定 ID 引用。后续 schema v2 迁移应提供 v1/v2 读取、dry-run 迁移和冲突时 fail closed；验证通过后才允许只写 v2，并保留来源版本、迁移证据和回滚引用。在上述运行时资产与迁移验证落地前，本 ADR 不构成已完成的发布能力。

package/template/docs/adr/0005-cross-repository-ecosystem-release-manifest.md

@@ -1,5 +0,0 @@
-# ADR-0005: 使用生态发布清单协调模板、CLI 与公开技能
-
-> 状态：proposed。生态发布清单、schema 与跨仓闭合校验尚未实现；当前发布只可声明模板仓库和 CLI 固定模板快照的双仓验证，不得宣称模板、CLI 与公开技能已形成生态级可发布闭环。
-
-YSS 研发操作系统跨模板仓库、`create-yss-spec` 和公开技能仓库发布，单仓测试通过不能证明整体版本一致。提案是在后续 Phase 使用生态发布清单关联生命周期 schema、Matt snapshot、模板 commit/tree hash、CLI version/固定模板快照和公开技能来源 commit/导出 hash，并要求发布校验闭合这些引用；各仓只记录发布时已经存在的上游身份，避免循环引用未来 commit。该设计增加了发布记录和集成验证成本，但在 manifest、schema、校验器和跨仓测试同时落地前不构成当前发布门禁。

package/template/docs/adr/0007-separate-skill-routing-registry-from-integrity-lock.md

@@ -1,5 +0,0 @@
-# ADR-0007: 分离技能路由注册表与完整性锁
-
-> 状态：proposed。`docs/agents/yss-skill-registry.yaml`、schema、Router 消费与校验尚未实现；当前 Router 仍以 `router-contract.yaml` 和 `skills-lock.json` 的既有职责边界运行，不得把本 ADR 作为已生效的运行时入口规则。
-
-`skills-lock.json` 负责技能来源、hash 和投影完整性，而生命周期阶段、影响面、Core/Specialist 分层、成熟度、新鲜度和 Router 默认可用性属于产品路由语义。提案是在后续 Phase 于 `docs/agents/yss-skill-registry.yaml` 中维护后者，并让每个 Agent 运行时只发现一个平台投影根；canonical `.agents/skills` 继续作为内容权威，但不与平台投影同时形成同权运行时入口。该分离增加了一份受 schema 校验的注册资产，却避免完整性锁不断吸收路由策略，也减少同名双入口和“能够安装即等于受支持”的歧义；在注册资产和 Router 消费尚未交付时，不能把该分离视为既有事实。

package/template/docs/implementation/create-yss-spec-repository-mode-contract.md

@@ -1,90 +0,0 @@
-# `create-yss-spec` 接管与模板同步跨仓库契约
-
-本文定义模板源仓库与外部 `create-yss-spec` CLI 仓库之间的身份、资产边界、迁移、同步、验证和发布契约。
-
-## 契约目标
-
-- 模板源仓库保留 `repository_mode: template-source`。
-- CLI 创建或接管的产品仓库写入 `repository_mode: project-instance`。
-- CLI 只管理 manifest 声明的研发管理资产，不接管前后端运行时代码、业务目录、用户文件或 `.git`。
-- 通过模板快照和 40 位 `templateCommit` 使每次初始化、升级和回滚可追踪。
-
-## 生命周期接口
-
-### 空目录初始化
-
-初始化必须把模板身份转换为 `schema_version: 1`、`repository_mode: project-instance`，并执行目标仓库的：
-
-```bash
-scripts/sync-skills --check
-scripts/update-skill-lock --check
-scripts/verify-template
-```
-
-### 已有项目 `attach`
-
-```bash
-npx create-yss-spec@latest attach \
-  --target-dir . \
-  --project-name "项目名称" \
-  --business-domain "业务领域" \
-  --dry-run
-npx create-yss-spec@latest attach \
-  --target-dir . \
-  --project-name "项目名称" \
-  --business-domain "业务领域" \
-  --apply [--force]
-```
-
-`attach` 必须显式选择 dry-run 或 apply，已有 `.yss-template.json` 时拒绝并提示 `sync`。计划按 `missing`、`matched`、`conflict`、`unsafe` 分类；force 只能覆盖受管 conflict，不能绕过 unsafe 或迁移冲突。合法 `template-source` 可转换为 `project-instance`，合法 `project-instance` 保留并校验，非法身份在写入前阻断。
-
-### 持续同步 `sync`
-
-`sync` 只使用 CLI 包内置的模板快照。“最新”指用户执行 `npx create-yss-spec@latest` 所携带的最新已发布快照，不在运行时直接拉取模板仓库。普通同步新增缺失文件、更新 baseline 未被本地修改的文件、报告冲突和模板删除；`sync --force` 先备份再覆盖受管冲突，模板删除默认只报告。
-
-完成后必须重新执行三个模板门禁；任一门禁失败时回滚文件变更并保持旧 metadata 版本。
-
-## metadata v2
-
-`.yss-template.json` 至少包含：
-
-```json
-{
-  "metadataSchemaVersion": 2,
-  "templateName": "create-yss-spec",
-  "cliVersion": "2.1.4",
-  "templateSource": "github:iloveZzz/yss-spec-project-template",
-  "templateCommit": "<40-char-commit>",
-  "managedFilesManifestVersion": "<manifest-hash>",
-  "managedFiles": {}
-}
-```
-
-`managedFiles` 是每个受管文件的 baseline。CLI apply 前把将被覆盖的文件保存到目标目录外的临时备份目录；验证成功后默认保留，失败按操作日志回滚，metadata 不更新。
-
-## 固定迁移规则
-
-CLI 必须遵循 [Spec / Ticket 迁移指南](../user-guide/规格与任务迁移指南.md) 的固定映射：旧 Spec / Ticket skill 和模板入口迁移为当前名称，旧规格文件、根 `.scratch/<feature>/` 迁移到当前路径；无法推断功能归属的扁平 Ticket 标记为 `unsafe` 并阻断。新旧目标内容不一致时标记 `conflict`，不得静默覆盖。
-
-## 跨仓库验收
-
-| 场景 | 必须验证 |
-|---|---|
-| 空目录初始化 | `project-instance`、metadata v2、固定 commit、六类 projection 和模板门禁 |
-| 任意已有项目 attach dry-run | 不写文件、不删除 `.git`，运行时代码和无关文件不变 |
-| attach apply | 缺失资产新增；matched 纳入 baseline；conflict 需 force；unsafe 不可 force 绕过 |
-| 旧资产迁移 | 规格 / Ticket 路径和根 scratch 安全迁移；目标冲突与扁平 Ticket fail closed |
-| sync | 新增、更新、冲突、迁移和删除报告完整；force 只作用于受管文件 |
-| post-sync | 三个门禁全部 fresh 通过；失败时文件和 metadata 回滚 |
-| 发布包 | 固定 commit 下 `npm test` 和 `npm pack --dry-run` 通过，包内含 `template.snapshot.json` |
-
-本变更只涉及模板治理和外部 CLI，不涉及 frontend、backend、OpenAPI 或运行时工程；这些范围为 `not-applicable`。
-
-## 发布顺序与阻断条件
-
-1. 模板恢复 `docs/process/*`、正式处理 `.qoder` 投影并通过 fresh verification，形成确定 commit。
-2. CLI 绑定该 commit，完成 attach / sync 跨仓库测试和独立 review。
-3. 运行固定 commit 的 `npm test`、`npm pack --dry-run`，确认包内快照和实例门禁通过。
-4. 发布 CLI `2.1.4`，并回写版本、验证证据、备份恢复路径和回滚点。
-
-模板引用仍为浮动 ref、任一共同验证失败、独立 review 未完成或打包失败时，只能声明“本仓库实现完成，跨仓库发布受阻”，不得声明整体可发布。本轮不执行 npm publish。

package/template/docs/process/harness-optimization-backlog.md

@@ -1,9 +0,0 @@
-# Harness 优化积压
-
-本文件只记录可验证的 Harness 改进方向，不替代生命周期事实源或 Ticket。
-
-| 项目 | 触发信号 | 验收证据 |
-|---|---|---|
-| 跨仓库快照一致性 | 模板与 CLI manifest 漂移 | 固定 commit 联调、tree hash、解包测试 |
-| 迁移回滚演练 | 旧路径存在目标冲突 | dry-run 计划、外部备份、失败回滚记录 |
-| 门禁可观测性 | 验证失败原因难以定位 | 命令输出包含阶段、路径、恢复动作 |

package/template/docs/process/harness-work-unit-map.md

@@ -1,16 +0,0 @@
-# Harness 工作单元地图
-
-<!-- lifecycle-registry:work-units:start -->
-> 此表由 `docs/process/lifecycle-registry.yaml` 生成；它只描述 `template-source` 的 Harness 工作单元。
-
-| 稳定 ID | 工作单元 | 输入 | 输出 | 完成条件 |
-|---|---|---|---|---|
-| `work-unit.entry-triage` | 入口分诊 | 用户请求、仓库身份。 | 影响面与最近可信阶段。 | 身份和影响面可解释。 |
-| `work-unit.ssot-update` | 单一事实源更新 | 变更合同。 | 权威文档或脚本。 | 其他投影可由脚本生成。 |
-| `work-unit.skill-projection-sync` | 技能投影同步 | .agents/skills。 | Agent root 投影、skills lock。 | --check 通过。 |
-| `work-unit.template-snapshot-build` | 模板快照构建 | 固定模板 commit。 | CLI bundled snapshot。 | commit 与 tree hash 可追踪。 |
-| `work-unit.attach-sync-integration` | attach / sync 集成 | 目标仓库、dry-run 计划。 | 受管资产和 metadata。 | 验证通过或完整回滚。 |
-| `work-unit.fresh-verification` | Fresh verification | 变更仓库。 | 命令输出与证据。 | 所有命中门禁通过。 |
-| `work-unit.independent-review` | 独立审查 | 变更 diff、验证证据。 | review 结论。 | 无未处理阻断项。 |
-| `work-unit.release-and-rollback` | 发布与回滚 | 已审查 commit。 | release note、观察信号、回滚点。 | 两仓库顺序和恢复动作明确。 |
-<!-- lifecycle-registry:work-units:end -->

package/template/docs/releases/next-major-template-governance.md

@@ -1,32 +0,0 @@
-# 下一主版本：模板治理与 Spec / Ticket 规范化
-
-> 状态：草案，尚不可发布。
-
-## 破坏性变更
-
-- 新流程只使用 Spec、Ticket、`to-spec`、`to-tickets`。
-- 根目录新增 `yss-project.yaml`，Agent 必须按 `repository_mode` 路由。
-- `.agents/skills` 成为共享技能权威内容，其他 Agent root 使用生成投影。
-- Spec 初稿使用 `ready-for-human`；`ready-for-agent` 只用于已解除阻塞、可直接实现的垂直切片 Ticket。
-- Spec Delta 只用于修改既有冻结基线的中高风险行为，不用于全新产品或全新模块。
-- 所有面向人的落地文档正文以简体中文为标准语言。
-
-旧版项目必须按 `docs/user-guide/规格与任务迁移指南.md` 一次性迁移，不提供旧 skill 别名。
-
-## 模板仓库验证
-
-```bash
-scripts/sync-skills --check
-scripts/update-skill-lock --check
-scripts/verify-template
-```
-
-当前模板侧 fresh verification 已通过，包括五类生命周期压力场景、完整目录树哈希、旧入口扫描、Markdown 链接、YAML 解析和 Git 空白检查。
-
-## 发布阻塞项
-
-- 需要其他 Agent 或人工 Reviewer 完成独立审查。
-- 外部 `create-yss-spec` 需要按 `docs/implementation/create-yss-spec-repository-mode-contract.md` 实现 `project-instance` 转换、旧版升级和冲突 fail closed。
-- 模板与 CLI 需要共同执行初始化 / 升级集成验证，并绑定确定的 commit / tag。
-
-上述阻塞全部解除前，本草案不能改为已发布状态。