sdd-full 4.8.0 → 4.8.1

package/skills/requirement-analysis/sdd/mock_sdd.md

@@ -0,0 +1,156 @@
+# 移动端Mock开发SDD独立技能（可嵌入核心流程版）
+
+【技能标识】：sdd-mobile-mock-independent
+
+【核心定位】：独立技能，专门负责核心流程第4步“拆SDD”的Mock开发专项落地，可无缝嵌入 **大需求 → 第0步：Epic拆分（超大需求适用）→ 第0.5步：拆用户故事 → 第1步：拆UI设计 → 第2步：拆前后端分离架构 → 第3步：拆数据库+接口 → 第4步：拆SDD** 全流程，承接前序3步输出，产出子代理可直接消费的Mock开发SDD功能规格，核心支撑“移动端独立开发、不依赖后端”的Mock开发目标。
+
+【适配场景】：适配Superpowers/Trae-CN全流程开发，支持个人开发，兼容Flutter/React Native/Android/iOS所有移动端技术栈，可独立调用（仅执行第4步Mock SDD拆分）或嵌入完整流程（跟随前序步骤联动）。
+
+---
+
+## 一、技能核心目标
+
+- 承接核心流程第3步“拆数据库+接口”的产出（数据库表结构、接口契约），完成Mock开发专项的SDD功能规格拆分，不依赖前序步骤的额外开发，仅需前序产出物作为输入。
+
+- 产出标准化、可落地、子代理可直接执行的Mock开发SDD文档，覆盖Mock工具集成、假数据编写、拦截逻辑、环境切换等全流程，确保与前序接口契约、数据库结构完全一致。
+
+- 保持与核心流程的连贯性，既作为独立技能可单独调用，也可嵌入完整流程，成为第4步“拆SDD”的专属落地能力，不破坏原有流程逻辑。
+
+- 适配个人开发场景，简化Mock SDD拆分复杂度，兼顾敏捷迭代与架构规范，确保Mock开发与移动端业务开发、后端开发的边界清晰。
+
+## 二、嵌入核心流程的衔接规则（关键）
+
+本技能作为核心流程第4步“拆SDD”的专属实现，与前序步骤的衔接严格遵循以下规则，确保无缝嵌入、不脱节：
+
+### 1. 前置依赖（必须满足，否则无法启动本技能）
+
+需获取核心流程前3步的明确产出物，作为本技能的输入依据（缺一不可）：
+
+- 第1步产出：UI页面清单（含Mock数据依赖，明确各页面所需Mock数据字段、类型）
+
+- 第2步产出：前后端分离架构文档（明确Mock开发与业务开发、后端开发的职责边界）
+
+- 第3步产出：数据库表结构（Mock假数据字段参考）、接口契约（Mock开发的唯一标准）
+
+### 2. 流程衔接节点
+
+```plaintext
+
+核心流程前3步完成 → 启动本Mock SDD独立技能（第4步：拆SDD）→ 产出Mock开发SDD功能规格 → 子代理执行Mock开发 → 衔接后续环境切换测试、上线准备
+
+```
+
+### 3. 与前序步骤的联动要求
+
+- Mock SDD拆分必须严格对齐第3步的接口契约，所有Mock相关的功能规格、数据格式，均以接口契约为唯一标准，不允许出现偏差。
+
+- Mock SDD中涉及的Mock数据字段，需与第3步数据库表结构、第1步UI页面Mock数据依赖保持一致，确保端到端数据对齐。
+
+- Mock SDD中明确的Mock开发职责，需契合第2步前后端分离架构的边界定义，不越界、不侵入业务代码与后端开发范围。
+
+- 若前序步骤（如接口契约、数据库结构）发生变更，本技能可单独启动，同步更新Mock SDD规格，无需重新执行完整核心流程。
+
+### 4. 对后续流程的支撑
+
+本技能产出的Mock开发SDD，将直接作为子代理执行Mock开发的唯一依据，支撑后续：
+
+- 子代理按SDD规格集成Mock工具、编写假数据、开发拦截逻辑与环境开关；
+
+- 按SDD中的验收标准，完成Mock功能的测试验收；
+
+- 切换真实接口时，按SDD中的契约对齐要求，快速适配后端真实接口，实现无缝联调。
+
+## 三、技能核心功能（第4步：Mock SDD拆分全流程）
+
+本技能独立实现“拆Mock开发SDD”的完整功能，输出标准化SDD文档，核心分为5个拆分环节，每个环节均贴合前序输入，确保可落地、可执行：
+
+### 1. 契约对齐校验（前置环节）
+
+接收第3步接口契约、数据库表结构，自动校验两者的一致性，输出校验报告，确保Mock SDD拆分的基础无误：
+
+- 校验接口契约中的响应字段，是否与数据库表结构中的字段名称、类型一致；
+
+- 校验UI页面所需Mock数据字段，是否完全覆盖接口契约中的响应字段；
+
+- 校验异常场景（接口报错、空数据）的契约定义，是否完整，为后续Mock异常场景开发提供依据。
+
+### 2. Mock工具与技术选型SDD拆分
+
+结合第2步前后端分离架构中的技术选型，拆分Mock工具集成的详细规格，明确每类移动端技术栈的具体实现要求，子代理可直接参照执行：
+
+|移动端技术栈|Mock工具集成规格|SDD具体要求（子代理可直接执行）|
+|---|---|---|
+|Flutter|dio_mock_adapter 集成|1. 集成版本：dio_mock_adapter: ^0.5.0；2. 配置路径：mock/adapter/flutter_mock_adapter.dart；3. 拦截范围：仅拦截第3步契约中定义的接口URL|
+|React Native|axios-mock-adapter 集成|1. 集成版本：axios-mock-adapter: ^1.22.0；2. 配置路径：mock/adapter/rn_mock_adapter.js；3. 与axios版本适配：axios: ^1.6.0|
+|Android（原生）|OkHttp 拦截器|1. 拦截器类路径：com.mock.interceptor.OkHttpMockInterceptor；2. 配置方式：在OkHttpClient中添加拦截器，仅开发环境启用|
+|iOS（原生）|Alamofire 拦截器|1. 拦截器类：AlamofireMockInterceptor；2. 配置：通过RequestAdapter实现拦截，区分Mock/真实环境|
+### 3. 假数据编写SDD拆分
+
+基于第3步数据库表结构、接口契约，以及第1步UI页面Mock数据依赖，拆分假数据编写的详细规格，明确生成规则、字段对应关系、场景覆盖，确保假数据贴近真实业务且符合契约要求：
+
+- 假数据生成工具：按技术栈对应配置（Flutter用faker、React Native用mockjs等），SDD中明确工具版本、调用路径；
+
+- 字段对应规则：明确数据库表字段与接口响应字段的映射关系，以及Mock假数据的生成规则（如user表avatar字段，生成固定格式URL或随机URL）；
+
+- 场景覆盖要求：SDD中明确需覆盖的场景（正常数据、异常数据、边界数据），每个场景的假数据示例、生成逻辑；
+
+- 可维护性要求：假数据生成逻辑独立封装，拆分出可复用的假数据生成方法，SDD中明确方法名称、参数、返回值。
+
+### 4. 拦截逻辑与环境开关SDD拆分
+
+结合第2步架构边界定义，拆分Mock请求拦截逻辑与环境切换开关的开发规格，确保Mock与真实接口的切换无缝、不侵入业务代码：
+
+- 拦截逻辑：SDD中明确拦截的接口URL（与第3步契约完全一致）、拦截优先级、响应时间要求（≤100ms）、拦截失败处理方案；
+
+- 环境开关：明确开关的开发位置、切换逻辑、状态存储方式（如本地缓存），SDD中包含开关的代码示例、调用方式；
+
+- 隔离要求：明确Mock代码的存放路径（如mock/目录），与业务代码的隔离规则，SDD中明确目录结构、文件命名规范。
+
+### 5. 验收标准与子代理交付SDD拆分
+
+拆分Mock开发的验收标准与子代理交付要求，确保子代理开发完成后可直接验收，交付物符合Superpowers/Trae-CN工作流要求：
+
+- 验收标准：分功能验收（拦截有效性、假数据一致性、环境切换功能）、非功能验收（响应时间、代码隔离性），SDD中明确每条标准的验证方法；
+
+- 交付物清单：SDD中明确子代理需交付的文件（Mock代码、假数据生成工具配置、环境开关代码、验收报告）；
+
+- 合规性要求：明确Mock SDD需符合Superpowers/Trae-CN的子代理驱动开发规范，SDD文档格式、内容需满足子代理消费要求。
+
+## 四、技能输出物（标准化，子代理可直接消费）
+
+本技能启动后，输出1份标准化Mock开发SDD文档，路径固定为 `docs/sdd/mock_sdd.md`，包含以下核心模块，完全适配核心流程第4步的产出要求：
+
+1. 前置依赖说明（关联核心流程前3步的产出物，明确校验结果）；
+
+2. Mock工具集成规格（按技术栈拆分，含版本、配置、路径）；
+
+3. 假数据编写规格（字段映射、生成规则、场景覆盖、示例）；
+
+4. 拦截逻辑与环境开关规格（拦截规则、开关实现、代码隔离）；
+
+5. 验收标准（功能+非功能，含验证方法）；
+
+6. 子代理交付要求（交付物清单、合规性要求）；
+
+7. 版本管理规则（与前序契约版本联动，变更同步机制）。
+
+## 五、技能使用说明（嵌入核心流程/独立调用）
+
+### 1. 嵌入核心流程使用（推荐）
+
+跟随核心流程执行，当完成第3步“拆数据库+接口”后，直接启动本技能，自动读取前序3步的产出物，完成第4步Mock SDD拆分，无需额外输入，流程连贯无冗余。
+
+### 2. 独立调用使用
+
+若仅需单独拆分Mock SDD（如前序步骤已完成，需更新Mock SDD），可直接启动本技能，手动输入前序3步的产出物（UI页面清单、架构文档、数据库/契约），即可完成SDD拆分，不影响核心流程的其他步骤。
+
+## 六、与核心流程的适配保障
+
+- 版本联动：本技能的SDD版本与第3步接口契约版本保持一致，契约更新时，Mock SDD可同步更新，确保一致性；
+
+- 粒度适配：Mock SDD的拆分粒度，与第0.5步用户故事的粒度对齐，按用户故事优先级，分批拆分Mock SDD，适配个人敏捷工作流；
+
+- 边界一致：严格遵循第2步前后端分离架构的边界定义，Mock SDD中不包含任何业务逻辑、后端开发相关内容，确保不越界；
+
+- 工具适配：适配Superpowers/Trae-CN的子代理驱动开发，SDD规格可直接被子代理消费，无需二次转换。
+> （注：文档部分内容可能由 AI 生成）