create-yss-spec 3.4.10 → 3.5.2

package/template.manifest.json

@@ -5,7 +5,7 @@
     ".cursor",
     ".pi",
     ".vscode",
-    "docs",
+    ".template-spec",
     "scripts"
   ],
   "allowRootFiles": [
@@ -20,9 +20,7 @@
     "yss-project.yaml",
     "yss-public-skills.json"
   ],
-  "allowFiles": [
-    "docs/adr/README.md"
-  ],
+  "allowFiles": [],
   "excludeRootEntries": [
     ".git",
     ".codegraph",
@@ -53,14 +51,14 @@
     "docs/discovery",
     "docs/reviews",
     "docs/adr",
-    "docs/process/maintenance-intensity.yaml",
-    "docs/process/schemas/maintenance-review-record.schema.json",
-    "docs/process/templates/maintenance-checkpoint-template.yaml",
-    "docs/process/template-verification-profiles.yaml",
-    "docs/process/template-engineering-overview.md",
-    "docs/agents/skills-maintenance.md",
-    "docs/agents/strategic-design-skills-integration.md",
-    "docs/agents/yss-ui-skills-integration.md",
+    ".template-source/process/maintenance-intensity.yaml",
+    ".template-source/process/schemas/maintenance-review-record.schema.json",
+    ".template-source/process/templates/maintenance-checkpoint-template.yaml",
+    ".template-source/process/template-verification-profiles.yaml",
+    ".template-source/process/template-engineering-overview.md",
+    ".template-source/agents/skills-maintenance.md",
+    ".template-source/agents/strategic-design-skills-integration.md",
+    ".template-source/agents/yss-ui-skills-integration.md",
     "scripts/fixtures",
     "scripts/audit-yss-backend-skills",
     "scripts/cache-template-commit",
@@ -101,11 +99,26 @@
     ".gitignore",
     "AGENTS.md",
     "README.md",
+    "skills-lock.json",
+    ".template-spec/user-guide/用户手册.md",
+    ".template-spec/user-guide/用户手册索引.md",
+    ".template-spec/user-guide/阶段接入与产物复用使用手册.md",
+    ".template-spec/user-guide/技术设计用户指南.md",
+    ".template-spec/design/README.md",
+    ".template-spec/engineering/backend-platforms.json",
+    "scripts/lib/skill-supply-chain.mjs",
+    ".template-spec/agents/backend-architecture-profiles.md",
+    ".agents/skills/yss-design-system/SKILL.md",
+    ".agents/skills/yss-design-system/references/data-quality-theme.md",
+    ".codex/skills/yss-design-system/SKILL.md",
+    ".codex/skills/yss-design-system/references/data-quality-theme.md",
+    ".cursor/skills/yss-design-system/SKILL.md",
+    ".cursor/skills/yss-design-system/references/data-quality-theme.md",
+    ".pi/skills/yss-design-system/SKILL.md",
+    ".pi/skills/yss-design-system/references/data-quality-theme.md",
     "yss-project.yaml"
   ],
-  "exampleDocPaths": [
-    "docs/plan/IDEATION.md"
-  ],
+  "exampleDocPaths": [],
   "initExcludeRootEntries": [],
   "initExcludeRootFiles": [
     "yss-public-skills.json"
@@ -125,6 +138,7 @@
       { "pattern": "wiki/**", "ownership": "user-owned" },
       { "pattern": "docs/reviews/**", "ownership": "user-owned" },
       { "pattern": "docs/.scratch/**", "ownership": "user-owned" },
+      { "pattern": ".template-spec/agents/issue-tracker.md", "ownership": "managed-customizable" },
       { "pattern": "yss-project.yaml", "ownership": "generated" },
       { "pattern": "skills-lock.json", "ownership": "generated" },
       { "pattern": "yss-public-skills.json", "ownership": "generated" },
@@ -140,6 +154,7 @@
     "defaultStrategy": "replace-with-force",
     "rules": [
       { "pattern": ".gitignore", "strategy": "manual" },
+      { "pattern": ".template-spec/agents/issue-tracker.md", "strategy": "manual" },
       { "pattern": "CONTEXT.md", "strategy": "manual" },
       { "pattern": "DESIGN.md", "strategy": "manual" }
     ]

package/template.snapshot.json

@@ -3,10 +3,10 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "445172278b7a107ac42ec00ee1dd936bdd244933",
-  "templateCommit": "445172278b7a107ac42ec00ee1dd936bdd244933",
+  "requestedRef": "13d8d9c9304a73d65d1e2e6842744b9578f4876a",
+  "templateCommit": "13d8d9c9304a73d65d1e2e6842744b9578f4876a",
   "sourceState": "committed",
-  "manifestHash": "7c2fe5e36a464fd32b4ec6466e18e8c762a59bda9cb5b598950aba7dd6358891",
+  "manifestHash": "d5a3b1e8f7b1bfe2f616acbe31abb4710927cd61d432d5e07990c59149435f3d",
   "encodedPaths": {
     ".agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore",
     ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
@@ -17,6 +17,6 @@
     ".gitignore": "__yss_dotfile__.gitignore",
     ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "7a8f13451bd03f54c57a0b4fa3f713fcf0e43601212590a3fb6e8e5db34f5b37",
-  "generatedAt": "2026-09-22T11:13:45.412Z"
+  "snapshotHash": "747545a4222871b8cd201d0b42b64a946bb4f11f3fd63e9f5434bcc32a8b8a5a",
+  "generatedAt": "2026-09-27T14:53:54.985Z"
 }

package/template/.agents/skills/grill-me/SKILL.md

@@ -1,7 +0,0 @@
----
-name: grill-me
-description: A relentless interview to sharpen a plan or design.
-disable-model-invocation: true
----
-
-Call the Skill tool with `grilling`.

package/template/.agents/skills/grill-me/agents/openai.yaml

@@ -1,5 +0,0 @@
-interface:
-  display_name: "Grill Me"
-  short_description: "Sharpen a plan through interview"
-policy:
-  allow_implicit_invocation: false

package/template/.agents/skills/yss-distributed-id/assets/AutoIdInterceptor.java

@@ -1,246 +0,0 @@
-package com.yss.cloud.sankuai.mybatis;
-
-import com.baomidou.mybatisplus.annotation.IdType;
-import com.baomidou.mybatisplus.annotation.TableId;
-import com.baomidou.mybatisplus.annotation.TableName;
-import com.yss.cloud.exception.BizException;
-import com.yss.cloud.sankuai.CosidSegmentContextHelper;
-import com.yss.cloud.sankuai.GenerationTypeSeq;
-import com.yss.cloud.sankuai.SegmentContextHelper;
-import com.yss.cloud.sankuai.SnowflakeContextHelper;
-import lombok.extern.slf4j.Slf4j;
-import org.apache.commons.lang3.StringUtils;
-import org.apache.ibatis.binding.BindingException;
-import org.apache.ibatis.binding.MapperMethod;
-import org.apache.ibatis.executor.statement.StatementHandler;
-import org.apache.ibatis.mapping.BoundSql;
-import org.apache.ibatis.plugin.Interceptor;
-import org.apache.ibatis.plugin.Intercepts;
-import org.apache.ibatis.plugin.Invocation;
-import org.apache.ibatis.plugin.Signature;
-import org.springframework.util.ObjectUtils;
-import org.springframework.util.ReflectionUtils;
-
-import javax.persistence.Entity;
-import javax.persistence.GeneratedValue;
-import javax.persistence.Table;
-import java.lang.reflect.Field;
-import java.sql.Connection;
-import java.util.*;
-
-@Intercepts(
-    {
-        @Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})
-    }
-)
-@Slf4j
-public class AutoIdInterceptor implements Interceptor {
-
-    @Override
-    public Object intercept(Invocation invocation) throws Throwable {
-        StatementHandler statementHandler = (StatementHandler) invocation.getTarget();
-        BoundSql boundSql = statementHandler.getBoundSql();
-        String boundSqlStr = boundSql.getSql();
-        if (StringUtils.startsWithIgnoreCase(StringUtils.trim(boundSqlStr),"INSERT")){
-            processInsertStatement(statementHandler);
-        }
-
-        return invocation.proceed();
-    }
-
-    /**
-     * 1.处理插入的情况
-     *
-     * @apiNote 1.处理新增insert
-     * @param statementHandler 句柄
-     */
-    private void processInsertStatement(StatementHandler statementHandler) {
-        BoundSql boundSql = statementHandler.getBoundSql();
-        Object parameterObject = boundSql.getParameterObject();
-
-        if (parameterObject != null) {
-            processParameterObject(parameterObject);
-        }
-    }
-
-    /**
-     * 处理参数对象
-     *
-     * @apiNote 2.处理参数对象 mapper->entityList,plus->param1
-     * @param parameterObject 参数对象
-     */
-    private void processParameterObject(Object parameterObject) {
-        if (parameterObject instanceof MapperMethod.ParamMap<?>){
-            // 获取批量实体对象，若为空则为single 参数对象
-            Object entityList = null;
-            try {
-                entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("entityList");
-            }catch (BindingException e){
-                log.warn("non entityList. info -> {}",e.getLocalizedMessage());
-            }
-            // 兼容mybatis默认参数 集合的场景
-            if (ObjectUtils.isEmpty(entityList)){
-                try {
-                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("collection");
-                }catch (BindingException e){
-                    log.warn("non entityList & non collection. info -> {}",e.getLocalizedMessage());
-                }
-            }
-            // 兼容mybatis默认参数 数组的场景
-            if (ObjectUtils.isEmpty(entityList)){
-                try {
-                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("array");
-                }catch (BindingException e){
-                    log.warn("non entityList & non collection & non array. info -> {}",e.getLocalizedMessage());
-                }
-            }
-            if (ObjectUtils.isEmpty(entityList)){
-                try {
-                    entityList = ((MapperMethod.ParamMap<?>) parameterObject).get("param1");
-                }catch (BindingException e){
-                    log.error("non param1. info -> {}",e.getLocalizedMessage());
-                    throw new BizException("FeignAutoIdInterceptor run error");
-                }
-            }
-            if (entityList instanceof List) {
-                // 批量插入
-                List<?> el = (List<?>) entityList;
-                for (Object entity : el) {
-                    processEntity(entity);
-                }
-            } else  if (entityList.getClass().isArray()) {
-                // 批量插入
-                Object[] array = (Object[]) entityList;
-                for (Object entity : array) {
-                    processEntity(entity);
-                }
-            }else {
-                // 单独插入
-                processEntity(entityList);
-            }
-        } else {
-            // 单独插入
-            processEntity(parameterObject);
-        }
-    }
-
-    /**
-     * 3.处理对象实体
-     *
-     * @apiNote 3.处理对象实体
-     * @param entity 对象实体
-     */
-    private void processEntity(Object entity) {
-        Class<?> entityClass = entity.getClass();
-        if (isEntityClass(entityClass)) {
-            autoIdSet(entity);
-        }
-    }
-
-    /**
-     * 4.自动为实体设置id
-     *
-     * @apiNote 4.自动为实体设置id
-     * @param entity 对象实体
-     */
-    private void autoIdSet(Object entity) {
-        Class<?> entityClass = entity.getClass();
-        List<Field> fields = getAllFields(entityClass);
-        for (Field field : fields) {
-
-            if (field.isAnnotationPresent(GeneratedValue.class)||
-                    field.isAnnotationPresent(TableId.class)) {
-                processGeneratedValue(entity, field);
-            }
-        }
-    }
-
-    /**
-     * 5.设置id字段
-     *
-     * @param entity 实体对象
-     * @param field id字段
-     */
-    private void processGeneratedValue(Object entity, Field field) {
-        String genIdType = getGenIdType(field);
-
-        String tableName = getTableName(entity);
-
-        if (Objects.nonNull(genIdType)&&
-                Objects.nonNull(SegmentContextHelper.LeafConf())&&
-                SegmentContextHelper.LeafConf().isLeafSegmentEnable()&&
-                (genIdType.equals(GenerationTypeSeq.SEGMENT) || genIdType.equals(IdType.AUTO.name()) || genIdType.equals(IdType.ASSIGN_ID.name()))) {
-            long idValue = SegmentContextHelper.nextId(tableName);
-            setFieldValue(entity, field, idValue);
-        } else if (Objects.nonNull(genIdType)&&
-                Objects.nonNull(SnowflakeContextHelper.LeafConf())&&
-                SnowflakeContextHelper.LeafConf().isLeafSnowflakeEnable()
-                &&genIdType.equals(GenerationTypeSeq.SNOWFLAKE) ) {
-            long idValue = SnowflakeContextHelper.nextId();
-            setFieldValue(entity, field, idValue);
-        } else if (Objects.nonNull(genIdType)&&
-                (genIdType.equals(GenerationTypeSeq.UUID)|| genIdType.equals(IdType.ASSIGN_UUID.name()))) {
-            String idValue = UUID.randomUUID().toString();
-            setFieldValue(entity, field, idValue);
-        } else if (Objects.nonNull(genIdType) &&
-                genIdType.equals(GenerationTypeSeq.COSID_SEGMENT)) {
-            long idValue = CosidSegmentContextHelper.nextId(tableName);
-            setFieldValue(entity, field, idValue);
-        }
-    }
-
-    private void setFieldValue(Object entity, Field field, Object value) {
-        field.setAccessible(true);
-        // 如果value为null,则ID生成服务不可用,使用默认规则替代;有值则覆盖
-        if(!Objects.isNull(value)) {
-            if (field.getType() == String.class) {
-                ReflectionUtils.setField(field,entity,String.valueOf(value));
-            } else if (field.getType() == Integer.class) {
-                ReflectionUtils.setField(field,entity,Integer.valueOf(String.valueOf(value)));
-            } else {
-                ReflectionUtils.setField(field,entity,value);
-            }
-        }
-    }
-
-    private boolean isEntityClass(Class<?> clazz) {
-        return clazz.isAnnotationPresent(Entity.class)||clazz.isAnnotationPresent(TableName.class);
-    }
-
-    private String getTableName(Object entity){
-        Table table = entity.getClass().getAnnotation(Table.class);
-        if (Objects.nonNull(table)){
-            return table.name();
-        }
-
-        TableName tableName = entity.getClass().getAnnotation(TableName.class);
-
-        if (Objects.nonNull(tableName)){
-            return tableName.value();
-        }
-
-        return null;
-    }
-    private static List<Field> getAllFields(Class<?> clazz) {
-        List<Field> fields = new ArrayList<>();
-        while (clazz != null) {
-            Collections.addAll(fields, clazz.getDeclaredFields());
-            clazz = clazz.getSuperclass();
-        }
-        return fields;
-    }
-    private String getGenIdType(Field field){
-        GeneratedValue generatedValueAnnotation = field.getAnnotation(GeneratedValue.class);
-
-        if (Objects.nonNull(generatedValueAnnotation)){
-           return generatedValueAnnotation.generator();
-        }
-
-        TableId tableId = field.getAnnotation(TableId.class);
-
-        if (Objects.nonNull(tableId)){
-            return tableId.type().name();
-        }
-        return null;
-    }
-}

package/template/.agents/skills/yss-distributed-id/assets/EnableDistributedId.java

@@ -1,25 +0,0 @@
-package com.yss.cloud;
-
-import com.yss.cloud.sankuai.config.LeafConf;
-import com.yss.cloud.sankuai.config.LeafDataSourceConfiguration;
-import org.springframework.boot.context.properties.EnableConfigurationProperties;
-import org.springframework.context.annotation.Import;
-
-import java.lang.annotation.*;
-
-@Target({ElementType.TYPE})
-@Retention(RetentionPolicy.RUNTIME)
-@Documented
-@Inherited
-@Import({LeafDataSourceConfiguration.class, EnableDistributedImportSelector.class})
-@EnableConfigurationProperties(LeafConf.class)
-public @interface EnableDistributedId {
-  /**
-   * 默认自动装载leaf配置，设置默认启用状态
-   */
-  boolean autoRegister() default true;
-  /**
-   * 是否启用cosid模式
-   */
-  boolean cosid() default false;
-}

package/template/.agents/skills/yss-distributed-id/assets/LeafConf.java

@@ -1,36 +0,0 @@
-package com.yss.cloud.sankuai.config;
-
-import org.springframework.boot.context.properties.ConfigurationProperties;
-
-@ConfigurationProperties(prefix = "spring.leaf", ignoreInvalidFields = true)
-public class LeafConf {
-  private boolean leafSegmentEnable;
-  private boolean leafSnowflakeEnable;
-
-  public boolean isLeafSegmentEnable() {
-    return leafSegmentEnable;
-  }
-
-  public void setLeafSegmentEnable(boolean leafSegmentEnable) {
-    this.leafSegmentEnable = leafSegmentEnable;
-  }
-
-  public boolean isLeafSnowflakeEnable() {
-    return leafSnowflakeEnable;
-  }
-
-  public void setLeafSnowflakeEnable(boolean leafSnowflakeEnable) {
-    this.leafSnowflakeEnable = leafSnowflakeEnable;
-  }
-
-  @Override
-  public String toString() {
-    return "LeafConf{"
-        + "leafSegmentEnable="
-        + leafSegmentEnable
-        + ", leafSnowflakeEnable="
-        + leafSnowflakeEnable
-        + ", leafSnowflakePort="
-        + '}';
-  }
-}

package/template/.codex/skills/grill-me/SKILL.md

@@ -1,7 +0,0 @@
----
-name: grill-me
-description: A relentless interview to sharpen a plan or design.
-disable-model-invocation: true
----
-
-Call the Skill tool with `grilling`.

package/template/.codex/skills/grill-me/agents/openai.yaml

@@ -1,5 +0,0 @@
-interface:
-  display_name: "Grill Me"
-  short_description: "Sharpen a plan through interview"
-policy:
-  allow_implicit_invocation: false