adspecs 0.1.33 → 0.1.35

package/skills/adspecs-plan/SKILL.md

@@ -269,7 +269,7 @@ $ARGUMENTS
 
 #### §9 测试场景（必填）
 
-- 正常/异常/边界场景各至少 2 条（场景名称、前置条件、操作步骤、预期结果）
+- 正常/异常/边界场景各至少 3 条（场景名称、前置条件、操作步骤、预期结果）
 
 #### §10 总结（选填）
 

package/skills/adspecs-utest/SKILL.md

@@ -37,6 +37,14 @@ disable-model-invocation: false
 
 本技能**不修改**业务代码、不生成集成测试、不执行测试运行。
 
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+在处理之前**必须**考虑用户输入（若不为空）。
+
 ## 路径配置加载
 
 在开始执行之前，先确定输入/输出目录：
@@ -45,13 +53,25 @@ disable-model-invocation: false
 2. 如果存在，读取其中的 `paths` 对象，提取本技能需要的配置键
 3. 如果不存在或配置键缺失，使用下方表格中的默认值
 
-| 配置键            | 默认值                  | 用途                     |
-| ----------------- | ----------------------- | ------------------------ |
-| `design_dir`      | `docs/30-system-design` | 系统设计文档目录（输入） |
-| `test_report_dir` | `docs/80-development`   | 单元测试报告输出目录     |
+| 配置键            | 默认值                     | 用途                                 |
+| ----------------- | -------------------------- | ------------------------------------ |
+| `design_dir`      | `docs/30-system-design`    | 系统设计文档目录（输入）             |
+| `test_report_dir` | `docs/80-development/802-test` | 单元测试报告输出目录（按模块子目录保存） |
 
 将解析后的路径分别记为 `DESIGN_DIR` 和 `TEST_REPORT_DIR`，后续步骤中引用这些变量而非硬编码路径。
 
+## 输出路径（按模块保存）
+
+与 `/adspecs-prd`、`/adspecs-plan` 保持一致，单元测试报告按模块子目录保存到 `{TEST_REPORT_DIR}/` 下：
+
+1. **识别模块编号（`MODULE_ID`）**：
+   - 优先从用户指定的系统设计文档文件名提取：文件名以模块编号开头（如 `M01-01-产品主数据_system-design.md` → `MODULE_ID = M01-01`）
+   - 若文件名无模块编号前缀，且文件位于 `{DESIGN_DIR}` 的子目录中（如 `{DESIGN_DIR}/crm/`、`{DESIGN_DIR}/M03-02/`），使用该子目录名作为 `MODULE_ID`
+   - 两者均无法识别时，`MODULE_ID` 留空
+2. **确定测试报告输出目录**：
+   - `MODULE_ID` 非空：`{TEST_REPORT_DIR}/{MODULE_ID}/`（如 `docs/80-development/802-test/M01-01/`），子目录不存在时自动创建
+   - `MODULE_ID` 为空：`{TEST_REPORT_DIR}/`（兼容旧行为，不创建模块子目录）
+
 ## 输入
 
 ### 必读文件（按顺序）
@@ -59,18 +79,18 @@ disable-model-invocation: false
 | 序号 | 文件                                                                               | 用途                                                     |
 | ---- | ---------------------------------------------------------------------------------- | -------------------------------------------------------- |
 | 1    | 用户指定的系统设计文件（如 `{DESIGN_DIR}/crm/M01-01-产品主数据_system-design.md`） | 提取 Service 方法、Controller 端点、异常码、§12 测试场景 |
-| 2    | `.adspecs/templates/07-单元测试报告模板.md`                                         | 测试报告的输出模板（6 部分结构）                         |
+| 2    | `.adspecs/templates/07-单元测试报告模板.md`                                        | 测试报告的输出模板（6 部分结构）                         |
 | 3    | `CLAUDE.md`                                                                        | 项目模块结构                                             |
-| 4    | `docs/40-project_conventions/end-integration/index.md`                              | 后端编码规范索引（测试框架、Mock 模式、命名约定等）      |
+| 4    | `docs/40-project_conventions/end-integration/index.md`                             | 后端编码规范索引（测试框架、Mock 模式、命名约定等）      |
 
 ### 参考文件（按需读取）
 
-| 序号 | 文件                                       | 用途                                 |
-| ---- | ------------------------------------------ | ------------------------------------ |
-| 5    | 已有的测试文件（同模块或相邻模块）         | 对齐项目现有测试风格和 Mock 模式     |
-| 6    | 对应的 `*_tasks.md` 文件                   | 了解 T0xx 任务编号与 US 的映射关系   |
-| 7    | 实际的 Service / Controller 源码           | 了解方法签名、依赖注入、业务逻辑细节 |
-| 8    | 对应的 i18n 语言文件                       | 确认消息码与实际异常描述的对应       |
+| 序号 | 文件                               | 用途                                 |
+| ---- | ---------------------------------- | ------------------------------------ |
+| 5    | 已有的测试文件（同模块或相邻模块） | 对齐项目现有测试风格和 Mock 模式     |
+| 6    | 对应的 `*_tasks.md` 文件           | 了解 T0xx 任务编号与 US 的映射关系   |
+| 7    | 实际的 Service / Controller 源码   | 了解方法签名、依赖注入、业务逻辑细节 |
+| 8    | 对应的 i18n 语言文件               | 确认消息码与实际异常描述的对应       |
 
 ### 加载后端编码规范（必选）
 
@@ -85,20 +105,20 @@ disable-model-invocation: false
 
 ### 技术栈
 
-| 项         | 值                                         |
-| ---------- | ------------------------------------------ |
-| 测试框架   | 按后端规范（如 JUnit 5 / pytest 等）       |
+| 项         | 值                                          |
+| ---------- | ------------------------------------------- |
+| 测试框架   | 按后端规范（如 JUnit 5 / pytest 等）        |
 | Mock 框架  | 按后端规范（如 Mockito / unittest.mock 等） |
-| 断言       | 按后端规范的断言库                         |
-| 显示名称   | 按后端规范的测试标注方式                   |
-| 覆盖率目标 | 行覆盖率 100%，分支覆盖率 100%             |
+| 断言       | 按后端规范的断言库                          |
+| 显示名称   | 按后端规范的测试标注方式                    |
+| 覆盖率目标 | 行覆盖率 100%，分支覆盖率 100%              |
 
 ### 测试类命名与位置
 
-| 被测类      | 测试类命名            | 测试类位置                         |
-| ----------- | --------------------- | ---------------------------------- |
-| Service 类  | `{ServiceName}Test`   | 按后端规范的测试目录结构           |
-| Controller 类 | `{ControllerName}Test` | 按后端规范的测试目录结构        |
+| 被测类        | 测试类命名             | 测试类位置               |
+| ------------- | ---------------------- | ------------------------ |
+| Service 类    | `{ServiceName}Test`    | 按后端规范的测试目录结构 |
+| Controller 类 | `{ControllerName}Test` | 按后端规范的测试目录结构 |
 
 ### Service 层测试模式
 
@@ -255,11 +275,11 @@ disable-model-invocation: false
 
 **每个端点至少覆盖**：
 
-| 场景             | 验证内容                                       |
-| ---------------- | ---------------------------------------------- |
-| 正常请求         | 响应对象非空，data 字段正确                    |
-| dto 为 null      | 返回失败响应（Controller 空校验）              |
-| Service 抛出异常 | 异常传播（Controller 不吞异常）                |
+| 场景             | 验证内容                          |
+| ---------------- | --------------------------------- |
+| 正常请求         | 响应对象非空，data 字段正确       |
+| dto 为 null      | 返回失败响应（Controller 空校验） |
+| Service 抛出异常 | 异常传播（Controller 不吞异常）   |
 
 **Controller 测试生成规则**：
 
@@ -289,29 +309,30 @@ disable-model-invocation: false
 
 ### 步骤 6：保存文件
 
-| 输出            | 保存位置                                                           |
-| --------------- | ------------------------------------------------------------------ |
-| Service 测试    | `{模块}-application/{测试目录}/{包路径}/service/impl/{ServiceName}Test` |
+| 输出            | 保存位置                                                                 |
+| --------------- | ------------------------------------------------------------------------ |
+| Service 测试    | `{模块}-application/{测试目录}/{包路径}/service/impl/{ServiceName}Test`  |
 | Controller 测试 | `{模块}-application/{测试目录}/{包路径}/controller/{ControllerName}Test` |
-| 测试报告        | `{TEST_REPORT_DIR}/{模块编号}-{模块名}_单元测试报告.md`            |
+| 测试报告        | `{TEST_REPORT_DIR}/{MODULE_ID}/{模块编号}-{模块名}_单元测试报告.md`（`MODULE_ID` 为空时直接保存到 `{TEST_REPORT_DIR}/`） |
 
 ## 输出
 
 ### 文件命名
 
-| 文件类型        | 命名规则                                | 示例                                  |
-| --------------- | --------------------------------------- | ------------------------------------- |
-| Service 测试    | `{ServiceName}Test.{ext}`（按后端规范） | `CrmProductServiceTest.java`          |
-| Controller 测试 | `{ControllerName}Test.{ext}`（按后端规范） | `CrmProductControllerTest.java`   |
-| 测试报告        | `{模块编号}-{模块名}_单元测试报告.md`   | `M01-01-产品主数据_单元测试报告.md`   |
+| 文件类型        | 命名规则                                   | 示例                                |
+| --------------- | ------------------------------------------ | ----------------------------------- |
+| Service 测试    | `{ServiceName}Test.{ext}`（按后端规范）    | `CrmProductServiceTest.java`        |
+| Controller 测试 | `{ControllerName}Test.{ext}`（按后端规范） | `CrmProductControllerTest.java`     |
+| 测试报告        | `{模块编号}-{模块名}_单元测试报告.md`      | `M01-01-产品主数据_单元测试报告.md` |
 
 ### 输出目录映射
 
-测试代码目录根据系统设计文档的模块元数据和后端规范确定：
+测试代码目录根据系统设计文档的模块元数据和后端规范确定，测试报告按模块子目录保存：
 
-| 系统设计文档中的模块 | 测试代码根路径                               |
-| -------------------- | -------------------------------------------- |
-| 各业务模块           | `{模块}-application/{后端规范测试目录}/`     |
+| 产物                          | 输出目录                                                            |
+| ----------------------------- | ------------------------------------------------------------------- |
+| Service/Controller 测试代码   | `{模块}-application/{后端规范测试目录}/`                            |
+| 测试报告                      | `{TEST_REPORT_DIR}/{MODULE_ID}/`（`MODULE_ID` 为空时 `{TEST_REPORT_DIR}/`） |
 
 ## 测试用例编号规则
 
@@ -350,6 +371,7 @@ disable-model-invocation: false
 ### 测试报告质量
 
 - [ ] 报告 6 个部分全部覆盖
+- [ ] 测试报告保存到模块子目录 `{TEST_REPORT_DIR}/{MODULE_ID}/`，与 PRD、系统设计文档的模块目录结构保持一致
 - [ ] 测试用例清单与生成的测试方法一一对应
 - [ ] 每个用例包含完整的前置条件、输入数据、预期结果
 - [ ] 测试覆盖率表列出所有被测类

package/skills/project-init/SKILL.md

@@ -528,9 +528,9 @@ docs/
 ├── 70-scripts/
 │   └── depoly/
 ├── 80-development/
+│   ├── 800-log/
 │   ├── 801-dev/
 │   └── 802-test/
-│   └── 800-log/
 ├── 100-help/
 └── 300-specs/
 ```
@@ -612,7 +612,7 @@ docs/
 **80-development/**:
 
 - 用途: 开发产物，开发工件和测试工件归档
-- 子目录: `801-dev/` 开发工件, `802-test/` 测试工件
+- 子目录: `801-dev/` 开发工件, `802-test/` 测试工件（/adspecs-utest 单元测试报告默认输出目录）
 - 子目录: `800-log/` 开发日志，AI 会话记录和开发历史追踪
 - 命名规范: `{YYYYMMDD}_{主题}.md` 或 `{YYYYMMDD_HHmmss}_{主题}.md`
 
@@ -1127,7 +1127,7 @@ mkdir -p "$TARGET/.adspecs"
     "sow_dir": "docs/05-sow",
     "prd_dir": "docs/20-prd",
     "design_dir": "docs/30-system-design",
-    "test_report_dir": "docs/80-development",
+    "test_report_dir": "docs/80-development/802-test",
     "session_log_dir": "docs/80-development/800-log",
     "export_dir": "docs/90-export",
     "wiki_dir": "wiki"
@@ -1145,7 +1145,7 @@ mkdir -p "$TARGET/.adspecs"
 | `sow_dir`             | `docs/05-sow`                   | adspecs-write-sow                                                                                                              |
 | `prd_dir`             | `docs/20-prd`                   | adspecs-prd、adspecs-plan（输入）、adspecs-front-spec（输入）、wiki-update（源）                                               |
 | `design_dir`          | `docs/30-system-design`         | adspecs-plan（输出）、adspecs-tasks、adspecs-front-spec（输出）、adspecs-front-tasks、adspecs-utest（输入）、wiki-update（源） |
-| `test_report_dir`     | `docs/80-development`           | adspecs-utest（测试报告）                                                                                                      |
+| `test_report_dir`     | `docs/80-development/802-test`      | adspecs-utest（测试报告，按模块子目录保存）                                                                                   |
 | `session_log_dir`     | `docs/80-development/800-log`   | session-logger（AI 会话日志）                                                                                                  |
 | `export_dir`          | `docs/90-export`                | adspecs-export-word（Word 导出输出）                                                                                           |
 | `wiki_dir`            | `wiki`                          | wiki-update（输出目标）                                                                                                        |

package/src/lib/paths-defaults.js

@@ -14,7 +14,7 @@ const DEFAULT_PATHS = {
   sow_dir: 'docs/05-sow',
   prd_dir: 'docs/20-prd',
   design_dir: 'docs/30-system-design',
-  test_report_dir: 'docs/80-development',
+  test_report_dir: 'docs/80-development/802-test',
   session_log_dir: 'docs/80-development/800-log',
   export_dir: 'docs/90-export',
   wiki_dir: 'wiki',

package/src/lib/readme-gen.js

@@ -97,7 +97,7 @@ const DOCS_READMES = {
     subdirs: [
       { name: '800-log/', desc: '开发日志，AI 会话记录和开发历史追踪' },
       { name: '801-dev/', desc: '开发工件' },
-      { name: '802-test/', desc: '测试工件' },
+      { name: '802-test/', desc: '测试工件（/adspecs-utest 单元测试报告默认输出目录）' },
     ],
     namingConvention: '`{YYYYMMDD}_{主题}.md` 或 `{YYYYMMDD_HHmmss}_{主题}.md`',
   },