refactor(aisee-srs): 收紧下游交接提示边界

sincerely90 · sincerely90 · commit 2e67d778e690 · 2026-06-12T12:10:51.000+08:00
diff --git a/plugins/aisee-plugin/skills/aisee-srs/SKILL.md b/plugins/aisee-plugin/skills/aisee-srs/SKILL.md
@@ -38,7 +38,7 @@ description: 通过结构化对话充分澄清软件类业务需求，并生成
 - 异常、失败、兼容、验收方向和待确认事项
 - 交付形态信号，例如 App、小程序、Web 管理后台、桌面 GUI、后端服务、CLI、导入导出、通知、异步处理
 - 现有项目二开时的新增 / 修改 / 移除 / 兼容行为，以及受影响 baseline 引用
-- 后续是否需要 UI Content、Architecture 或特殊 change artifact 的提示
+- 后续是否需要 UI Content、Architecture 的简短提示，以及仍待确认的关键问题
 
 可以记录但不得展开设计：
 
@@ -109,7 +109,7 @@ Reference loading：
 - 功能需求不得包含实现决策，例如框架选择、具体 API endpoint、数据库 schema、服务拆分或代码文件结构。
 - 不要把 SRS 写成 UI 设计文档。页面字段、列表列、操作和空状态只作为功能合约；视觉布局和详细页面构成留给 UI 内容 / 设计步骤。
 - 不要把 baseline-aware 写成技术设计。已有基线只用于描述业务行为变化、兼容约束和影响范围。
-- 不要把后续交接提示写成实现方案。Section 8 只能说明后续需要哪些上下文、哪些 FR/PAGE/业务对象值得关注。
+- 不要把下游建议写成实现方案或 change-plan 预结果。可选的下游建议只说明是否建议进入 UI Content / Architecture，以及仍待确认的关键问题。
 - 单份 SRS 文档不得超过 20 条 FR；如果总范围超过 20 条 FR，标记为 Epic 并进入 Epic 模式。
 - Epic 模式下，每份模块文档必须包含足够的模块上下文摘要，确保可被 `aisee:change-plan` 单独处理。
 - 模块划分依据业务能力边界，不按输入材料章节、技术层、页面类型、设计规范、架构主题、测试计划或任务阶段直接划分。
diff --git a/plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-epic-main.md b/plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-epic-main.md
@@ -163,44 +163,9 @@ change_refs: []
 
 ---
 
-## 7. 变更候选清单（全局）
+## 7. 下游建议（可选）
 
-> 以下功能需求按优先级和依赖关系排列，可作为 `aisee:change-plan` 的输入。FR ID 链接到对应模块文档。
-
-| 优先级 | 需求 ID | 标题 | 变更类型 | 影响基线 | 所属模块 | 估计规模 | 依赖 |
-|--------|---------|------|----------|----------|----------|----------|------|
-| P0 | [{scope}:FR-001](./01-{module-a}.md#fr-001) | {title} | 新增 / 修改 / 移除 / 兼容 | {baseline ref or 无} | {模块 A} | M | 无 |
-| P0 | [{scope}:FR-002](./01-{module-a}.md#fr-002) | {title} | 修改 | {openspec/specs/...} | {模块 A} | S | {scope}:FR-001 |
-| P1 | [{scope}:FR-003](./02-{module-b}.md#fr-003) | {title} | 新增 | 无 | {模块 B} | L | 无 |
-
----
-
-## 8. 后续交接提示
-
-### 8.1 UI Content 建议
-
-| 模块 / FR | 是否建议生成 UI Content | 原因 | 关注点 |
-|-----------|--------------------------|------|--------|
-| {模块 / FR-xxx} | 是/否 | {多页面 / 多角色 / 多端 / 状态反馈复杂 / 无 UI} | {页面入口、状态、权限、流程等} |
-
-### 8.2 Architecture 建议
-
-| 关注点 | 是否需要补充 | 原因 |
-|--------|--------------|------|
-| 技术栈状态 | 是/否 | {已明确 / 未明确 / 既有项目需扫描} |
-| 既有能力复用 | 是/否 | {鉴权、权限、文件、通知、队列、审计等} |
-| 外部系统 / 异步处理 / 数据迁移 | 是/否 | {原因} |
-
-### 8.3 Change Plan 输入提示
-
-- 建议优先拆分的业务边界：{module / flow / role / state}
-- 不建议拆散的能力：{reason}
-- 需要在 change authoring 前确认的问题：{Q-xxx or 无}
-
-**下一步**：将各模块文档路径传入 `aisee:change-plan`，进行 Change 边界规划：
-
-\`\`\`
-aisee:change-plan aisee/docs/requirements/{slug}/01-{module-a}.md
-aisee:change-plan aisee/docs/requirements/{slug}/02-{module-b}.md
-\`\`\`
+- UI Content：需要 / 不需要；关注模块：{模块 A / 模块 B / N/A}
+- Architecture：需要 / 不需要；关注点：{共享能力复用、权限模型、外部系统、异步处理或 N/A}
+- 进入后续规划前仍需确认：{Q-xxx / 无}
 ```
diff --git a/plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-epic-module.md b/plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-epic-module.md
@@ -108,28 +108,9 @@ change_refs: []
 
 ---
 
-## 7. 模块变更候选清单
+## 7. 本模块下游建议（可选）
 
-> 以下功能需求按优先级和依赖关系排列，可作为 `aisee:change-plan` 的输入。只列出本模块范围内的 FR。
-
-| 优先级 | 需求 ID | 标题 | 变更类型 | 影响基线 | 估计规模 | 依赖 |
-|--------|---------|------|----------|----------|----------|------|
-| P0 | {scope}:FR-{XXX} | {title} | 新增 / 修改 / 移除 / 兼容 | {baseline ref or 无} | M | 无 |
-| P1 | {scope}:FR-{YYY} | {title} | 修改 | {openspec/specs/...} | S | {scope}:FR-{XXX} |
-
----
-
-## 8. 本模块后续交接提示
-
-| 后续环节 | 建议 | 原因 / 关注点 |
-|----------|------|---------------|
-| UI Content | 需要 / 不需要 | {页面、窗口、状态、权限、多端差异等} |
-| Architecture | 需要 / 不需要 | {既有系统、技术栈、外部系统、异步任务、数据迁移等} |
-| Change Plan | 注意事项 | {建议边界、不可拆散的流程、关键依赖、Open Questions} |
-
-**下一步**：将本文档路径传入 `aisee:change-plan`，进行 Change 边界规划：
-
-\`\`\`
-aisee:change-plan aisee/docs/requirements/{slug}/{module-file}.md
-\`\`\`
+- 是否建议生成 UI Content：是/否；关注点：{页面入口、表单、列表、权限、状态或 N/A}
+- 是否建议补充 Architecture：是/否；关注点：{共享能力、外部系统、异步处理、权限模型或 N/A}
+- 仍待确认的问题：{Q-xxx or 无}
 ```
diff --git a/plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-standard.md b/plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-standard.md
@@ -181,43 +181,9 @@ change_refs: []
 
 ---
 
-## 7. 变更候选清单
+## 7. 下游建议（可选）
 
-> 以下功能需求按优先级和依赖关系排列，可作为 `aisee:change-plan` 的输入。
-
-| 优先级 | 需求 ID | 标题 | 变更类型 | 影响基线 | 估计规模 | 依赖 |
-|--------|---------|------|----------|----------|----------|------|
-| P0 | {scope}:FR-001 | {title} | 新增 / 修改 / 移除 / 兼容 | {baseline ref or 无} | M | 无 |
-| P0 | {scope}:FR-002 | {title} | 修改 | {openspec/specs/...} | S | {scope}:FR-001 |
-| P1 | {scope}:FR-003 | {title} | 新增 | 无 | L | 无 |
-
----
-
-## 8. 后续交接提示
-
-### 8.1 UI Content 建议
-
-| 模块 / FR | 是否建议生成 UI Content | 原因 | 关注点 |
-|-----------|--------------------------|------|--------|
-| {模块 / FR-xxx} | 是/否 | {多页面 / 多角色 / 多端 / 状态反馈复杂 / 无 UI} | {页面入口、状态、权限、流程等} |
-
-### 8.2 Architecture 建议
-
-| 关注点 | 是否需要补充 | 原因 |
-|--------|--------------|------|
-| 技术栈状态 | 是/否 | {已明确 / 未明确 / 既有项目需扫描} |
-| 既有能力复用 | 是/否 | {鉴权、权限、文件、通知、队列、审计等} |
-| 外部系统 / 异步处理 / 数据迁移 | 是/否 | {原因} |
-
-### 8.3 Change Plan 输入提示
-
-- 建议优先拆分的业务边界：{module / flow / role / state}
-- 不建议拆散的能力：{reason}
-- 需要在 change authoring 前确认的问题：{Q-xxx or 无}
-
-**下一步**：将本文档路径传入 `aisee:change-plan`，进行 Change 边界规划：
-
-\`\`\`
-aisee:change-plan aisee/docs/requirements/{filename}.md
-\`\`\`
+- UI Content：需要 / 不需要；关注点：{页面入口、状态反馈、权限可见性、跨页面流程或 N/A}
+- Architecture：需要 / 不需要；关注点：{既有能力复用、外部系统、权限模型、异步处理或 N/A}
+- 实施前仍需确认：{Q-xxx / 无}
 ```
diff --git a/plugins/aisee-plugin/skills/aisee-srs/evals/evals.json b/plugins/aisee-plugin/skills/aisee-srs/evals/evals.json
@@ -18,11 +18,11 @@
           "用户只给出初步业务范围，没有完整规则、权限、异常和 MVP 边界。"
         ]
       },
-      "expected_output": "应先做业务需求澄清，确认用户、业务目标、MVP、规则、权限和异常；生成的 SRS 应包含 FR、业务对象与状态、变更候选清单和后续交接提示；不得输出 API path、数据库表字段、前端组件或实现任务。",
+      "expected_output": "应先做业务需求澄清，确认用户、业务目标、MVP、规则、权限和异常；生成的 SRS 应包含 FR、业务对象与状态，以及精简的下游建议（如是否需要 UI Content / Architecture）；不得输出 API path、数据库表字段、前端组件、实现任务或 change-plan 预结果。",
       "expected_outputs": [
         "先澄清优惠券类型、领取/使用/停用规则、权限、异常和 MVP 范围。",
-        "生成 SRS 时包含功能需求、业务对象与状态、验收方向、变更候选清单和后续交接提示。",
-        "把 UI Content、Architecture、change-plan 的后续输入提示分开说明。"
+        "生成 SRS 时包含功能需求、业务对象与状态、验收方向，以及精简的下游建议。",
+        "只简要说明 UI Content、Architecture 是否需要，不预写 change-plan 结果。"
       ],
       "must_ask": [
         "优惠券类型、面额、门槛、有效期、发放数量和停用规则是否有业务限制？",
@@ -32,8 +32,7 @@
       "must_include": [
         "FR 列表",
         "业务对象与状态",
-        "变更候选清单",
-        "后续交接提示"
+        "精简下游建议"
       ],
       "must_not": [
         "不得输出 API path。",
@@ -60,11 +59,11 @@
           "用户明确说明没有页面。"
         ]
       },
-      "expected_output": "应识别为非 UI 型需求，SRS 应覆盖业务对象、等级规则、定时触发、通知、异常和验收方向；Section 8 应标注 UI Content 不需要、Architecture 需要，change-plan 可能需要 job/service contract；不得硬造页面。",
+      "expected_output": "应识别为非 UI 型需求，SRS 应覆盖业务对象、等级规则、定时触发、通知、异常和验收方向；精简下游建议应标注 UI Content 不需要、Architecture 需要，并可提示后续可能涉及 job/service contract；不得硬造页面。",
       "expected_outputs": [
         "识别为后端/定时任务型需求，不生成页面清单。",
         "覆盖会员等级、消费统计窗口、升级/降级规则、定时触发、通知、异常和验收方向。",
-        "交接提示中说明 UI Content 可标为 N/A，Architecture 和后续 service/job contract 需要。"
+        "精简下游建议中说明 UI Content 可标为 N/A，Architecture 需要，并提示后续可能涉及 service/job contract。"
       ],
       "must_ask": [
         "等级规则、升级和降级是否都在本期？",
diff --git a/plugins/aisee-plugin/skills/aisee-srs/references/domain-rules.md b/plugins/aisee-plugin/skills/aisee-srs/references/domain-rules.md
@@ -25,9 +25,9 @@
 
 ## 交付形态信号
 
-根据交付形态决定后续交接提示：
+根据交付形态决定是否给出精简下游建议：
 
-| 信号 | 后续提示 |
+| 信号 | 下游建议 |
 |------|----------|
 | 屏幕、页面、弹窗、表单、导航、角色可见 UI | 通常需要 UI Content |
 | 组件库、视觉方向、Design Tokens、参考截图 | 通常需要 Design Spec |
diff --git a/plugins/aisee-plugin/skills/aisee-srs/references/workflow.md b/plugins/aisee-plugin/skills/aisee-srs/references/workflow.md
@@ -93,7 +93,7 @@ Baseline-aware 模式不得：
 - 待确认假设：{list or "无"}
 - 已识别风险：{list or "无"}
 - 基线感知：启用 / 未启用（如启用，列出主要影响基线）
-- 后续建议：UI Content 需要 / 不需要；Architecture 需要 / 不需要；change-plan 输入是否已充足
+- 后续建议：UI Content 需要 / 不需要；Architecture 需要 / 不需要；仍待确认的关键问题
 - 输出模式：标准模式 / Epic 模式
 
 主流程预览：
@@ -105,7 +105,7 @@ Baseline-aware 模式不得：
 
 ```text
 需求体量较大，将生成 1 份主文档 + {N} 份模块文档。
-主文档：系统概述、跨模块约束、术语表、变更候选清单
+主文档：系统概述、跨模块约束、术语表和全局约束
 模块文档：{模块 1} / {模块 2} / ...
 ```
 
@@ -125,7 +125,7 @@ Baseline-aware 模式不得：
 4. 只读取 `references/scenario-extension-blocks.md` 中与当前场景相关的块。
 5. 为 `FR / NFR / RULE / FLOW / STATE` 预留正式 ID，或在工具不可用时标注临时 ID。
 6. 填写所有已确认需求、假设、Open Questions 和 baseline-aware 字段。
-7. 在交接章节写明给 `aisee:ui-content`、`aisee:architecture` 和 `aisee:change-plan` 的规划提示；不得补实现级设计。
+7. 仅在有价值时追加精简下游建议：是否建议进入 `aisee:ui-content`、`aisee:architecture`，以及仍待确认的关键问题；不得预写 `aisee:change-plan` 结果或实现级设计。
 
 ### Epic 模式
 
@@ -134,7 +134,7 @@ Baseline-aware 模式不得：
 Step 1：生成主文档。
 
 - 读取 `assets/srs-template.md`、`references/writing-rules.md` 和 `assets/srs-template-epic-main.md`。
-- 包含系统概述、全局上下文、非功能需求、约束、假设、Open Questions、模块索引和变更候选索引。
+- 包含系统概述、全局上下文、非功能需求、约束、假设、Open Questions 和模块索引。
 - 详细 FR 放入模块文档；主文档中每个 FR 都链接到对应模块文档。
 - 如果启用 baseline-aware 模式，写明全局基线影响，并在可用时标注每个 FR 的变更类型和影响基线。
 
@@ -144,7 +144,7 @@ Step 2：逐个生成模块文档。
 
 - 读取 `assets/srs-template-epic-module.md`。
 - 只读取该模块需要的场景扩展块。
-- 每份模块文档都必须包含足够的局部上下文，确保能单独传给 `aisee:change-plan`：模块目的、相关用户、业务对象 / 状态、关键规则、非目标、FR 详情、模块假设、Open Questions 和交接提示。
+- 每份模块文档都必须包含足够的局部上下文，确保能单独传给 `aisee:change-plan`：模块目的、相关用户、业务对象 / 状态、关键规则、非目标、FR 详情、模块假设和 Open Questions；下游建议仅在确有价值时精简保留。
 - 如果启用 baseline-aware 模式，每条 FR 都必须包含变更类型和影响基线。
 
 每份模块文档生成后暂停，并询问是否继续。
diff --git a/plugins/aisee-plugin/skills/aisee-srs/references/writing-rules.md b/plugins/aisee-plugin/skills/aisee-srs/references/writing-rules.md
@@ -70,17 +70,17 @@
 - 仅在 baseline-aware 模式下填写；没有可识别基线时写“未发现可信基线来源”，不要猜。
 - 只记录用户可观察业务行为、角色权限、状态、流程、入口、兼容要求的影响。
 - 不写 API endpoint、数据库表字段、ORM、代码模块、迁移脚本或实现方案。
-- 每条受影响 FR 必须在 FR 正文和 Section 7 中标注“变更类型”和“影响基线”。
+- 每条受影响 FR 必须在 FR 正文中标注“变更类型”和“影响基线”。
 - 影响基线来源优先级：`openspec/specs/` > active change artifacts > `aisee/docs/spec-migration/` > 历史 SRS > 用户明确说明 > 从代码推断（低可信，必须标注）。
 
 ### Section 6：Open Questions
 
 - 对话中提及但未解决的事项放这里，不放进 FR 正文。
 - 用户未提及但实现时必须明确的事项也放这里，注明：`(未在需求中提及 — 实施前请确认)`。
 
-### Section 7：变更候选清单
+### Section 7：下游建议（可选）
 
-- 规模估算是粗估，`aisee:change-plan` 会细化。
-- 依赖关系与 FR 正文中的“依赖”字段保持一致。
-- Epic 模式下，主文档 Section 7 中的 FR ID 必须附相对路径链接指向对应模块文档。
-- baseline-aware 模式下，必须包含“变更类型”和“影响基线”列，便于 `aisee:change-plan` 生成 source-map seed。
+- 这一节是可选的；只在确实能帮助后续交接时保留。
+- 只说明是否建议进入 `aisee:ui-content`、`aisee:architecture`，以及实施前仍待确认的关键问题。
+- 不写 change 边界拆分、规模估算、依赖排序、source-map seed 或其它 `aisee:change-plan` 预结果。
+- 不把 UI Content、Architecture 或后续 artifact 的详细内容提前写进本节。
diff --git a/tests/test_skill_cli_preflight.py b/tests/test_skill_cli_preflight.py
@@ -118,6 +118,27 @@ def test_planning_doc_output_templates_use_frontmatter_without_duplicate_header_
                 assert marker not in text
 
 
+def test_srs_skill_keeps_downstream_hints_minimal() -> None:
+    expected_present = {
+        "plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-standard.md": "## 7. 下游建议（可选）",
+        "plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-epic-main.md": "## 7. 下游建议（可选）",
+        "plugins/aisee-plugin/skills/aisee-srs/assets/srs-template-epic-module.md": "## 7. 本模块下游建议（可选）",
+        "plugins/aisee-plugin/skills/aisee-srs/references/writing-rules.md": "### Section 7：下游建议（可选）",
+    }
+    forbidden_markers = [
+        "变更候选清单",
+        "Change Plan 输入提示",
+        "change-plan 输入是否已充足",
+        "规模估算是粗估",
+    ]
+
+    for relative_path, required_marker in expected_present.items():
+        text = (ROOT / relative_path).read_text(encoding="utf-8")
+        assert required_marker in text
+        for marker in forbidden_markers:
+            assert marker not in text
+
+
 def test_cli_outputs_keep_marketplace_recovery_hints() -> None:
     import sys
 
