ai-engineering-init 1.13.0 → 1.14.1

package/.claude/hooks/stop.js

@@ -42,8 +42,7 @@ try {
 
     if (changedFiles.length > 0) {
       console.error(`\n💡 检测到 ${changedFiles.length} 个代码文件变更，建议执行代码审查：`);
-      console.error(`   → 输入 "review" 或 "审查代码" 使用 code-reviewer 进行规范检查`);
-      console.error(`   → 输入 "codex review" 调用 Codex 进行深度代码审查\n`);
+      console.error(`   → 输入 "review" 或 "审查代码" 使用 code-reviewer 进行规范检查\n`);
     }
   }
 } catch {

package/.claude/skills/analyze-requirements/SKILL.md

@@ -29,7 +29,7 @@ description: |
   │   - 用户已给出完整字段列表
   │
   └─ 复杂需求？ ──→ Agent 路径（启动 requirements-analyzer）
-      - 提供了 Axure 原型链接或截图
+      - 提供了 Axure 原型截图
       - 提供了云效任务编号
       - 多页面/多模块联动
       - 业务流程复杂，需要状态流转设计
@@ -45,34 +45,12 @@ description: |
 
 ## Agent 路径（复杂需求）
 
-### Axure 链接处理（重要）
-
-> **Axure 是 SPA 应用，WebFetch 必定失败（TLS/JS 渲染问题）。禁止用 WebFetch 访问 Axure 链接。**
-
-当用户提供 Axure 链接时，必须用 Playwright 截图：
-
-```bash
-# 1. 先用 Playwright 截图（每个页面单独截）
-npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
-npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
-
-# 2. 截图完成后，将文件路径传给 image-reader Agent 分析
-# 3. 如果原型有多个页面，URL 通常带 #page 参数，逐页截图
-```
-
-**判断规则**：
-- URL 包含 `axure.cloud` 或 `.axshare.com` → Playwright 截图
-- 用户说"Axure 链接" → Playwright 截图
-- 本地截图文件（.png/.jpg） → 直接 image-reader 分析
-
-### 完整流程
-
 ```
 步骤 1：收集信息（从用户消息中提取）
-  - Axure 原型链接 → Playwright 截图 → image-reader 分析
-  - Axure 原型截图文件 → 直接 image-reader 分析
-  - 云效任务编号 → task-fetcher 获取详情
+  - Axure 原型截图路径
+  - 云效任务编号
   - 需求描述文字
+  - 关联模块信息
 
 步骤 2：启动 requirements-analyzer Agent
   └── requirements-analyzer(Opus) 内部自动编排：
@@ -91,23 +69,13 @@ npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2
 |---------------|---------|
 | 只有文字描述 | 快速路径（不启动 Agent） |
 | 文字 + 原型截图 | requirements-analyzer → 内部调 image-reader |
-| 文字 + Axure 链接 | Playwright 截图 → requirements-analyzer → image-reader |
 | 文字 + 云效任务号 | requirements-analyzer → 内部调 task-fetcher |
 | 原型截图 + 云效任务号 | requirements-analyzer → 内部并行调 image-reader + task-fetcher |
 
 ### 启动示例
 
 ```
-# 有 Axure 链接（先截图再分析）
-Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
-Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
-
-Agent(subagent_type="requirements-analyzer",
-  prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
-  截图路径：/tmp/axure-1.png, /tmp/axure-2.png
-  需求描述：xxx")
-
-# 有原型截图文件
+# 有原型截图
 Agent(subagent_type="requirements-analyzer",
   prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
   截图路径：/path/to/image1.png, /path/to/image2.png
@@ -142,4 +110,3 @@ Agent(subagent_type="requirements-analyzer",
 - 与 `bug-detective` / `fix-bug` 的区别：本技能面向**新功能开发前的需求分析**，不涉及 Bug 排查
 - 数据库设计必须遵循项目规范（雪花 ID、审计字段、del_flag=2 正常）
 - 如果需求信息不完整，主动列出需要确认的点，而不是猜测
-- **Axure 链接必须用 Playwright 截图，禁止 WebFetch**

package/.claude/skills/auto-test/SKILL.md

@@ -280,20 +280,192 @@ voucher_type_id: jsonpath "$.data.records[0].id"
 
 ### 第四步：生成 .hurl 文件
 
-**查询条件完整覆盖**（每个 Param 字段都要有测试用例）：
+#### 4.1 查询条件类型识别与测试策略
 
+读取 Param 类后，**逐字段识别条件类型**，按下表生成对应测试用例：
+
+| 条件类型 | 识别特征 | 示例字段 | 必须生成的测试用例 |
+|---------|---------|---------|----------------|
+| **日期范围** | `startDate`/`endDate` 成对 | `startDate`, `endDate` | ① 正常区间 ② 单日（start==end） ③ 跨月区间 ④ 必填时留空（预期报错/空结果） |
+| **关键词搜索** | `keyword`, `name`, `code` 等 | `keyword`, `canteenName` | ① 精确匹配已知值 ② 模糊匹配前缀 ③ 无匹配的乱码（验证空数组） ④ 留空（不过滤，验证正常返回） |
+| **枚举/状态** | 字段类型为枚举或 Integer 语义明确 | `status`, `type`, `mealtype` | ① 每个有效枚举值各一条请求 ② 可选时留空（验证不过滤） |
+| **ID / 外键** | 字段名含 `Id`，关联其他表 | `canteenId`, `areaId` | ① 传有效 ID（有数据，验证过滤生效） ② 留空（不过滤，验证正常返回） ③ 传不存在 ID（验证空结果） |
+| **布尔开关** | boolean / Integer 表示开关 | `isSubmitted`, `isEnabled` | ① `true`/`1` ② `false`/`0` ③ 留空 |
+| **集合/多选** | `List<Integer>`, `List<String>` | `mealtimeTypes`, `statusList` | ① 单项 ② 多项组合 ③ 空列表或留空 |
+| **分页** | `page.current`/`page.size` | `page` | ① 第1页 size=10 ② 第2页（验证翻页） ③ size=1（验证精确分页） |
+
+#### 4.2 各条件类型 Hurl 示例
+
+**① 日期范围**
+```hurl
+# TC-DATE-1 正常日期区间
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2024-01-01","endDate":"2024-01-31"}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.resultPage.records" count > 0
+
+# TC-DATE-2 单日查询（start == end）
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2024-01-15","endDate":"2024-01-15"}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+
+# TC-DATE-3 空区间（故意用无数据的日期）
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2099-01-01","endDate":"2099-01-31"}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.resultPage.records" count == 0
 ```
-单接口测试场景清单：
-1. 基础分页查询 — 必填参数，预期 code=10000，验证分页结构+VO 所有字段
-2. 合计行验证 — 如有 totalLine，验证所有合计字段存在
-3. 逐个查询条件 — 每个 Param 字段单独或组合测试
-4. 空结果验证 — 故意使用不匹配的条件，验证 records count == 0
-5. 分页翻页 — current=2 验证翻页正确
-6. 导出接口 — 验证 code=10000（异步导出返回 void）
-7. 未授权测试 — 不带 X-Token，预期 HTTP 401
-8. 数据清理 — 删除测试创建的数据
+
+**② 关键词搜索**
+```hurl
+# TC-KW-1 精确关键词匹配
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2024-01-01","endDate":"2024-01-31","keyword":"{{known_canteen_name}}"}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.resultPage.records" count > 0
+
+# TC-KW-2 无匹配关键词
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2024-01-01","endDate":"2024-01-31","keyword":"__NO_MATCH_XYZ__"}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.resultPage.records" count == 0
+
+# TC-KW-3 留空 keyword（不过滤）
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2024-01-01","endDate":"2024-01-31"}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.resultPage.records" isCollection
 ```
 
+**③ 枚举/状态**
+```hurl
+# TC-ENUM-1 状态=1（已提交）
+POST {{base_url}}/api/v2/web/order/page
+...
+{"content": {"page":{"current":1,"size":10},"status":1}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.records[0].status" == 1
+
+# TC-ENUM-2 状态=2（已完成）
+POST {{base_url}}/api/v2/web/order/page
+...
+{"content": {"page":{"current":1,"size":10},"status":2}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+
+# TC-ENUM-3 不传 status（全部状态）
+POST {{base_url}}/api/v2/web/order/page
+...
+{"content": {"page":{"current":1,"size":10}}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+```
+
+**④ ID / 外键**
+```hurl
+# TC-ID-1 传有效 canteenId（有数据，过滤生效）
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2024-01-01","endDate":"2024-01-31","canteenId":{{canteen_id}}}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.resultPage.records" count > 0
+jsonpath "$.data.resultPage.records[0].canteenId" == {{canteen_id}}
+
+# TC-ID-2 不传 canteenId（不过滤）
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2024-01-01","endDate":"2024-01-31"}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+
+# TC-ID-3 传不存在 ID（空结果）
+POST {{base_url}}/api/v2/web/report/subject/page
+...
+{"content": {"page":{"current":1,"size":10},"startDate":"2024-01-01","endDate":"2024-01-31","canteenId":999999999}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.resultPage.records" count == 0
+```
+
+**⑤ 集合/多选**
+```hurl
+# TC-LIST-1 单项
+POST {{base_url}}/api/v2/web/order/page
+...
+{"content": {"page":{"current":1,"size":10},"mealtimeTypes":[1]}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+
+# TC-LIST-2 多项组合
+POST {{base_url}}/api/v2/web/order/page
+...
+{"content": {"page":{"current":1,"size":10},"mealtimeTypes":[1,2,3]}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.records" isCollection
+
+# TC-LIST-3 空列表（不过滤）
+POST {{base_url}}/api/v2/web/order/page
+...
+{"content": {"page":{"current":1,"size":10},"mealtimeTypes":[]}}
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+```
+
+#### 4.3 测试场景清单（完整版）
+
+每个查询接口必须覆盖以下场景，按顺序在同一 `.hurl` 文件中组织：
+
+```
+必须生成（顺序执行）：
+TC-BASE    基础分页查询   — 只传必填参数，验证分页结构 + VO 所有字段存在
+TC-TOTAL   合计行验证     — 如返回类型含 totalLine，验证所有合计字段
+TC-DATE-*  日期条件用例   — 若有 startDate/endDate（见上方策略）
+TC-KW-*    关键词用例     — 若有 keyword 类字段（见上方策略）
+TC-ENUM-*  枚举用例       — 若有状态/类型枚举，每个枚举值各一条
+TC-ID-*    外键 ID 用例   — 若有 xxxId 过滤（见上方策略）
+TC-LIST-*  集合用例       — 若有多选字段（见上方策略）
+TC-PAGE    翻页验证       — current=2，验证翻页正确（total > size 时才有意义）
+TC-EMPTY   空结果验证     — 使用必然无数据的条件，验证 records count == 0
+TC-EXPORT  导出接口       — 验证 code=10000（若有导出接口）
+TC-UNAUTH  未授权         — 不带 X-Token，预期 HTTP 401
+```
+
+> **命名规范**：在 Hurl 文件中用注释标注场景编号，便于报告定位：
+> ```hurl
+> # TC-DATE-1 正常日期区间
+> # TC-KW-2 无匹配关键词
+> ```
+
 **数据正确性验证**（不只是结构存在，还要验证值合理）：
 
 ```hurl

package/.claude/skills/code-patterns/SKILL.md

@@ -101,6 +101,120 @@ feat(order): 新增订单导出功能
 Closes #123
 ```
 
+## 数据类型规范
+
+### 布尔语义字段必须使用 Boolean
+
+```java
+// ❌ 错误
+private Integer ifNarrow;
+private Integer isEnabled;
+
+// ✅ 正确
+private Boolean narrow;     // getter 自动生成 isNarrow()
+private Boolean enabled;    // getter 自动生成 isEnabled()
+```
+
+**规则**：
+- 语义为"是/否"的字段，类型必须为 `Boolean`
+- 字段名不加 `if`/`is`/`has` 前缀（JavaBean 规范中 `Boolean` 的 getter 自动生成 `isXxx()`）
+- 数据库字段使用 `TINYINT(1)` 或 `BIT(1)`
+
+### 枚举字段必须提供明确约束
+
+```java
+// ❌ 错误：调用方无法知道合法值
+@ApiModelProperty(value = "操作类型")
+private Integer tradeType;
+
+// ✅ 方案一：VO/DTO 层直接用枚举（推荐）
+@ApiModelProperty(value = "操作类型")
+private AccTradeTypeEnum tradeType;
+
+// ✅ 方案二：保留 Integer 但标注合法值
+@ApiModelProperty(value = "操作类型：1-充值 2-消费 3-退款", allowableValues = "1,2,3")
+private Integer tradeType;
+```
+
+### 金额字段禁止使用浮点类型
+
+```java
+// ❌ 错误
+private Double amount;
+private Float price;
+
+// ✅ 正确：Entity/Service 层用 Long（分），VO 层展示用 BigDecimal（元）
+private Long amountFen;
+private BigDecimal amountYuan;
+```
+
+### 原始类型 vs 包装类型
+
+| 场景 | 用原始类型 | 用包装类型 |
+|------|----------|----------|
+| Entity / VO / DTO 字段 | — | ✅ 统一用包装类型 |
+| 方法参数（不允许 null） | ✅ `int count` | — |
+| 方法参数（允许 null） | — | ✅ `Integer count` |
+| 局部变量 | ✅ `int i = 0` | — |
+
+## Optional 使用规范
+
+```java
+// ❌ 错误：of() 不接受 null，value 为 null 直接 NPE
+Optional.of(value).orElse(defaultValue);
+
+// ✅ 正确：ofNullable() 安全处理 null
+Optional.ofNullable(value).orElse(defaultValue);
+
+// ❌ 禁止：Optional 作为方法参数或类字段
+public void process(Optional<String> name) { ... }
+private Optional<String> name;
+
+// ✅ 允许：Optional 作为方法返回值、链式处理
+public Optional<Entity> findById(Long id) { ... }
+Optional.ofNullable(entity).map(Entity::getConfig).orElse(DEFAULT_VALUE);
+```
+
+## @Transactional 规范
+
+```java
+// ❌ 错误：默认只回滚 RuntimeException
+@Transactional
+public void createOrder() { ... }
+
+// ✅ 正确：显式指定回滚异常
+@Transactional(rollbackFor = Exception.class)
+public void createOrder() { ... }
+```
+
+- 所有 `@Transactional` 必须显式写 `rollbackFor = Exception.class`
+- 只读查询不加 `@Transactional`（或用 `readOnly = true`）
+- 事务方法不要 try-catch 吞掉异常，否则事务不回滚
+
+## TODO 管理规范
+
+```java
+// ❌ 错误：无负责人、无日期、无跟踪
+// TODO 修改一下
+
+// ✅ 正确：完整 TODO 格式
+// TODO(@陈沈杰, 2026-03-20, #TASK-1234): 移动端 AppId 赋值逻辑待产品确认
+```
+
+- 每个 TODO 必须有对应的任务号
+- 超过 2 个迭代未处理的 TODO 必须清理
+- 不用的代码直接删除，不要注释保留
+
+## 代码格式化规范
+
+| 项目 | 规范 |
+|------|------|
+| 缩进 | 4 个空格（不用 Tab） |
+| 行宽 | 120 字符 |
+| 大括号 | K&R 风格（同行开始） |
+| 空行 | 方法间 1 个空行，逻辑块间 1 个空行 |
+| import | 分组排序：java → jakarta → org → net → com，组间空行 |
+
 ## 代码示例
 
 ### 统一响应格式
@@ -161,3 +275,8 @@ public enum OrderStatusEnum {
 | Git 提交信息写"fix bug" | 写清楚修了什么：`fix(order): 修复金额计算精度丢失` |
 | Boolean 变量名：`flag` | 有意义的名字：`isActive`, `hasPermission` |
 | 缩写命名：`usr`, `mgr` | 完整命名：`user`, `manager` |
+| `Optional.of(可能null值)` | `Optional.ofNullable(value)` |
+| `@Transactional` 无 rollbackFor | `@Transactional(rollbackFor = Exception.class)` |
+| TODO 无负责人和日期 | `// TODO(@负责人, 日期, #任务号): 描述` |
+| 布尔字段用 `Integer` | 用 `Boolean` 类型 |
+| 枚举字段无合法值说明 | `@ApiModelProperty` 标注合法值或直接用枚举类型 |

package/.claude/skills/codex-code-review/SKILL.md

@@ -88,6 +88,45 @@ Grep pattern: "@Transactional\((?!.*rollbackFor)" path: [命中文件]
 ```
 - ❌ `@Transactional` → ✅ `@Transactional(rollbackFor = Exception.class)`
 
+#### 🔴 A7b. selectOne 无唯一保障
+```bash
+Grep pattern: "selectOne(" path: [目标目录] glob: "*.java"
+# 命中行检查：是否有 LIMIT 1 或注释说明唯一索引
+```
+- ❌ 无 LIMIT 且无唯一索引 → ✅ 加 `.last("LIMIT 1")` 或确保有唯一索引
+
+#### 🟡 A7c. selectCount 用于存在性判断
+```bash
+Grep pattern: "selectCount" path: [目标目录] glob: "*.java"
+# 检查命中行是否用于 > 0 判断（存在性），而非真正计数
+```
+- ❌ `selectCount(w) > 0` → ✅ `mapper.exists(w)` 或 `selectList(w.last("LIMIT 1"))`
+
+#### 🔴 A7d. Redis KEYS 命令
+```bash
+Grep pattern: "keysByPattern|\.keys\(" path: [目标目录] glob: "*.java"
+```
+- ❌ `redisTemplate.keys()` / `keysByPattern()` → ✅ 使用 Redisson `deleteByPattern()`（内部 SCAN + UNLINK）
+
+#### 🟡 A7e. Optional.of 误用
+```bash
+Grep pattern: "Optional\.of\(" path: [目标目录] glob: "*.java"
+# 排除 ofNullable 的命中
+```
+- ❌ `Optional.of(可能为null)` → ✅ `Optional.ofNullable(value)`
+
+#### 🟡 A7f. 布尔字段类型错误
+```bash
+Grep pattern: "private Integer (if|is|has)" path: [目标目录] glob: "*.java"
+```
+- ❌ `private Integer isEnabled` → ✅ `private Boolean enabled`
+
+#### 🟡 A7g. Wrapper 嵌套过深
+```bash
+# 人工审查：Read 文件时检查 Wrapper 嵌套是否超过 2 层
+```
+- ❌ Wrapper 嵌套 >2 层 → ✅ 迁移到 XML 原生 SQL
+
 #### 🟡 A8. 请求体封装
 ```bash
 Grep pattern: "@RequestBody [^L]" path: [目标目录] glob: "*Controller.java"