adspecs 0.1.12

package/skills/adspecs-analyze/SKILL.md

@@ -0,0 +1,573 @@
+---
+name: "adspecs-analyze"
+description: "对 PRD、系统设计文档（_system-design.md）和 tasks.md 进行非破坏性的 ECP 全链路一致性分析。"
+argument-hint: "指定功能名或系统设计文档路径，如 M06-01 或 docs/30-system-design/crm/M06-01-销售预测_system-design.md"
+compatibility: "需要 docs/ 目录体系：docs/20-prd（PRD）+ docs/30-system-design（系统设计+tasks）+ CLAUDE.md（ECP 编码宪章）"
+metadata:
+  author: "qingwen"
+  source: "基于 adspecs-analyze 通用模板 + ECP 全链路追溯 ID 体系 + CLI 规范 10 条 + TDD 一致性检测改造"
+user-invocable: true
+disable-model-invocation: false
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+在处理之前**必须**考虑用户输入（若不为空）。用户输入应为功能名称（如 `M06-01`）或系统设计文档路径。若为空则从上下文推导。
+
+## 执行前检查
+
+**检查扩展钩子（分析前）**：
+
+- 检查项目根目录下是否存在 `.adspecs/extensions.yml` 文件。
+- 如果存在，读取该文件并查找 `hooks.before_analyze` 键下的条目。
+- 如果 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` 不存在，则静默跳过。
+
+## 目标
+
+在实现之前，识别 ECP 平台三大核心产物——**PRD（需求规格说明书）**、**系统设计文档（\_system-design.md）**、**tasks.md**——之间的不一致、重复、歧义、欠明确项及 **ECP 编码规范违反**。此命令**必须**仅在 `/adspecs-tasks` 成功产出完整的 `tasks.md` 之后运行。
+
+**ECP 产物定位**：
+
+| ECP 产物                  | 路径模式                                                     | 负责 Skill       | 关键 ID 体系                                                  |
+| ------------------------- | ------------------------------------------------------------ | ---------------- | ------------------------------------------------------------- |
+| **PRD（需求规格说明书）** | `docs/20-prd/{crm\|mom}/{模块}/`                             | `/adspecs-prd`   | US-###, BR-###, PERM-###（PRD 阶段赋予）                      |
+| **系统设计文档**          | `docs/30-system-design/{crm\|mom}/{功能名}_system-design.md` | `/adspecs-plan`  | FUNC-###, PERM-###（需求分析阶段 AI 赋予）+ 13 章统一 OOA+OOD |
+| **tasks.md**              | `docs/30-system-design/{crm\|mom}/{功能名}_tasks.md`         | `/adspecs-tasks` | T### 全局任务 ID + `[TDD]` 标记 + `[US#]` 故事标签            |
+
+## 操作约束
+
+**严格只读**：**不**修改任何文件。输出结构化的分析报告。提供可选的修复方案（用户必须明确批准后，方可手动调用后续编辑命令）。
+
+**ECP 编码宪章权威**：项目根目录下的 `CLAUDE.md`（特别是 §"Code Generation Rules (ECP Backend)" 的 **10 条编码规范**）在此分析范围内是**不可协商的 MUST 原则**。任何违反这 10 条规范的设计或任务均自动视为 **CRITICAL**。若 CLAUDE.md 中的规则本身需要更改，必须通过独立的、显式的 CLAUDE.md 更新流程完成。
+
+## 执行步骤
+
+### 1. 定位三产物
+
+从 `$ARGUMENTS` 或上下文推导三产物路径：
+
+**方式 A：从 $ARGUMENTS 直接指定**
+
+- 若用户提供了功能名（如 `M06-01`）→ 搜索 `docs/30-system-design/{crm|mom}/M06-01*_system-design.md` 和 `docs/30-system-design/{crm|mom}/M06-01*_tasks.md`
+- 若用户提供了完整路径（如 `docs/30-system-design/crm/M06-01-销售预测_system-design.md`）→ 直接使用
+
+**方式 B：从上下文推导**
+
+- 搜索 `docs/30-system-design/{crm|mom}/` 下最新修改的 `*_system-design.md`
+- 搜索同目录下对应的 `*_tasks.md`
+- 从系统设计文档 §1.1 定位关联的 PRD 文件路径
+
+**必须定位的三文件**：
+
+- **PRD**：`docs/20-prd/{crm|mom}/{模块}/` 下的需求规格说明书（含 US-###/BR-###）
+- **SYSTEM_DESIGN**：`docs/30-system-design/{crm|mom}/{功能名}_system-design.md`
+- **TASKS**：`docs/30-system-design/{crm|mom}/{功能名}_tasks.md`
+
+若任意文件缺失，则终止并提示用户运行对应的前置命令（如 `/adspecs-plan` 或 `/adspecs-tasks`）。
+
+### 2. 加载产物与宪章（渐进式披露）
+
+仅加载每个产物中最低限度的必要上下文。
+
+**从 PRD 加载：**
+
+- §2.1 用户故事（US-### + 优先级 + 验收场景）
+- §3.2 业务规则（BR-### + 规则简述）
+- §4.1 功能清单（功能编号 → 与系统设计 FUNC-### 关联）
+- §5.1 权限矩阵（权限标识 → 角色 → 与系统设计 §5.4 关联）
+- §6.1 验收标准（归约到 US/BR ID）
+
+**从系统设计加载：**
+
+- §1.1 需求 ID 映射（4 张表：用户故事映射 / 业务规则映射 / 功能条目映射 / 权限映射）
+- §2.2 实体清单（Entity 完整字段 + 注解要求）
+- §2.3 DTO 清单（DTO 字段 + 校验规则 + 分组）
+- §2.4 Ro 清单（Ro 字段）
+- §3.2 数据库表设计（2 张表的 DDL 约束）
+- §3.3 MyBatis 映射（DAO 接口 + XML 结构）
+- §4.1 业务行为清单（行为 + 触发方 + 前置/后置条件）
+- §4.4 Service 接口设计（方法签名 + 事务边界）
+- §5.1 端点清单（HTTP + 路径 + 请求/响应包装）
+- §5.4 权限矩阵（接口 → 权限要求）
+- §6.1 枚举定义（每个枚举的值 + 编码）
+- §7.1 业务异常清单（消息码 + 触发条件 + 抛出位置）
+- §7.3 消息码汇总（properties 内容，19 个消息码）
+- §9 领域事件（发布/消费事件）
+- §10 跨模块依赖（Feign Client 契约）
+- §13 附录代码结构（~45 文件目录树）
+
+**从 tasks.md 加载：**
+
+- 文件路径速查表（所有目标文件路径）
+- Phase 1~10 结构（阶段号 → 故事/基础设施/收尾）
+- Task ID（T001~TNNN）+ `[P]` 标记 + `[TDD]` 标记 + `[US#]` 标签
+- 每个任务的精确文件路径
+- ECP 编码规范检查清单（10 条逐项确认状态）
+- 依赖关系与执行顺序
+- TDD 执行指南（RED→GREEN→REFACTOR）
+
+**从 CLAUDE.md（ECP 编码宪章）加载：**
+
+- §"Code Generation Rules (ECP Backend)" 10 条规则（MUST 原则）
+- §"Repository Overview" 三模块结构定义
+
+### 3. 构建 ECP 语义模型
+
+创建内部表示（切勿将原始产物包含在输出中）：
+
+#### 3.1 ECP 全链路 ID 模型
+
+从系统设计 §1.1 的 4 张映射表一次性提取所有可追溯 ID：
+
+| ID 类型      | 来源            | 含义     | 设计文档映射                                | tasks 映射                       |
+| ------------ | --------------- | -------- | ------------------------------------------- | -------------------------------- |
+| **US-###**   | PRD §2.1        | 用户故事 | 系统设计 §1.1.1                             | tasks Phase 3~10 的 `[US#]` 标签 |
+| **BR-###**   | PRD §3.2        | 业务规则 | 系统设计 §1.1.2 → §4 Service 方法 → §7 异常 | tasks 中校验/异常相关实现任务    |
+| **FUNC-###** | 系统设计 §1.1.3 | 功能条目 | 系统设计 §5.1 端点                          | tasks 中 Controller 端点任务     |
+| **PERM-###** | 系统设计 §1.1.4 | 权限标识 | 系统设计 §5.4 权限矩阵                      | tasks 中 `@CheckToken` 配置任务  |
+
+#### 3.2 ECP 任务类型模型
+
+将 tasks 中的每个任务按 ECP 类型分类：
+
+```
+Entity | DTO | Ro | DAO接口 | DAO XML | Service接口 | Service实现 | Controller | Feign Client | 枚举 | 消息码常量 | Kafka Consumer | i18n | Liquibase | 配置类 | 工具类 | 测试
+```
+
+#### 3.3 TDD 标记模型
+
+提取每个故事阶段内的 `[TDD]` 标记位置和数量：
+
+- 每个 `[Story]` 阶段的第一个 `[TDD]` 任务索引
+- `[TDD]` 任务总数 vs 该阶段实现任务总数
+- 场景覆盖（正常 / 异常 / 边界）
+
+### 4. 检测扫描（令牌高效分析）
+
+聚焦高信号发现。限制最多 50 条发现；超出部分在溢出摘要中汇总。
+
+---
+
+#### A. 重复检测
+
+- 识别 PRD/系统设计/tasks 中近似重复的 US/BR/FUNC 描述
+- 标记表述较差者，建议合并
+
+#### B. 歧义检测
+
+- 标记缺乏可度量标准的模糊形容词（快速、可扩展、安全、直观、健壮）
+- 标记未解决的占位符（TODO、TKTK、???、`<placeholder>` 等）
+- 标记 PRD 中 "待后续版本补充" 但系统设计仍缺少的设计元素
+
+#### C. 欠明确性检测
+
+- BR 规则在系统设计 §4 中缺少对应 Service 方法
+- US 故事在 tasks 中缺少完整的 Phase
+- 系统设计实体字段在 tasks Entity 任务中未完整列出
+
+#### D. 宪章一致性（ECP 编码规范）
+
+> **来源**：CLAUDE.md §"Code Generation Rules (ECP Backend)" 10 条 MUST 规则。**违反任意一条 = CRITICAL**。
+
+逐条检测 tasks.md 和系统设计 §13 中的文件/描述是否合规：
+
+| #   | 检测规则                                                                                        | 检测方式                                         |
+| --- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------ |
+| 1   | Entity: `extends BaseEntity<Entity>`, `@TableName`, `@TableField`+`@Schema`, `IdType.ASSIGN_ID` | 检查 Entity 任务描述是否含这些关键字             |
+| 2   | DTO: `extends ReqeustCommonDataBean`（注意拼写）, 校验分组, `@JSONField`                        | 检查 DTO 任务描述是否含正确拼写                  |
+| 3   | DAO: `extends BaseCommonDAO_HI`, `@Component`, XML 同包, `WHERE delete_flag=0`                  | 检查 DAO 任务描述是否含 delete_flag              |
+| 4   | **禁止 QueryWrapper/LambdaQueryWrapper**                                                        | 全文扫描 tasks.md 不出现这两个词                 |
+| 5   | Service: `II{Entity}` 接口 + 实现, `@Component`, Save→FastJSON, Update→SpringBeanUtils          | 检查 Service 任务描述是否区分 FastJSON/BeanUtils |
+| 6   | Controller: `extends CommonAbstractService`, `@CheckToken`, `ResponseData` 包装                 | 检查 Controller 任务描述是否含这些关键字         |
+| 7   | Ro: `implements Serializable`, 手动字段, `@DateTimeFormat @JsonFormat`                          | 检查 Ro 任务描述                                 |
+| 8   | 异常: Service 层抛出, 消息码枚举禁止硬编码                                                      | 检查异常任务是否在 Service 实现中                |
+| 9   | i18n: 7 个 `.properties` 文件存在                                                               | 检查 tasks 是否含 7 个 i18n 任务                 |
+| 10  | 注入: `@Autowired`, FastJSON 序列化, Hutool 优先, SLF4J                                         | 检查工具注入规范                                 |
+
+#### E. 覆盖缺口
+
+- 每个 US 故事是否在 tasks 中有对应的 Phase
+- 每个 BR 规则是否在 tasks 中有对应的实现任务
+- 每个 FUNC 功能是否在 tasks 中有对应的 Controller 端点任务
+- 每个 PERM 权限是否在 tasks 中有对应的 `@CheckToken` 配置
+- 系统设计 §10 中每个外部依赖是否在 tasks 中有对应 Feign Client 任务
+- 系统设计 §6.1 中每个枚举是否在 tasks Phase 2 中有独立任务
+- 系统设计 §9.1/§9.2 中每个事件是否在 tasks 中有对应 Consumer 或通知任务
+- 系统设计 §12 中每个测试场景是否有对应的 `[TDD]` 任务
+
+#### F. 不一致性
+
+- 术语漂移（PRD 用"预测单"，系统设计用"ForecastOrder"，tasks 中混用）
+- 消息码不匹配（系统设计 §7.3 定义的码 vs tasks 中引用的码）
+- 文件路径漂移（系统设计 §13 目录树 vs tasks 文件路径速查表）
+- 用户故事优先级漂移（PRD P1/P2 vs tasks Phase 排列顺序）
+- 行为数量不一致（系统设计 §4.1 18 个行为 vs tasks 中对应 Service 方法数量）
+
+---
+
+#### G. ECP 编码规范一致性（新增）
+
+> 此维度在 D 基础上做更细粒度的语义检查。
+
+- 任务描述中的 ECP 父类拼写是否正确（`ReqeustCommonDataBean` vs `RequestCommonDataBean`）
+- Entity 任务是否声明"审计字段继承不重复"
+- DAO XML 任务是否声明 `resultMap` 含全字段+审计
+- Service 任务是否区分 Save（FastJSON `JSONObject.parseObject(JSONObject.toJSONString(...))`）和 Update（Spring `BeanUtils.copyProperties(dto, entity, "createdBy", "creationDate", "versionNum")`）
+- 任务描述中是否使用了 `QueryWrapper` 或 `LambdaQueryWrapper`（绝对禁止）
+
+#### H. TDD 顺序一致性（新增）
+
+- 每个 `[US#]` Phase 内，第一个任务是否带有 `[TDD]` 标记
+- 每个故事内是否存在无对应 `[TDD]` 测试的实现任务
+- 是否存在 `[TDD]` 任务位于实现任务**之后**的情况（违反 TDD 铁律）
+- `[TDD]` 任务粒度：是否为每个 Service 方法的正常/异常/边界场景都配置了测试任务（对照系统设计 §12 的三个测试场景表）
+
+#### I. i18n 覆盖完整性（新增）
+
+- tasks.md Final Phase 是否包含 **恰好 7 个** `.properties` 文件任务
+- 语言覆盖：是否包含 `default` / `zh_CN` / `zh_TW` / `en_US` / `vi_VN` / `th_TH` / `hu_HU`
+- 消息码覆盖：系统设计 §7.3 中的 19 个消息码是否在至少 1 个 i18n 文件任务中提到
+- 文件命名格式：`{port}-{service}-application[_locale].properties`
+
+#### J. 三模块路径精度（新增）
+
+- tasks.md 中每个文件路径是否从 `{port}-{service}-{layer}/` 开始
+- 文件所在模块是否与其类型匹配：
+  - Entity → `-model/src/main/java/.../model/entity/`
+  - DTO → `-api/src/main/java/.../api/dto/`
+  - DAO+XML → `-model/src/main/java/.../model/dao/`
+  - Service → `-application/src/main/java/.../model/service/`
+  - Controller → `-application/src/main/java/.../api/controller/`
+  - Feign Client → `-api/src/main/java/.../api/client/`
+  - 枚举 → `-application/src/main/java/.../infra/enumeration/`
+  - i18n → `-application/src/main/resources/config/`
+  - Liquibase → `-model/src/main/resources/liquibase/`
+
+#### K. Feign Client 映射完整性（新增）
+
+- 系统设计 §10 列出 N 个外部依赖 → tasks 中是否有 N 个对应 `Feign Client` 任务
+- 外部依赖专用 Feign Client：CtctClient / BondedManualClient / FoClient / SoClient / ApsClient
+- 每个 Feign Client 任务的文件路径是否为 `-api/client/` 目录
+- Feign Client 的接口路径/方法签名是否与系统设计 §10.2 中的契约一致
+
+#### L. Liquibase 覆盖完整性（新增）
+
+- 系统设计 §3.2 定义 N 张表 → tasks 中 Liquibase DDL 是否覆盖全部表
+- 2 张表（`forecast_order` + `forecast_change_order`）是否都在 DDL 任务中提到
+- 索引覆盖：系统设计 §3.2 定义的所有索引（主表 6 个 + 子表 3 个 = 9 个）是否在 DDL 中
+- Liquibase 文件数量：是否包含 `master.xml` + `v1.0.xml` + `DDL_1.0_YYYYMMDD.sql` 三个文件
+
+#### M. ECP 专项任务类型覆盖（新增）
+
+- 枚举类数量：系统设计 §6.1 定义 7 个枚举 → tasks Phase 2 是否有 7 个枚举任务
+- 消息码常量：tasks Phase 2 是否有 `ResponseMsgCode` 任务
+- Kafka Consumer：系统设计 §9.2 有 APS 消费者 → tasks 是否有 `ApsScheduleConfirmConsumer` 任务
+- 配置类：系统设计 §8 缓存策略 / §8.3 并发控制 → tasks 是否有对应配置任务
+- 工具类：系统设计 §4.5 引用的 `ForecastUtils` → tasks 是否有对应工具类任务
+
+---
+
+### 5. 严重级别分配
+
+使用以下启发式规则对发现进行优先级排序：
+
+- **CRITICAL**：
+  - 违反 CLAUDE.md ECP 10 条编码规范任一条
+  - 核心产物缺失（PRD/系统设计/tasks 三缺一）
+  - US 故事零覆盖（tasks 中无对应 Phase）
+  - 所有端点缺失 `@CheckToken`
+  - i18n 7 文件任务数 ≠ 7
+  - 违反 TDD 铁律（实现任务在 `[TDD]` 测试之前）
+- **HIGH**：
+  - BR 业务规则在 tasks 中无对应实现
+  - 系统设计 §10 外部依赖在 tasks 中无对应 Feign Client
+  - 消息码不匹配（不同文件中同一概念码不同）
+  - 校验字段消息码格式错误（非 `{port}_{table}_{三位序号}`）
+  - 文件路径三模块归属错误
+- **MEDIUM**：
+  - 术语漂移（同一概念在不同文件中命名不一致，"预测单" vs "FC" vs "forecast"）
+  - 单个枚举漏覆盖（6/7 通过）
+  - 测试场景覆盖不完整（只覆盖正常场景，缺异常/边界）
+  - 欠明确的边界情况
+- **LOW**：
+  - 风格/措辞改进（任务描述可更精确）
+  - 不影响执行顺序的轻微冗余
+  - 非关键的命名不一致
+
+### 6. 生成紧凑 ECP 分析报告
+
+输出 Markdown 报告（不写文件），结构如下：
+
+---
+
+## ECP 全链路一致性分析报告
+
+### 分析概要
+
+| 指标          | 数值             |
+| ------------- | ---------------- |
+| 分析功能      | [功能名称]       |
+| PRD 路径      | [PRD 文件路径]   |
+| 系统设计路径  | [设计文档路径]   |
+| tasks.md 路径 | [tasks 文件路径] |
+| 分析时间      | [时间戳]         |
+
+### 全链路追溯矩阵
+
+| US ID | 优先级 | BR ID             | FUNC ID         | PERM ID         | Task Phase | Task IDs  | 覆盖状态 |
+| ----- | ------ | ----------------- | --------------- | --------------- | ---------- | --------- | :------: |
+| US-01 | P1     | BR-01,BR-02,BR-14 | FUNC-03,FUNC-05 | PERM-01,PERM-02 | Phase 3    | T022~T034 |    ✅    |
+| US-02 | P1     | —                 | FUNC-11,FUNC-12 | PERM-07,PERM-08 | Phase 4    | T035~T041 |    ✅    |
+| ...   | ...    | ...               | ...             | ...             | ...        | ...       |   ...    |
+
+### ECP 编码规范合规检查
+
+| #   | 规范                | 检测结果 | 发现       |
+| --- | ------------------- | :------: | ---------- |
+| 1   | Entity 规范         | ✅ / ❌  | [具体发现] |
+| 2   | DTO 规范            | ✅ / ❌  | [具体发现] |
+| 3   | DAO 规范            | ✅ / ❌  | [具体发现] |
+| 4   | 禁止 QueryWrapper   | ✅ / ❌  | [具体发现] |
+| 5   | Service 规范        | ✅ / ❌  | [具体发现] |
+| 6   | Controller 规范     | ✅ / ❌  | [具体发现] |
+| 7   | Ro 规范             | ✅ / ❌  | [具体发现] |
+| 8   | 异常处理规范        | ✅ / ❌  | [具体发现] |
+| 9   | i18n 规范（7 文件） | ✅ / ❌  | [具体发现] |
+| 10  | 注入与工具规范      | ✅ / ❌  | [具体发现] |
+
+### TDD 健康度评分
+
+| 故事阶段           | [TDD] 任务数 | 实现任务数 | 先行率      | 场景覆盖（正常/异常/边界） | 评分 |
+| ------------------ | ------------ | ---------- | ----------- | -------------------------- | :--: |
+| Phase 3 (US-01)    | 5            | 8          | ✅ 5/5 先行 | 3/3 全场景                 |  🟢  |
+| Phase 4 (US-02)    | 4            | 3          | ✅ 4/4 先行 | 3/3 全场景                 |  🟢  |
+| Phase 5 (US-09+08) | 3            | 2          | ✅ 3/3 先行 | 3/3 全场景                 |  🟢  |
+| Phase 6 (US-04)    | 3            | 5          | ✅ 3/3 先行 | 3/3 全场景                 |  🟢  |
+| Phase 7 (US-03)    | 2            | 5          | ✅ 2/2 先行 | 2/3 缺边界                 |  🟡  |
+| Phase 8 (US-05)    | 4            | 7          | ✅ 4/4 先行 | 3/3 全场景                 |  🟢  |
+| Phase 9 (US-06+07) | 2            | 3          | ✅ 2/2 先行 | 2/3 缺边界                 |  🟡  |
+| **全局**           | **23**       | **33**     | **100%**    | **85%**                    |  🟢  |
+
+### 文件路径校验表
+
+| 文件                      | 期望模块     | 实际路径模块 | 归属正确？ |
+| ------------------------- | ------------ | ------------ | :--------: |
+| ForecastOrderEntity.java  | -model       | -model       |     ✅     |
+| ForecastOrderDto.java     | -api         | -api         |     ✅     |
+| ForecastOrderService.java | -application | -application |     ✅     |
+| ...                       | ...          | ...          |    ...     |
+
+### 发现清单
+
+| ID  | 类别    | 严重级别 | 位置          | 摘要 | 修复建议 |
+| --- | ------- | -------- | ------------- | ---- | -------- |
+| G1  | ECP规范 | CRITICAL | tasks.md:Lxxx | ...  | ...      |
+| H2  | TDD顺序 | CRITICAL | tasks.md:Lxxx | ...  | ...      |
+| ... | ...     | ...      | ...           | ...  | ...      |
+
+**覆盖摘要表：**
+
+| 需求标识 | 类型     | 是否有任务？ | Task IDs  | 备注                        |
+| -------- | -------- | :----------: | --------- | --------------------------- |
+| US-01    | 用户故事 |      ✅      | T022~T034 | Phase 3                     |
+| BR-01    | 业务规则 |      ✅      | T032      | Service.submitForecastOrder |
+| FUNC-03  | 功能条目 |      ✅      | T032,T033 | Controller.save+Service     |
+| PERM-01  | 权限     |      ✅      | T033      | @CheckToken                 |
+| ...      | ...      |     ...      | ...       | ...                         |
+
+**Feign Client 映射表：**
+
+| 外部依赖（系统设计 §10） | Feign Client 任务  | 模块 | 路径正确？ |
+| ------------------------ | ------------------ | ---- | :--------: |
+| P01 CTCT 查询            | CtctClient         | -api |     ✅     |
+| P03 保税手册             | BondedManualClient | -api |     ✅     |
+| FO 创建                  | FoClient           | -api |     ✅     |
+| SO 行项目                | SoClient           | -api |     ✅     |
+| APS 排产进度             | ApsClient          | -api |     ✅     |
+
+**i18n 覆盖表：**
+
+| 语言文件       | 任务 ID | 消息码覆盖数 |
+| -------------- | ------- | ------------ |
+| default (中文) | T084    | 19/19 ✅     |
+| zh_CN          | T085    | 19/19 ✅     |
+| zh_TW          | T086    | 19/19 ✅     |
+| en_US          | T087    | 19/19 ✅     |
+| vi_VN          | T088    | 19/19 ✅     |
+| th_TH          | T089    | 19/19 ✅     |
+| hu_HU          | T090    | 19/19 ✅     |
+
+**未映射任务：**（若有）
+
+**指标汇总：**
+
+- 用户故事总数：10
+- 业务规则总数：14
+- 功能条目总数：21
+- 权限标识总数：13
+- 任务总数：95
+- 全链路覆盖率：XX%（至少关联 1 个任务的需求占比）
+- 歧义数量：X
+- 重复数量：X
+- CRITICAL 问题数量：X
+- ECP 规范违规数量：X
+- TDD 先行率：XX%
+- i18n 覆盖完整性：X/7
+
+---
+
+### 7. 提供后续行动
+
+在报告末尾输出简洁的后续行动块：
+
+- 若存在 **CRITICAL** 问题：建议在 `/adspecs-implement` 或 `/adspecs-tasks` 迭代之前解决。禁止进入实现阶段。
+- 若存在 **HIGH** 问题：强烈建议在实现前修复，否则可能存在功能缺失。
+- 若仅有 **LOW/MEDIUM**：用户可以继续实现，但提供改进建议。
+- 提供明确的命令建议：
+  - "运行 `/adspecs-tasks` 重新生成 tasks.md 以修复覆盖缺口"
+  - "运行 `/adspecs-clarify` 澄清欠明确的 PRD 条目"
+  - "手动编辑 tasks.md 添加缺失的 `[TDD]` 测试任务"
+  - "手动编辑系统设计文档修正消息码不一致"
+
+### 8. 提供修复方案
+
+询问用户："是否需要我为前 N 个问题提供具体的修复编辑建议？"（切勿自动应用修复。）
+
+### 9. 检查扩展钩子
+
+在报告之后，检查项目根目录下是否存在 `.adspecs/extensions.yml` 文件。
+
+- 如果存在，读取该文件并查找 `hooks.after_analyze` 键下的条目。
+- 如果 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` 不存在，则静默跳过。
+
+---
+
+## ECP 专项检测规则速查表
+
+> 以下 13 条规则是执行步骤 §4（检测扫描）的 G~M 维度的具体检测条款。每条规则对应一个 ID 前缀，出现在报告"发现清单"的 ID 列中。
+
+| ID 前缀 | 检测维度           | 检测规则                                                                                                 |
+| ------- | ------------------ | -------------------------------------------------------------------------------------------------------- |
+| G       | **ECP 编码规范**   | Entity/DTO/DAO/Service/Controller/Ro 描述中的父类/接口/注解是否正确（10 条逐条检查）                     |
+| G1      | ECP 编码规范       | Entity: `extends BaseEntity<T>`, `@TableName`, `@TableField`+`@Schema`, `IdType.ASSIGN_ID`               |
+| G2      | ECP 编码规范       | DTO: `extends ReqeustCommonDataBean`, 校验分组, `@JSONField(format)`，消息码 `{port}_{table}_{三位序号}` |
+| G3      | ECP 编码规范       | DAO: `extends BaseCommonDAO_HI<T>`, `@Component`, XML 同包, `WHERE delete_flag=0`                        |
+| G4      | ECP 编码规范       | 任务描述中无 `QueryWrapper`/`LambdaQueryWrapper` 字样                                                    |
+| G5      | ECP 编码规范       | Service: 接口 `II{Entity}`, 实现 `extends BaseCommonServer`, Save→FastJSON, Update→SpringBeanUtils       |
+| G6      | ECP 编码规范       | Controller: `extends CommonAbstractService`, `@CheckToken`, `ResponseData<T>` 包装                       |
+| G7      | ECP 编码规范       | Ro: `implements Serializable`, 手动字段, `@DateTimeFormat @JsonFormat`                                   |
+| G8      | ECP 编码规范       | 异常: Service 层抛出, `ResponseMsgCode` 枚举禁止硬编码                                                   |
+| G9      | ECP 编码规范       | i18n: 7 个 `.properties`（default/zh_CN/zh_TW/en_US/vi_VN/th_TH/hu_HU）                                  |
+| G10     | ECP 编码规范       | 注入: `@Autowired`, FastJSON, Hutool, SLF4J                                                              |
+| H       | **TDD 顺序**       | 每个故事 Phase 内 `[TDD]` 任务必须在所有实现任务之前                                                     |
+| H1      | TDD 顺序           | 第一个实现任务之前至少存在 1 个 `[TDD]` 任务                                                             |
+| H2      | TDD 顺序           | 不存在实现任务在前、`[TDD]` 在后的排序错误                                                               |
+| H3      | TDD 顺序           | `[TDD]` 任务覆盖正常/异常/边界三场景（对照系统设计 §12）                                                 |
+| I       | **i18n 覆盖**      | 7 个语言文件完整（default/zh_CN/zh_TW/en_US/vi_VN/th_TH/hu_HU）                                          |
+| I1      | i18n 覆盖          | tasks 中 i18n 文件任务数 = 7                                                                             |
+| I2      | i18n 覆盖          | 系统设计 §7.3 中每个消息码在至少 1 个 i18n 任务中被覆盖                                                  |
+| J       | **三模块路径**     | 文件路径从 `{port}-{service}-{layer}/` 开始，归属正确                                                    |
+| J1      | 三模块路径         | Entity/DTO 不在错误模块（Entity 不在 -api，DTO 不在 -application）                                       |
+| J2      | 三模块路径         | 路径格式完整（含包路径 `com/sie/gushen/{service}/`）                                                     |
+| K       | **Feign 映射**     | 系统设计 §10 外部依赖 → tasks 中 Feign Client 一一对应                                                   |
+| K1      | Feign 映射         | 依赖数量 = Feign Client 任务数量                                                                         |
+| K2      | Feign 映射         | Feign Client 路径在 `-api/client/` 下                                                                    |
+| L       | **Liquibase 覆盖** | 系统设计 §3.2 每张表 → DDL SQL 中有完整建表语句                                                          |
+| L1      | Liquibase 覆盖     | 表数量匹配（系统设计 §2.2 实体数 = DDL 中表数）                                                          |
+| L2      | Liquibase 覆盖     | 索引数量匹配（系统设计 §2.2 索引数 = DDL 中索引数）                                                      |
+| L3      | Liquibase 覆盖     | 3 文件完整（master.xml + v1.0.xml + DDL.sql）                                                            |
+| M       | **ECP 任务类型**   | 枚举/消息码/Consumer/配置/工具类任务数匹配系统设计                                                       |
+| M1      | ECP 任务类型       | 枚举数 = 系统设计 §6.1 中枚举数量                                                                        |
+| M2      | ECP 任务类型       | Consumer 数 = 系统设计 §9.2 中消费事件数量                                                               |
+| M3      | ECP 任务类型       | 配置类覆盖：DataSourceConfig + MybatisPlusConfig + SpringDocConfig                                       |
+| M4      | ECP 任务类型       | 工具类覆盖：系统设计 §4.5 引用的所有工具类                                                               |
+
+---
+
+## 操作原则
+
+### 上下文效率
+
+- **最少高信号令牌**：聚焦可操作的发现，而非详尽的文档
+- **渐进式披露**：增量加载产物；不要将所有内容倾泻到分析中
+- **令牌高效输出**：发现表最多 50 行；汇总溢出部分
+- **确定性结果**：无更改重新运行应产生一致的 ID 和计数
+
+### 分析准则
+
+- **绝不修改文件**（此为只读分析）
+- **绝不虚构缺失的章节**（若缺失，如实报告）
+- **优先处理 ECP 编码规范违规和宪章冲突**（这些始终是 CRITICAL）
+- **使用 ECP 真实示例而非穷举规则**（引用具体 US-ID、Task ID、文件路径）
+- **优雅地报告零问题**（输出带有全链路覆盖统计的成功报告）
+- **三产物联动检测**：不孤立地分析单一文件，始终检查 PRD↔系统设计↔tasks 之间的 ID 追溯一致性
+
+## 上下文
+
+$ARGUMENTS