create-yss-spec 3.4.10 → 3.5.0

package/template/.cursor/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/.cursor/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/.cursor/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/.pi/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/.pi/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/.pi/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/.pi/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/.pi/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/docs/agents/yss-plugin-dependency-contract.md

@@ -1,45 +0,0 @@
-# YSS 插件依赖契约
-
-## 目的
-
-YSS Codex 插件可以随插件包提供角色 Harness skill，但不拥有目标项目的共享 skill。共享 skill 的权威内容仍是目标项目的 `.agents/skills`，投影、来源和 hash 由目标项目的 `skills-lock.json` 与 `docs/agents/yss-skill-registry.yaml` 管理。
-
-插件依赖文件位于插件根目录 `.yss-plugin/dependencies.yaml`，用于声明插件需要的角色契约，而不是复制 `core_skills` 清单。
-
-```yaml
-schema_version: 1
-plugin: yss-backend-harness
-requires:
-  - role_id: role.backend-engineer
-    registry: docs/agents/digital-human-roles.yaml
-    minimum_contract_version: 1
-```
-
-## 校验规则
-
-1. 插件导入时只校验 `dependencies.yaml` 的结构、插件名和 `schema_version`。
-2. 插件调用前必须校验目标项目 `yss-project.yaml`，且 `repository_mode` 合法。
-3. 目标项目必须存在依赖声明中的角色，且 `contract_version` 不低于 `minimum_contract_version`。
-4. 角色的 `core_skills` 由目标项目的 `digital-human-roles.yaml` 动态解析；插件不得维护第二份清单。
-5. 共享 skill 必须通过 `yss-skill-registry.yaml`、`skills-lock.json` 和目标 Agent projection 校验。
-6. 缺少角色、版本不兼容、skill 缺失、来源或 hash 漂移、投影不完整时，插件必须返回 `blocked`，不得降级执行。
-7. 插件不得自动写入 `.agents/skills`、`skills-lock.json` 或任何 Agent projection；修复应回路由到目标项目维护流程。
-
-## 运行时结果
-
-依赖不满足时至少返回：
-
-```yaml
-status: blocked
-blocking_signals: [missing-role]
-diagnostics:
-  plugin: yss-backend-harness
-  required_role: role.backend-engineer
-  next_route: install-or-sync-target-project-skills
-```
-
-`blocking_signals` 可使用 `repository-identity-invalid`、`missing-role`、`incompatible-contract-version`、`missing-skill`、`skill-source-drift`、`skill-hash-drift` 和 `skill-projection-incomplete`。
-
-## 版本策略
-
-依赖文件 schema 只保证同一主版本向后兼容。插件的 `minimum_contract_version` 是硬门槛；`tested_with` 等兼容性信息只能作为提示，不能替代目标项目的契约版本校验。