create-yss-spec 3.2.0 → 3.3.1

package/template/.qoder/skills/yss-mybatis/assets/PageQueryEntityConfigration.java

@@ -1,18 +0,0 @@
-package com.yss.cloud.mybatis.config;
-
-import com.yss.cloud.mybatis.aop.EntityQueryAspect;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Primary;
-
-@Configuration
-@Slf4j
-public class PageQueryEntityConfigration {
-    @Primary
-    @Bean
-    public EntityQueryAspect entityQueryAspect() {
-        log.info("【MapperConfiguration】DataSource 获取数据源primaryDataSourceProperties配置");
-        return new EntityQueryAspect();
-    }
-}

package/template/.qoder/skills/yss-mybatis/references/README.md

@@ -1,57 +0,0 @@
-# 参考资料
-
-本文档详细介绍了 `yss-component-mybatis-starter` 模块中的核心类和配置类，这些类构成了通用 MyBatis 模式的基础。
-
-## 核心类 (Core Classes)
-
-### 1. BaseRepository.java
-**位置**: `../assets/BaseRepository.java`
-
-`BaseRepository<T, D>` 是通用 MyBatis 模式下的核心 Mapper 接口，所有业务 Repository 都应继承它。
-
-**主要特性**:
-- **继承链**: 继承了 `io.mybatis.mapper.BaseMapper` (基础 CRUD), `io.mybatis.mapper.list.ListMapper` (批量操作), 和 `com.baomidou.mybatisplus.core.mapper.Mapper` (兼容性)。
-- **通用方法**:
-  - `insert`, `update`, `delete`: 标准的单表操作。
-  - `selectBatchIds`, `deleteBatchIds`: 批量操作。
-  - `selectByMap`, `selectMaps`, `selectObjs`: 基于 Map 和 Wrapper 的查询。
-- **扩展点**: 允许用户通过继承此接口，获得开箱即用的 CRUD 能力，无需编写 XML。
-
-### 2. EntityQueryAspect.java
-**位置**: `../assets/EntityQueryAspect.java`
-
-这是一个 AOP 切面，用于实现非侵入式的自动分页功能。
-
-**工作原理**:
-- **切点**: 拦截所有 Repository 层 (`@Repository`) 和 Gateway 实现层的方法。
-- **条件**: 方法参数中必须包含 `com.yss.cloud.dto.page.PageQuery` 对象。
-- **逻辑**:
-  1. 检查 `PageQuery` 参数是否非空。
-  2. 调用 `PageHelper.offsetPage(offset, pageSize)` 开启分页。
-  3. 执行目标方法。
-  4. 获取分页结果的总记录数 (`page.getTotal()`)。
-  5. 将总数回填到 `PageQuery.tempTotalCount` 字段中。
-
-### 3. MybatisBaseConfiguration.java
-**位置**: `../assets/MybatisBaseConfiguration.java`
-
-MyBatis 基础配置类，负责加载核心组件。
-
-**主要功能**:
-- **导入配置**: 导入了 `PageQueryEntityConfigration`，确保分页切面生效。
-- **启用属性**: 启用了 `PrimaryDataSourceProperties`, `MybatisPlusGlobalProperties`, `YssMybatisMapperProperties` 等配置属性类。
-
-### 4. PageQueryEntityConfigration.java
-**位置**: `../assets/PageQueryEntityConfigration.java`
-
-负责注册分页查询切面。
-
-**主要功能**:
-- 定义了 `entityQueryAspect` Bean，使其受 Spring 容器管理，从而激活自动分页拦截功能。
-
-## 使用建议
-
-当您在开发中使用通用 MyBatis 模式时：
-1. **定义 Repository**: 直接继承 `BaseRepository<Entity, ID>`。
-2. **分页查询**: 在方法参数中添加 `PageQuery`，框架会自动处理分页逻辑。
-3. **批量操作**: 使用 `insertList`, `updateList` 等方法进行高效的数据处理。

package/template/.qoder/skills/yss-repository/references/infrastructure-layer-guide.md

@@ -1,107 +0,0 @@
-# YSS Infrastructure Target Profile 指南
-
-本指南只定义 `target-domain-model + mybatis-plus`。历史 `Entity + DTO/VO Gateway` 为 `unsupported`，不存在旧架构 Profile。
-
-## 1. 职责
-
-- 实现既有 Domain Gateway，负责 Aggregate 持久化；不创建或改写 Gateway interface。
-- 实现 Application Query Port，负责分页、列表和读模型。
-- 定义 PO、MyBatis-Plus Repository/Mapper、XML 和数据源适配。
-- 通过 Spring MapStruct Bean 完成 `PO <-> Domain Model`、`PO -> Application Result`。
-
-Infrastructure 不拥有业务事务边界，不向 Application/Web 暴露 PO，也不直接生成 HTTP VO。
-
-## 2. 包结构
-
-```text
-{base_package}.infrastructure
-├── persistence
-│   ├── po
-│   ├── repository
-│   ├── convertor
-│   └── gateway
-└── query
-    ├── adapter
-    └── convertor
-```
-
-新脚手架固定使用 `{base_package}.infrastructure`。已有 `{base_package}.repository` 工程不由 scaffold 改写；需要现代化时单独立项。
-
-## 3. Domain Gateway 实现
-
-```java
-@Repository
-@RequiredArgsConstructor
-public class QualityTemplateGatewayImpl implements QualityTemplateGateway {
-    private final QualityTemplateRepository repository;
-    private final QualityTemplatePersistenceConvertor convertor;
-
-    @Override
-    public Optional<QualityTemplate> findById(QualityTemplateId id) {
-        return Optional.ofNullable(repository.selectById(id.value()))
-                .map(convertor::toDomain);
-    }
-
-    @Override
-    public void save(QualityTemplate aggregate) {
-        repository.insertOrUpdate(convertor.toPO(aggregate));
-    }
-}
-```
-
-GatewayImpl 不接收 Web Cmd/Query，不返回 VO/PageResult，不声明新的业务事务。
-
-## 4. Query Port 实现
-
-分页/列表属于 Application Query Port：
-
-```java
-@Repository
-@RequiredArgsConstructor
-public class QualityTemplateQueryAdapter implements QualityTemplateQueryPort {
-    private final QualityTemplateRepository repository;
-    private final QualityTemplateQueryConvertor convertor;
-
-    @Override
-    public PageResult<QualityTemplateResult> page(QualityTemplatePageQuery query) {
-        // orderBy/groupBy 必须先映射到批准列白名单，再构造 MyBatis 条件。
-        return convertor.toResultPage(repository.selectPage(...));
-    }
-}
-```
-
-`PageQuery` 可以在 Web/Application/Infrastructure 协作链使用，但不得进入 Domain。`orderBy` / `groupBy` 禁止直接拼接 SQL。
-
-## 5. PO 与 Repository
-
-- Target Profile 使用 `*PO`；旧式 `*Entity` 布局为 `unsupported`。
-- PO 默认使用最小 Lombok 注解，不无条件使用 `@Data`。
-- 当前实现继承项目既有 `BasePlusRepository<PO>`；普通 MyBatis 为 `unsupported`。
-- Mapper XML 位于项目既有扫描路径；扫描包和 XML 路径必须由集成测试证明。
-
-## 6. MapStruct
-
-```java
-@Mapper(componentModel = "spring")
-public interface QualityTemplatePersistenceConvertor {
-    QualityTemplate toDomain(QualityTemplatePO source);
-    QualityTemplatePO toPO(QualityTemplate source);
-}
-```
-
-- 禁止 `INSTANCE = Mappers.getMapper(...)`。
-- Convertor 使用构造器注入。
-- 父 POM 必须配置 `mapstruct-processor`、Lombok 和 `lombok-mapstruct-binding`。
-- 验证必须编译生成实现，不能只检查接口文本。
-
-## 7. 验证
-
-- Domain Gateway：保存后可通过 Gateway seam 重新加载等价 Aggregate。
-- Query Port：分页、total、排序白名单和空结果。
-- Mapper/Repository：实际 MyBatis-Plus/H2 或批准数据库 fixture。
-- Architecture：Infrastructure 可以依赖 Application/Domain；反向依赖必须失败。
-- 使用项目根 `./mvnw test/package` 留证。
-
-## 8. 旧架构边界
-
-检测到 Repository 直接接收 client Query、返回 VO、Convertor 做 `PO -> VO` 或使用旧式 Entity 布局时，返回 `unsupported`，不得由新 scaffold 自动改写。旧项目继续按原工程维护；现代化改造必须单独立项。

package/template/.trae/skills/yss-mybatis/assets/BaseRepository.java

@@ -1,112 +0,0 @@
-package com.yss.cloud.mybatis.support;
-
-import com.baomidou.mybatisplus.core.conditions.Wrapper;
-import com.baomidou.mybatisplus.core.toolkit.Constants;
-import io.mybatis.mapper.BaseMapper;
-import io.mybatis.mapper.list.ListMapper;
-import io.mybatis.mapper.list.ListProvider;
-import io.mybatis.provider.Caching;
-import com.baomidou.mybatisplus.core.mapper.Mapper;
-import org.apache.ibatis.annotations.*;
-
-import java.io.Serializable;
-import java.util.Collection;
-import java.util.List;
-import java.util.Map;
-
-/**
- * @author zhudaoming
- */
-public interface BaseRepository<T, D extends Serializable> extends Mapper<T>, BaseMapper<T, D>, ListMapper<T> {
-    /**s
-    /**
-     * 删除（根据ID或实体 批量删除）
-     *
-     * @param idList 主键ID列表或实体列表(不能为 null 以及 empty)
-     */
-    int deleteBatchIds(@Param(Constants.COLL) Collection<?> idList);
-    /**
-     * 查询（根据ID 批量查询）
-     *
-     * @param idList 主键ID列表(不能为 null 以及 empty)
-     */
-    List<T> selectBatchIds(@Param(Constants.COLL) Collection<? extends Serializable> idList);
-    /**
-     * 查询（根据 columnMap 条件）
-     *
-     * @param columnMap 表字段 map 对象
-     */
-    List<T> selectByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);
-    /**
-     * 根据 Wrapper 条件，查询全部记录
-     *
-     * @param queryWrapper 实体对象封装操作类（可以为 null）
-     */
-    List<Map<String, Object>> selectMaps(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
-
-    /**
-     * 根据 Wrapper 条件，查询全部记录
-     * <p>注意： 只返回第一个字段的值</p>
-     *
-     * @param queryWrapper 实体对象封装操作类（可以为 null）
-     */
-    List<Object> selectObjs(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
-    /**
-     * 保存实体，默认主键自增，并且名称为 id
-     * <p>
-     * 这个方法是个示例，你可以在自己的接口中使用相同的方式覆盖父接口中的配置
-     *
-     * @param entity 实体类
-     * @return 1成功，0失败
-     */
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @InsertProvider(type = EntityProvider.class, method = "insert")
-    <S extends T> int insert(S entity);
-
-    /**
-     * 保存实体中不为空的字段，默认主键自增，并且名称为 id
-     * <p>
-     * 这个方法是个示例，你可以在自己的接口中使用相同的方式覆盖父接口中的配置
-     *
-     * @param entity 实体类
-     * @return 1成功，0失败
-     */
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @InsertProvider(type = EntityProvider.class, method = "insertSelective")
-    <S extends T> int insertSelective(S entity);
-
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @InsertProvider(type = ListProvider.class, method = "insertList")
-    <S extends T> int insertList(@Param("entityList") List<S> entityList);
-
-    /**
-     * 批量更新
-     *
-     * @author dengsd
-     * @date 2022/9/27 11:49
-     */
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @UpdateProvider(type = ListProvider.class, method = "updateList")
-    <S extends T> int updateList(@Param("entityList") List<S> entityList);
-
-
-    /**
-     * 批量更新
-     *
-     * @author dengsd
-     * @date 2022/9/27 11:49
-     */
-    @Override
-    @Lang(Caching.class)
-    @Options(useGeneratedKeys = true)
-    @UpdateProvider(type = ListProvider.class, method = "updateListSelective")
-    <S extends T> int updateListSelective(@Param("entityList") List<S> entityList);
-}

package/template/.trae/skills/yss-mybatis/assets/EntityQueryAspect.java

@@ -1,37 +0,0 @@
-package com.yss.cloud.mybatis.aop;
-
-import com.github.pagehelper.Page;
-import com.github.pagehelper.PageHelper;
-import com.yss.cloud.dto.page.PageQuery;
-import lombok.SneakyThrows;
-import org.aspectj.lang.ProceedingJoinPoint;
-import org.aspectj.lang.annotation.Around;
-import org.aspectj.lang.annotation.Aspect;
-
-@Aspect
-public class EntityQueryAspect {
-
-    /**
-     * 字段开启分页的方法
-     *
-     * @apiNote 1. 包命名需符合规范 com.yss.datamiddle.(项目名).service?.impl.serviceImpl.method <br/> 2. 参数为pageQuery dto的方法
-     * @param joinPoint 加入切点
-     * @param pageQuery 查询分页对象dtp
-     * @return 执行结果
-     */
-    @Around("( (execution(public * (@org.springframework.stereotype.Repository *).*(..)) || execution(* com.yss..*.gateway.impl.*.*(..))))&& (args(pageQuery)||args(pageQuery,..))")
-    @SneakyThrows
-    public Object interceptEntityQueries(ProceedingJoinPoint joinPoint, PageQuery pageQuery) {
-        if (pageQuery != null) {
-            //分页查询开始
-            Page<Object> page = PageHelper.offsetPage(pageQuery.getOffset(), pageQuery.getPageSize());
-            // 继续执行目标方法
-            Object result = joinPoint.proceed();
-            long total = page.getTotal();
-            pageQuery.setTempTotalCount(total);
-            return result;
-        }
-        // 不满足条件时直接执行目标方法
-        return joinPoint.proceed();
-    }
-}

package/template/.trae/skills/yss-mybatis/assets/MybatisBaseConfiguration.java

@@ -1,18 +0,0 @@
-package com.yss.cloud.mybatis;
-
-import com.yss.cloud.mybatis.config.PageQueryEntityConfigration;
-import org.springframework.boot.context.properties.EnableConfigurationProperties;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Import;
-
-
-@Configuration
-@Import({
-        PageQueryEntityConfigration.class}
-)
-@EnableConfigurationProperties({PrimaryDataSourceProperties.class,
-        MybatisPlusGlobalProperties.class,
-        YssMybatisMapperProperties.class})
-public class MybatisBaseConfiguration {
-
-}

package/template/.trae/skills/yss-mybatis/assets/PageQueryEntityConfigration.java

@@ -1,18 +0,0 @@
-package com.yss.cloud.mybatis.config;
-
-import com.yss.cloud.mybatis.aop.EntityQueryAspect;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.springframework.context.annotation.Primary;
-
-@Configuration
-@Slf4j
-public class PageQueryEntityConfigration {
-    @Primary
-    @Bean
-    public EntityQueryAspect entityQueryAspect() {
-        log.info("【MapperConfiguration】DataSource 获取数据源primaryDataSourceProperties配置");
-        return new EntityQueryAspect();
-    }
-}

package/template/.trae/skills/yss-mybatis/references/README.md

@@ -1,57 +0,0 @@
-# 参考资料
-
-本文档详细介绍了 `yss-component-mybatis-starter` 模块中的核心类和配置类，这些类构成了通用 MyBatis 模式的基础。
-
-## 核心类 (Core Classes)
-
-### 1. BaseRepository.java
-**位置**: `../assets/BaseRepository.java`
-
-`BaseRepository<T, D>` 是通用 MyBatis 模式下的核心 Mapper 接口，所有业务 Repository 都应继承它。
-
-**主要特性**:
-- **继承链**: 继承了 `io.mybatis.mapper.BaseMapper` (基础 CRUD), `io.mybatis.mapper.list.ListMapper` (批量操作), 和 `com.baomidou.mybatisplus.core.mapper.Mapper` (兼容性)。
-- **通用方法**:
-  - `insert`, `update`, `delete`: 标准的单表操作。
-  - `selectBatchIds`, `deleteBatchIds`: 批量操作。
-  - `selectByMap`, `selectMaps`, `selectObjs`: 基于 Map 和 Wrapper 的查询。
-- **扩展点**: 允许用户通过继承此接口，获得开箱即用的 CRUD 能力，无需编写 XML。
-
-### 2. EntityQueryAspect.java
-**位置**: `../assets/EntityQueryAspect.java`
-
-这是一个 AOP 切面，用于实现非侵入式的自动分页功能。
-
-**工作原理**:
-- **切点**: 拦截所有 Repository 层 (`@Repository`) 和 Gateway 实现层的方法。
-- **条件**: 方法参数中必须包含 `com.yss.cloud.dto.page.PageQuery` 对象。
-- **逻辑**:
-  1. 检查 `PageQuery` 参数是否非空。
-  2. 调用 `PageHelper.offsetPage(offset, pageSize)` 开启分页。
-  3. 执行目标方法。
-  4. 获取分页结果的总记录数 (`page.getTotal()`)。
-  5. 将总数回填到 `PageQuery.tempTotalCount` 字段中。
-
-### 3. MybatisBaseConfiguration.java
-**位置**: `../assets/MybatisBaseConfiguration.java`
-
-MyBatis 基础配置类，负责加载核心组件。
-
-**主要功能**:
-- **导入配置**: 导入了 `PageQueryEntityConfigration`，确保分页切面生效。
-- **启用属性**: 启用了 `PrimaryDataSourceProperties`, `MybatisPlusGlobalProperties`, `YssMybatisMapperProperties` 等配置属性类。
-
-### 4. PageQueryEntityConfigration.java
-**位置**: `../assets/PageQueryEntityConfigration.java`
-
-负责注册分页查询切面。
-
-**主要功能**:
-- 定义了 `entityQueryAspect` Bean，使其受 Spring 容器管理，从而激活自动分页拦截功能。
-
-## 使用建议
-
-当您在开发中使用通用 MyBatis 模式时：
-1. **定义 Repository**: 直接继承 `BaseRepository<Entity, ID>`。
-2. **分页查询**: 在方法参数中添加 `PageQuery`，框架会自动处理分页逻辑。
-3. **批量操作**: 使用 `insertList`, `updateList` 等方法进行高效的数据处理。

package/template/.trae/skills/yss-repository/references/infrastructure-layer-guide.md

@@ -1,107 +0,0 @@
-# YSS Infrastructure Target Profile 指南
-
-本指南只定义 `target-domain-model + mybatis-plus`。历史 `Entity + DTO/VO Gateway` 为 `unsupported`，不存在旧架构 Profile。
-
-## 1. 职责
-
-- 实现既有 Domain Gateway，负责 Aggregate 持久化；不创建或改写 Gateway interface。
-- 实现 Application Query Port，负责分页、列表和读模型。
-- 定义 PO、MyBatis-Plus Repository/Mapper、XML 和数据源适配。
-- 通过 Spring MapStruct Bean 完成 `PO <-> Domain Model`、`PO -> Application Result`。
-
-Infrastructure 不拥有业务事务边界，不向 Application/Web 暴露 PO，也不直接生成 HTTP VO。
-
-## 2. 包结构
-
-```text
-{base_package}.infrastructure
-├── persistence
-│   ├── po
-│   ├── repository
-│   ├── convertor
-│   └── gateway
-└── query
-    ├── adapter
-    └── convertor
-```
-
-新脚手架固定使用 `{base_package}.infrastructure`。已有 `{base_package}.repository` 工程不由 scaffold 改写；需要现代化时单独立项。
-
-## 3. Domain Gateway 实现
-
-```java
-@Repository
-@RequiredArgsConstructor
-public class QualityTemplateGatewayImpl implements QualityTemplateGateway {
-    private final QualityTemplateRepository repository;
-    private final QualityTemplatePersistenceConvertor convertor;
-
-    @Override
-    public Optional<QualityTemplate> findById(QualityTemplateId id) {
-        return Optional.ofNullable(repository.selectById(id.value()))
-                .map(convertor::toDomain);
-    }
-
-    @Override
-    public void save(QualityTemplate aggregate) {
-        repository.insertOrUpdate(convertor.toPO(aggregate));
-    }
-}
-```
-
-GatewayImpl 不接收 Web Cmd/Query，不返回 VO/PageResult，不声明新的业务事务。
-
-## 4. Query Port 实现
-
-分页/列表属于 Application Query Port：
-
-```java
-@Repository
-@RequiredArgsConstructor
-public class QualityTemplateQueryAdapter implements QualityTemplateQueryPort {
-    private final QualityTemplateRepository repository;
-    private final QualityTemplateQueryConvertor convertor;
-
-    @Override
-    public PageResult<QualityTemplateResult> page(QualityTemplatePageQuery query) {
-        // orderBy/groupBy 必须先映射到批准列白名单，再构造 MyBatis 条件。
-        return convertor.toResultPage(repository.selectPage(...));
-    }
-}
-```
-
-`PageQuery` 可以在 Web/Application/Infrastructure 协作链使用，但不得进入 Domain。`orderBy` / `groupBy` 禁止直接拼接 SQL。
-
-## 5. PO 与 Repository
-
-- Target Profile 使用 `*PO`；旧式 `*Entity` 布局为 `unsupported`。
-- PO 默认使用最小 Lombok 注解，不无条件使用 `@Data`。
-- 当前实现继承项目既有 `BasePlusRepository<PO>`；普通 MyBatis 为 `unsupported`。
-- Mapper XML 位于项目既有扫描路径；扫描包和 XML 路径必须由集成测试证明。
-
-## 6. MapStruct
-
-```java
-@Mapper(componentModel = "spring")
-public interface QualityTemplatePersistenceConvertor {
-    QualityTemplate toDomain(QualityTemplatePO source);
-    QualityTemplatePO toPO(QualityTemplate source);
-}
-```
-
-- 禁止 `INSTANCE = Mappers.getMapper(...)`。
-- Convertor 使用构造器注入。
-- 父 POM 必须配置 `mapstruct-processor`、Lombok 和 `lombok-mapstruct-binding`。
-- 验证必须编译生成实现，不能只检查接口文本。
-
-## 7. 验证
-
-- Domain Gateway：保存后可通过 Gateway seam 重新加载等价 Aggregate。
-- Query Port：分页、total、排序白名单和空结果。
-- Mapper/Repository：实际 MyBatis-Plus/H2 或批准数据库 fixture。
-- Architecture：Infrastructure 可以依赖 Application/Domain；反向依赖必须失败。
-- 使用项目根 `./mvnw test/package` 留证。
-
-## 8. 旧架构边界
-
-检测到 Repository 直接接收 client Query、返回 VO、Convertor 做 `PO -> VO` 或使用旧式 Entity 布局时，返回 `unsupported`，不得由新 scaffold 自动改写。旧项目继续按原工程维护；现代化改造必须单独立项。

package/template/docs/discovery/README.md

@@ -1,87 +0,0 @@
-# 发现阶段 (Discovery) — 市场分析 · 竞品分析 · 用户洞察
-
-> **Phase 0 — 需求分析的前置输入。**
-
----
-
-## 工作流
-
-Discovery 不是固定排在 Ideation 后面的单向步骤。它和机会构想共同组成“机会探索环”，用于把事实、假设和 MVP 边界来回校准：
-
-```
-市场 / 竞品 / 用户事实 <-> 机会构想假设 <-> MVP 边界
-```
-
-进入 Spec 前必须收敛为：
-
-- 用户是谁。
-- 痛点是什么。
-- 为什么现在做。
-- 第一版做什么。
-- 明确不做什么。
-- 成功标准是什么。
-- 产品功能建设方向是什么。
-- 后续可能影响哪些 UI、API、数据、权限、架构和安全门禁。
-
-常见入口：
-
-- 只有模糊想法：先机会构想，再用市场、竞品和用户洞察验证。
-- 已有行业、竞品或用户材料：先用 `competitive-intelligence` 整理 Discovery 事实，再生成候选方案。
-- 明确 Bug 或小调整：不走完整 Discovery，直接进入 hotfix / tweak。
-
----
-
-## 市场分析
-
-### 数据源
-- 行业报告、上市公司财报、政府数据、投资机构研报
-
-### 产出物
-- 市场总览报告 / 规模与增长预测 / 趋势洞察
-
----
-
-## 竞品分析
-
-推荐优先使用 `competitive-intelligence`，把公开证据、事实 / 推断、置信度和 Spec 输入分开记录。竞品分析结论只能作为 Discovery / Spec 输入，不能直接冻结为需求。
-
-### 分析维度
-产品功能 / 用户体验 / 技术能力 / 商业模式 / 用户口碑 / 市场表现
-
-### 产出物
-- 竞品情报简报 / 竞品功能矩阵 / 竞品深度分析 / 差异化机会清单 / 产品功能指引输入
-
----
-
-## 用户洞察
-
-### 数据源
-- 应用商店评论 / 社交媒体 / 客服社区 / 行业报告
-
-### 产出物
-- 用户画像 / 用户旅程地图 / 痛点优先级清单
-
----
-
-## Discovery 收敛产物
-
-Discovery 的结论用于影响 Spec、功能架构、产品设计、API 和架构阶段，但不替代这些阶段的正式产物。
-
-- 机会说明。
-- MVP 范围和非目标范围。
-- 产品功能指引 / 能力候选地图。
-- 下游影响清单：UI、API、数据、权限、外部系统、发布回滚和风险 / 回滚约束。
-
----
-
-## 商业论证
-
-### AI Agent 任务
-```python
-delegate_task(
-    goal="基于市场分析和竞品分析，生成商业论证草案",
-    context="""
-    输出：机会陈述 / 目标用户群 / 价值主张 / 商业模式 / 核心指标 / 风险评估
-    """
-)
-```