adspecs 0.1.12

package/skills/adspecs-plan/SKILL.md

@@ -0,0 +1,429 @@
+---
+name: "adspecs-plan"
+description: "基于 PRD 文件一次性完成需求分析与系统设计（OOA+OOD），输出统一设计文档（_system-design.md）和建表 SQL（_schema.sql）"
+argument-hint: "指定 PRD 文件路径，如 docs/20-prd/crm/sales-forecast/M06-01_销售预测需求规格说明书.md"
+compatibility: "需要 docs/ 目录体系，含 03-系统设计模板.md v1.2、项目约定文档、ECP 编码规范"
+metadata:
+  author: "qingwen"
+user-invocable: true
+disable-model-invocation: false
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+**必须** 在继续之前考虑用户输入（如果非空）。
+
+## 路径配置加载
+
+在开始执行之前，先确定输入/输出目录：
+
+1. 检查项目根目录是否存在 `.adspecs/paths.json`
+2. 如果存在，读取其中的 `paths` 对象，提取本技能需要的配置键
+3. 如果不存在或配置键缺失，使用下方表格中的默认值
+
+| 配置键       | 默认值                  | 用途                            |
+| ------------ | ----------------------- | ------------------------------- |
+| `prd_dir`    | `docs/20-prd`           | PRD 文件所在目录（输入）        |
+| `design_dir` | `docs/30-system-design` | 系统设计文档和建表 SQL 输出目录 |
+
+将解析后的路径分别记为 `PRD_DIR` 和 `DESIGN_DIR`，后续步骤中引用这些变量而非硬编码路径。
+
+## 任务
+
+读取用户指定的 PRD 文件（`{PRD_DIR}/`），一次性完成系统设计（OOD），生成 **2 个输出**：
+
+1. **统一系统设计文档**（`.md`）— 按 `03-系统设计模板.md` v1.2 单阶段 13 部分生成，覆盖 OOA+OOD 全部内容
+2. **建表 SQL**（`.sql`）— 完整 DDL，遵循 ECP 审计字段规范（经 Liquibase 管理）
+
+## 输入
+
+### 必读文件（按顺序）
+
+| 序号 | 文件                                                                          | 用途                                                                     |
+| ---- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| 1    | `{PRD_DIR}/{用户指定的 PRD 文件}`                                             | 需求来源 — 提取用户故事（US-ID）、业务规则（BR-ID）、功能清单、验收标准  |
+| 2    | `CLAUDE.md`                                                                   | 项目技术栈、模块结构、ECP 编码约定                                       |
+| 3    | `.adspecs/templates/03-系统设计模板.md`                                       | **统一设计模板 v1.2**（单阶段 13 部分，含 gushen-demo 角色管理填写示例） |
+| 4    | `docs/40-project_conventions/end-integration/后端分层开发与数据库设计规范.md` | ECP 编码规范：Entity/DTO/Ro/DAO+XML/Service/Controller 标准              |
+| 5    | `docs/40-project_conventions/end-integration/多语言及全局异常处理规范.md`     | 错误码格式、ResponseMsgCode 枚举、i18n 文件规范                          |
+| 6    | `docs/40-project_conventions/end-integration/Liquibase 数据库变更管理规范.md` | 建表 SQL 规范（DDL/DML 幂等、changeset 命名）                            |
+
+### 参考文件（按需）
+
+- `gushen-demo/` 参考代码 — 已有的包路径、基类、IotBaseRole 标准写法范例
+- `{PRD_DIR}/` 下的其他 PRD 文件 — 了解关联模块的业务
+
+## 执行前检查
+
+**检查扩展钩子（规划前）**:
+
+- 检查项目根目录是否存在 `.adspecs/extensions.yml`。
+- 如果存在，读取它并查找 `hooks.before_plan` 下的条目。
+- 如果 YAML 无法解析或无效，静默跳过钩子检查并继续正常执行。
+- 过滤掉 `enabled` 明确为 `false` 的钩子。没有 `enabled` 字段的钩子默认视为启用。
+- 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
+  - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
+  - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
+  - **可选钩子** (`optional: true`):
+
+    ```
+    ## 扩展钩子
+
+    **可选前置钩子**: {extension}
+    命令: `/{command}`
+    描述: {description}
+
+    提示: {prompt}
+    执行: `/{command}`
+    ```
+
+  - **必选钩子** (`optional: false`):
+
+    ```
+    ## 扩展钩子
+
+    **自动前置钩子**: {extension}
+    执行: `/{command}`
+    EXECUTE_COMMAND: {command}
+
+    等待钩子命令结果后再继续执行。
+    ```
+
+- 如果没有注册钩子或 `.adspecs/extensions.yml` 不存在，静默跳过。
+
+1. **解析用户输入**：
+   - 如果 `$ARGUMENTS` 是文件路径（以 `docs/` 或 `/` 开头，或以 `.md` 结尾）→ 读取该文件作为需求描述
+   - 如果 `$ARGUMENTS` 是自然语言描述 → 直接使用
+   - 如果 `$ARGUMENTS` 为空 → 使用 **AskUserQuestion** 工具提示用户输入需求描述
+
+2. **加载模板**：
+   - 读取 `.adspecs/templates/03-系统设计模板.md`，获取系统设计的完整结构
+   - 如果模板不存在，使用内置的分析结构（见下方"## 工作流程"）
+
+3. **加载项目上下文**（可选）：
+   - 如果 `CLAUDE.md` 存在，读取以了解项目背景
+   - 如果 `docs/{PRD_DIR}/` 下有相关文档，读取以补充需求背景
+
+4. **识别二级模块**：
+   - 扫描 `{ARCH_DIR}/` 目录，查找 `01-*_business_scenarios.md` 或 `01-*_business_architecture.md` 文件（业务功能架构文档，两者命名均可能出现）
+   - 如果找到，读取文件内容，重点关注：
+     - **二、系统模块总览** → **2.2 子模块清单**：获取所有主模块（M00~M{N}）及其下属的二级模块（子模块，编号格式如 M03-01、M03-02、SYS-01 等）
+     - **三、各模块业务场景详述**：获取每个模块的业务场景描述（S-M{XX}-{YY} 系列）
+   - 将需求描述内容与各二级模块的名称、说明、业务场景进行语义匹配，确定需求最匹配的**二级模块编号**（如 M03-02）
+   - 匹配规则：
+     1. **精确匹配**：需求描述中明确提到某个子模块名称或编号 → 直接采用
+     2. **场景匹配**：需求描述的业务场景与某个模块下的场景（S-M{XX}-{YY}）高度吻合 → 采用该子模块编号
+     3. **语义匹配**：需求描述的核心功能与某个子模块的"说明"字段语义相近 → 采用该子模块编号
+     4. **无法匹配**：需求内容与任何二级模块都不匹配 → 使用 AskUserQuestion 让用户从二级模块列表中选择，或标记为"新模块"
+   - 将匹配到的二级模块编号记为 `MODULE_ID`（如 `M03-02`），对应的主模块编号记为 `PARENT_MODULE`（如 `M03`）
+   - 如果架构文档不存在，跳过此步骤，`MODULE_ID` 留空，输出目录不包含模块子目录
+
+5. **确定输出路径**：
+   - 输出根目录：`{OUTPUT_DIR}/`（由路径配置加载阶段解析，默认 `docs/{DESIGN_DIR}/`）
+   - 如果 `MODULE_ID` 已识别（非空）：
+     - 输出子目录：`{OUTPUT_DIR}/{MODULE_ID}/`（如 `docs/{DESIGN_DIR}/M03-02/`）
+     - 如果子目录不存在，自动创建
+   - 如果 `MODULE_ID` 为空（架构文档不存在或无法匹配）：
+     - 直接使用 `{OUTPUT_DIR}/` 作为输出目录（兼容旧行为）
+   - 输出文件名：基于需求描述生成简洁名称，格式 `{short-name}_系统设计.md`
+   - 完整输出路径示例：
+     - 有模块：`docs/{DESIGN_DIR}/M03-02/customer-management_系统设计.md`
+     - 无模块：`docs/{DESIGN_DIR}/customer-management_系统设计.md`
+   - 如果目录下已有同名文件，询问用户是覆盖还是重命名,还是新增版本号格式如下：
+     - 有模块：`docs/{DESIGN_DIR}/M03-02/{MODULE_ID}_{short-name}_系统设计_v{version}.md`
+     - 无模块：`docs/{DESIGN_DIR}/{short-name}_系统设计_v{version}.md`
+   - 将解析后的路径持久化到 `.adspecs/feature.json`（多功能注册表格式）：
+
+     ```json
+     {
+       "active": "<resolved feature dir>",
+       "endDesigns": [
+         {
+           "id": "<功能ID>",
+           "directory": "<resolved feature dir>",
+           "filename": "<resolved feature filename>",
+           "name": "<功能名称>",
+           "status": "drafting",
+           "created": "<DATE>"
+         }
+       ]
+     }
+     ```
+
+     **操作方式**:
+     1. 读取现有的 `.adspecs/feature.json`（如存在）
+     2. 将新功能追加到 `endDesigns` 数组（若 directory 已存在则跳过，避免重复）
+     3. 将 `active` 更新为当前功能目录
+     4. 写入文件（使用 2-space 缩进以保证可读性）
+
+     写入实际的解析后目录路径值（例如 `{OUTPUT_DIR}/003-user-auth`），而非字面字符串 `ADSPECS_FEATURE_DIRECTORY`。
+     这允许下游命令（`/adspecs-tasks` 等）通过 `active` 字段定位当前功能目录，而无需依赖 git 分支名称约定。
+
+     **注意**: 不要在功能目录下创建 `feature.json` 文件——所有功能追踪统一在 `.adspecs/feature.json` 中管理。
+
+**兼容性检查**：
+
+- 如果 `.adspecs/extensions.yml` 中存在 `before_require_analysis`、`after_require_analysis`、`before_systemdesign`、`after_systemdesign` 等旧钩子条目，输出警告建议用户更新为 `before_plan` / `after_plan`。
+
+## 工作流程
+
+### 阶段 0：初始化与上下文加载
+
+#### 0.1 解析 PRD
+
+读取用户指定的 PRD 文件，提取：
+
+- **需求 ID 映射** → US/BR/FUNC/PERM 编号与 PRD 位置对应关系
+- **模块上下文** → 模块定位、上下游依赖、上下文边界、核心职责
+- **用户故事与验收场景** → 故事描述、优先级、Given-When-Then 验收条件
+- **业务实体** → 识别所有实体名称、属性、关系
+- **业务行为** → 触发方、业务规则（引用 BR-ID）、前后置条件
+- **接口定义** → 请求方式、路径、权限、入参、出参
+- **状态机** → 状态定义与流转规则（来自 PRD §3.5）
+- **枚举与数据字典** → 枚举值列表、数据校验规则
+- **异常场景** → 错误码、触发条件
+
+#### 0.2 加载模板和约定
+
+按上表序号 2-7 依次读取必读文件。重点理解：
+
+- `03-系统设计模板.md`的 13 个部分结构（§1~§13 必填）及填写示例
+- **ECP 平台核心约定**：
+  - **Entity**: 继承 `BaseEntity<T>`，`@TableName` 反引号，每字段 `@TableField` + `@Schema`，主键 `Long` + `IdType.ASSIGN_ID`。**BaseEntity 已含审计字段，Entity 中禁止重复声明**
+  - **DTO**: 继承 `ReqeustCommonDataBean`（注意平台拼写），Date 字段 `@JSONField(format = "yyyy-MM-dd HH:mm:ss")`，校验分组为 DTO 内部接口
+  - **Ro**: 简单 POJO + `implements Serializable` + `serialVersionUID`，手动声明所有字段，位于 `model/entity/readonly/`
+  - **DAO**: 继承 `BaseCommonDAO_HI`，**所有 SQL 通过 MyBatis XML，禁止 QueryWrapper/LambdaQueryWrapper**
+  - **Service**: 接口 `II{Entity}`（双 I 前缀），实现 `@Component("{camel}Service")` 继承 `BaseCommonServer`
+  - **Controller**: 继承 `CommonAbstractService`，重写 `getBaseCommonServer()`，标准 5 端点，全端点 `@CheckToken`
+  - **Save 用 FastJSON**: `JSONObject.parseObject(JSONObject.toJSONString(dto), Entity.class)`
+  - **Update 用 Spring BeanUtils**: `BeanUtils.copyProperties(dto, entity, "createdBy", "creationDate", "versionNum")`
+  - **子表更新**: 先删后增策略 — `deleteBy{父}Id(id)` → `saveListBy{父}Id(id, list)`
+  - **异常在 Service 层抛出**（`RecordNotExistsException`、`GushenRuntimeException`），Controller 仅做参数空校验
+  - **错误码格式**: `{port}_{table_snake}_{三位序号}`，定义在 `ResponseMsgCode` 枚举中，**禁止硬编码字符串**
+  - **注入方式**: `@Autowired` + `@Component("{camel}Name")`
+  - **表规范**: `delete_flag` 默认 0，`version_num` 默认 0，不使用外键，主键雪花 ID
+
+---
+
+### 阶段 1：按 04 号模板 §1~§10 生成统一设计文档
+
+> **关键原则**：每个部分从"分析"直接落地到"设计"，不再分两个阶段来回切换。同一实体字段只在 §2 定义一次，§3 直接引用；同一接口只在 §5 定义一次。
+
+#### §1 需求 ID 映射与模块上下文（必填，分析）
+
+从 PRD 提取：
+
+- US/BR/FUNC/PERM 编号 → 映射表（ID、PRD 位置、简述）
+- 模块名称、描述、所属分层
+- 上游依赖 / 下游调用 / 外部集成
+- 核心职责列表
+
+#### §2 业务实体与领域对象（必填，分析→设计）
+
+从 PRD 业务实体中直接落地为三类对象的完整字段表：
+
+- **Entity 字段表**：Java 类型、DB 类型、长度、必填、默认值、注解、说明。审计字段继承自 BaseEntity，禁止重复声明
+- **DTO 字段表**：校验注解、必填、说明。标注 `extends ReqeustCommonDataBean`，验证分组 `save{Entity}` / `update{Entity}`
+- **Ro 字段表**：Java 类型、注解（`@DateTimeFormat` + `@JsonFormat`）、说明。标注 `implements Serializable` + `serialVersionUID`
+
+**每个实体标注来源需求 ID、表名（反引号）、主键（ASSIGN_ID）、索引、关联关系。**
+
+#### §3 数据模型（必填，设计）
+
+基于 §2 的实体定义：
+
+- 绘制 Mermaid classDiagram（标注 1:N 等关系基数）
+- 完整的 DDL 字段表（含 ECP 8 个审计字段：tenant_id / creation_date / created_by / last_update_date / last_updated_by / last_update_login / delete_flag / version_num）
+- MyBatis XML 结构（BaseResultMap、Base_Column_List、BASE_QUERY_CONDITION、findPagination，含 `WHERE delete_flag = 0`）
+- DAO 接口定义（类路径、继承、自定义方法签名）
+
+#### §4 业务行为与 Service 设计（必填，分析→设计）
+
+- 业务行为清单（行为名称、来源需求、触发方、业务规则[引用 BR-ID]、前置/后置条件）
+- Mermaid flowchart 业务流程图
+- Mermaid stateDiagram 状态机图（如有状态流转）
+- Service 接口方法表（方法签名、入参、出参、事务标注）
+- Service 实现伪代码（save/update/delete 的关键步骤 + FastJSON/BeanUtils 转换说明）
+- 事务边界汇总表（哪些方法需 `@Transactional(rollbackFor = Exception.class)`）
+
+#### §5 接口与 Controller 设计（必填，设计）
+
+- 标准 5 端点 + 自定义端点清单（HTTP 方法、路径、说明、请求/响应包装、校验分组）
+- Controller 完整 Java 代码骨架（`@Tag`、`@RestController`、`CommonAbstractService`、`@CheckToken`、`ResponseData`）
+- 权限矩阵
+
+#### §6 枚举与数据字典（必填，分析→设计）
+
+- 枚举值定义表（枚举值、编码、显示名称、说明、使用场景），标注存储类型和类路径
+- 数据校验规则表（数据项、Java 类型、必填、取值范围、校验注解、消息码）
+
+#### §7 异常处理（必填，分析→设计）
+
+- 业务异常清单表（异常名称、来源需求、消息码、触发条件、抛出方式、抛出位置）
+- Mermaid flowchart 异常处理流程图
+- 消息码汇总（properties 格式示例）
+
+#### §8 缓存与性能（必填）
+
+- 仅当有明确缓存需求时填写，使用 DawnRedis + ICacheKey
+- 并发控制策略（乐观锁 version_num + 分布式锁 @Klock）
+
+#### §9 测试场景（必填）
+
+- 正常/异常/边界场景各至少 2 条（场景名称、前置条件、操作步骤、预期结果）
+
+#### §10 总结（选填）
+
+- 设计成果统计
+- 关键设计决策
+- 后续工作清单
+- 关键注意事项
+
+---
+
+### 阶段 2：生成建表 SQL
+
+按 `Liquibase 数据库变更管理规范.md` 规范生成：
+
+- SQL 文件头含 `--liquibase formatted sql` 和 changeset 注释
+- 每张表包含完整业务字段 + ECP 标准审计字段（8 个）
+- 每列必须带 `COMMENT`
+- `delete_flag` 默认 0，`version_num` 默认 0
+- 索引命名：`uk_{table}_{field}`（唯一）、`idx_{field}`（普通）
+- 不使用外键约束
+- DDL/DML 必须幂等：`CREATE TABLE IF NOT EXISTS` / `REPLACE INTO`
+
+---
+
+### 阶段 3：保存与报告
+
+#### 3.1 保存文件
+
+| 产物         | 命名规则                               | 保存路径                   |
+| ------------ | -------------------------------------- | -------------------------- |
+| 统一设计文档 | `{模块编号}-{模块名}_system-design.md` | `{DESIGN_DIR}/{crm\|mom}/` |
+| 建表 SQL     | `{模块编号}-{模块名}_schema.sql`       | `{DESIGN_DIR}/{crm\|mom}/` |
+
+#### 3.2 Agent 上下文更新
+
+将 `CLAUDE.md` 中 `<!-- SPECKIT START -->` 和 `<!-- SPECKIT END -->` 标记之间的内容更新为指向新生成的 `_system-design.md` 文件路径。
+
+---
+
+## 质量检查
+
+生成文件后，逐项核对以下清单：
+
+### 设计文档检查
+
+- [ ] 04 号模板必填部分（§1~§9）全部覆盖
+- [ ] 需求 ID 映射表记录了 PRD 中所有 US/BR 编号
+- [ ] 所有 Entity 标注 `@TableName` 反引号 + `@TableId(type = IdType.ASSIGN_ID)`，**未重复声明 BaseEntity 审计字段**
+- [ ] DTO 标注 `extends ReqeustCommonDataBean`，校验分组为内部接口
+- [ ] Ro 标注 `implements Serializable` + `serialVersionUID`
+- [ ] 实体关系有 Mermaid classDiagram，标注关系基数
+- [ ] 核心业务流程有 Mermaid flowchart
+- [ ] 状态流转有 Mermaid stateDiagram（如有）
+- [ ] DAO 继承 `BaseCommonDAO_HI`，所有查询通过 MyBatis XML
+- [ ] Controller 继承 `CommonAbstractService`，每个方法 `@CheckToken`
+- [ ] 接口出参统一为 `ResponseData<T>`，Controller 取参用 `requestData.getParams()`
+- [ ] 错误码遵循 `{port}_{table_snake}_{三位序号}` 格式，定义在 `ResponseMsgCode` 枚举中
+- [ ] Service 方法标注是否需要 `@Transactional(rollbackFor = Exception.class)`
+- [ ] Save 用 FastJSON，Update 用 Spring BeanUtils 排除审计字段
+- [ ] 子表更新采用先删后增策略
+- [ ] 异常在 Service 层通过 `RecordNotExistsException` / `GushenRuntimeException` 抛出
+- [ ] 每个业务行为有业务规则（引用 BR-ID）和异常处理
+- [ ] ResponseData 使用 `ResponseMsgCode` 枚举消息码，**禁止硬编码字符串**
+- [ ] 服务名称和端口命名规范严格遵循`02-*_system_architecture.md`中的`技术架构`章节内容
+- [ ] 测试场景覆盖正常/异常/边界情况必须100%覆盖，每种至少 3 条
+
+### 建表 SQL 检查
+
+- [ ] 文件含 `--liquibase formatted sql` 和 changeset
+- [ ] 每张表包含完整 ECP 审计字段（8 个）
+- [ ] 每列有 `COMMENT`
+- [ ] `delete_flag` 默认 0，`version_num` 默认 0
+- [ ] 索引命名符合规范（`uk_` / `idx_`）
+- [ ] 无外键约束
+- [ ] DDL/DML 幂等
+
+## 关键规则
+
+- **按 04 号模板 §1~§10 顺序生成** — 每个部分从分析直接落地到设计，后文引用前文定义的内容，避免重复
+- **每个设计条目标注** `**来源需求**:` 引用 PRD ID（如 US-01、BR-02、FUNC-03），支撑全链路追溯
+- **严格遵循 ECP 编码规范** — 所有设计决策以 `docs/40-project_conventions/end-integration/` 中的规范文件为准
+- **禁止使用 sie-cloud 命名** — 不使用 `BaseDO`、`TenantBaseDO`、`BaseMapperX`、`LambdaQueryWrapperX`、`CommonResult<T>`、`@Resource`、`@PreAuthorize` 等术语
+- **禁止 QueryWrapper / LambdaQueryWrapper** — 所有 DB 操作设计为 MyBatis XML 实现
+- **禁止生成 Java 源码** — 仅生成设计文档和 SQL，不生成 Java 代码
+- **禁止虚构需求** — 设计内容必须来自 PRD，不自行添加未提及的功能
+- **禁止过度设计** — 简单 CRUD 不套用策略/工厂模式，选填部分仅在确需时填写
+- **文件系统操作使用绝对路径**；文档和 agent 上下文文件中的引用使用项目相对路径
+
+## 必选执行后钩子
+
+**必须在向用户报告完成之前完成本节。**
+
+检查项目根目录是否存在 `.adspecs/extensions.yml`。
+
+- 如果不存在，或 `hooks.after_plan` 下没有注册钩子，跳到完成报告。
+- 如果存在，读取它并查找 `hooks.after_plan` 下的条目。
+- 如果 YAML 无法解析或无效，静默跳过钩子检查并继续完成报告。
+- 过滤掉 `enabled` 明确为 `false` 的钩子。没有 `enabled` 字段的钩子默认视为启用。
+- 对于每个剩余的钩子，**不要** 尝试解释或评估钩子的 `condition` 表达式：
+  - 如果钩子没有 `condition` 字段，或为空/null，视为可执行。
+  - 如果钩子定义了非空的 `condition`，跳过该钩子，将条件评估留给 HookExecutor 实现。
+- 从钩子命令名构造斜杠命令时，将点号（`.`）替换为连字符（`-`）。例如：`adspecs.git.commit` → `/adspecs-git-commit`。
+- 对于每个可执行钩子，根据其 `optional` 标志输出以下内容：
+  - **必选钩子** (`optional: false`) — **必须为每个必选钩子发出 `EXECUTE_COMMAND:`**：
+
+    ```
+    ## 扩展钩子
+
+    **自动钩子**: {extension}
+    执行: `/{command}`
+    EXECUTE_COMMAND: {command}
+    ```
+
+  - **可选钩子** (`optional: true`):
+
+    ```
+    ## 扩展钩子
+
+    **可选钩子**: {extension}
+    命令: `/{command}`
+    描述: {description}
+
+    提示: {prompt}
+    执行: `/{command}`
+    ```
+
+## 完成报告
+
+报告以下内容：
+
+- 已生成的设计文档路径和行数
+- 已生成的建表 SQL 路径和表数量
+- 模板覆盖情况（§1~§7 哪些已完成，§8~§10 是否选填）
+- 质量检查通过项数 / 总项数
+
+## 触发关键词
+
+- `adspecs-plan` — 直接使用本技能
+- 在对话中指定 PRD 文件即可，如：`使用 adspecs-plan 处理 {PRD_DIR}/crm/sales-forecast/M06-01_销售预测需求规格说明书.md`
+
+## 完成标志
+
+- [ ] 统一设计文档已生成（按 04 号模板 §1~§10 完整覆盖，必填部分无遗漏）
+- [ ] 建表 SQL 已生成（含完整审计字段和 COMMENT）
+- [ ] 文件已保存到 `{DESIGN_DIR}/{crm|mom}/`
+- [ ] Agent 上下文已更新（CLAUDE.md SPECKIT 标记）
+- [ ] 扩展钩子已根据上述必选执行后钩子规则分发或跳过
+- [ ] 完成报告已呈现给用户
+
+---