visual-spec 0.1.9 → 0.1.10

package/skills/{visual-spec-skill → visual-spec}/SKILL-zh-CN.md

@@ -1,5 +1,5 @@
 ---
-name: "visual-spec-skill"
+name: "visual-spec"
 description: "将原始需求分析为可评审的视觉规格，并生成相关产物。当用户运行 /vspec:new 进行分析或运行 /vspec:verify 生成模型与原型时调用。"
 ---
 
@@ -33,7 +33,7 @@ description: "将原始需求分析为可评审的视觉规格，并生成相关
    - `/docs/refine/`
    - `/docs/dependencies/`
    - 不要创建 `/docs/change/`（已废弃）
-0.2 若用户在命令参数中传入 `lang=<en|zh-CN|ja>`，则将 `/scheme.yaml` 的 `selected.language` 设置为该值（只更新该字段，其他字段与格式保持不变）。
+0.2 若用户在命令参数中传入 `lang=<en|zh|ja>`，则将 `/scheme.yaml` 的 `selected.language` 设置为该值（只更新该字段，其他字段与格式保持不变；`zh-CN` 视为 `zh` 的别名）。
 0.5 尽早创建可编辑的项目约束文件，便于用户提前调整（若已存在则不得覆盖）：
    - 若缺失则创建 `/scheme.yaml`（包含原型选栈 + catalog）
    - 若缺失则创建 `/prototype_ui_convention.md`（与 `/scheme.yaml` 同级）
@@ -109,7 +109,7 @@ description: "将原始需求分析为可评审的视觉规格，并生成相关
 用于基于功能清单展开需求细节。
 
 语言：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）。
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）。
 - `/specs/` 下生成的规格文档必须统一使用所选语言（标题、表格、字段说明、状态文案、按钮文案、提示语等）。
 
 流程：
@@ -155,7 +155,7 @@ description: "将原始需求分析为可评审的视觉规格，并生成相关
 用于生成模型与可运行原型，用于快速验证与评审。
 
 语言：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）。
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）。
 - `/specs/models/` 模型文档与原型界面所有文案必须统一使用所选语言。
 
 流程：
@@ -175,26 +175,6 @@ description: "将原始需求分析为可评审的视觉规格，并生成相关
 12. 加载 `prompts/harness/post_verify_click_check.md` 检查是否存在“按钮/链接点击无反应”的情况；若输出了问题列表，则提示问题并立即结束。
 13. 加载 `prompts/harness/post_verify_verify.md` 检查原型是否覆盖关键约束（移动端/审批/CRUD/布局/登录/RBAC 等）。若输出了问题列表，则提示问题并立即结束。
 
-### `/vspec:proto-survey`
-
-用于在既有原型工程基础上，单独补齐“调查问卷（Survey）”相关页面（Web 管理端 + Mobile 填写端），用于演示问卷配置、发布投放、填写提交与回收统计的闭环。
-
-流程：
-0. 若 `/specs/prototypes/` 不存在或为空：立即停止，并提示先运行 `/vspec:verify` 生成原型工程。
-1. 读取 `/specs/functions/*`、`/specs/details/`、`/specs/models/*.md`、`/specs/background/roles.md`、`/specs/background/dependencies.md` 与 `/scheme.yaml`（如存在）。
-2. 加载 `prompts/vspec_verify/prototype_survey.md` 生成/更新问卷相关页面、路由与 mock 数据。
-3. 仅写入与问卷相关的原型文件改动（增量修改），保持工程可运行。
-
-### `/vspec:proto-auth`
-
-用于在既有原型工程基础上，单独补齐“本系统账号体系（非 SSO）”相关页面（Web + Mobile）：登录、创建账号、忘记/重置密码、修改密码、会话与路由拦截。
-
-流程：
-0. 若 `/specs/prototypes/` 不存在或为空：立即停止，并提示先运行 `/vspec:verify` 生成原型工程。
-1. 读取 `/specs/functions/*`、`/specs/details/`、`/specs/background/roles.md`、`/specs/background/dependencies.md` 与 `/scheme.yaml`（如存在）。
-2. 加载 `prompts/vspec_verify/prototype_auth.md` 生成/更新登录相关页面、路由、session mock 与路由拦截。
-3. 仅写入与账号体系相关的原型文件改动（增量修改），保持工程可运行。
-
 ### `/vspec:qc`
 
 用于对 `/specs/` 下生成的需求产物进行质量检查。
@@ -202,7 +182,7 @@ description: "将原始需求分析为可评审的视觉规格，并生成相关
 Note：Pro 版支持更广泛的质量检测能力（例如更完整的原型/实现后校验项等），需要付费开通。
 
 语言：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）。
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）。
 - `/specs/qc_report.md` 报告必须统一使用所选语言。
 
 流程：
@@ -217,7 +197,7 @@ Note：Pro 版支持更广泛的质量检测能力（例如更完整的原型/
 用于生成验收测试用例。
 
 语言：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）。
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）。
 - `/specs/acceptance/` 下生成的验收文档必须统一使用所选语言。
 
 流程：
@@ -230,7 +210,7 @@ Note：Pro 版支持更广泛的质量检测能力（例如更完整的原型/
 用于基于验收用例与规格生成自动化测试代码。
 
 语言：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）。
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）。
 - 测试用例标题/描述尽量遵循所选语言。
 
 流程：
@@ -257,7 +237,7 @@ Note：Pro 版支持更广泛的质量检测能力（例如更完整的原型/
 用于基于 `/docs/` 下材料（`/docs/legacy` 遗留系统、`/docs/current` 新输入）进行升级/改造分析，并按 `/vspec:new` 相同结构重新生成 `/specs/` 产物。
 
 语言：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）。
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）。
 - 重新生成/更新的 `/specs/**` 产物必须统一使用所选语言。
 
 流程：
@@ -272,7 +252,7 @@ Note：Pro 版支持更广泛的质量检测能力（例如更完整的原型/
 用于把需求拆解为故事地图并进行估算与排期。
 
 语言：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）。
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）。
 - `/specs/plan/plan_estimate.md` 与 `/specs/plan/plan_schedule.html` 必须统一使用所选语言。
 
 流程：

package/skills/{visual-spec-skill → visual-spec}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: "visual-spec-skill"
+name: "visual-spec"
 description: "Analyzes raw requirements into visual specs and generates artifacts. Invoke when user runs /vspec:new for analysis or /vspec:verify for models and prototypes."
 ---
 
@@ -28,8 +28,8 @@ Invoke this skill when:
 Use this command to create a new requirement analysis session.
 
 Language:
-- Read `/scheme.yaml` `selected.language` (supports `en`, `zh-CN`, `ja`; default to `en` if missing/invalid).
-- If the command argument or input explicitly provides `lang=<en|zh-CN|ja>`, use that value for this run and update `selected.language` to it (update only that field).
+- Read `/scheme.yaml` `selected.language` (supports `en`, `zh`, `ja`; default to `en` if missing/invalid).
+- If the command argument or input explicitly provides `lang=<en|zh|ja>`, use that value for this run and update `selected.language` to it (update only that field). `zh-CN` should be treated as an alias of `zh`.
 - When `selected.language=en`, all headings in `/specs/background/original.md` must be English; normalize any non-English headings to:
   `# Raw Requirement`, `# Summary`, `# Business Context`, `# Core Features`, `# Pages & Interactions`, `# Data Model`, `# Business Logic`, `# Risks & Assumptions`, `# Open Questions`.
 
@@ -40,7 +40,7 @@ Flow:
    - `/docs/refine/`
    - `/docs/dependencies/`
    - Do NOT create `/docs/change/` (it is deprecated).
-0.2 If the user passes `lang=<en|zh-CN|ja>` in the command arguments, set `/scheme.yaml` `selected.language` to that value (update only that field, keep other fields and formatting unchanged).
+0.2 If the user passes `lang=<en|zh|ja>` in the command arguments, set `/scheme.yaml` `selected.language` to that value (update only that field, keep other fields and formatting unchanged). `zh-CN` should be treated as an alias of `zh`.
 0.5 Create editable project constraints so the user can tweak them early (do not overwrite if they already exist):
    - Create `/scheme.yaml` with defaults (prototype stack selection + catalog) if missing
    - Create `/prototype_ui_convention.md` (same directory as `/scheme.yaml`) if missing
@@ -116,7 +116,7 @@ Flow:
 Use this command to expand requirement details based on the function list.
 
 Language:
-- Read `/scheme.yaml` `selected.language` (supports `en`, `zh-CN`, `ja`; default to `en` if missing/invalid).
+- Read `/scheme.yaml` `selected.language` (supports `en`, `zh`, `ja`; default to `en` if missing/invalid).
 - All generated spec documents under `/specs/` must use the selected language consistently (headings, tables, field descriptions, statuses, button names, messages).
 
 Flow:
@@ -162,7 +162,7 @@ Flow:
 Use this command to generate models and a runnable prototype for validation.
 
 Language:
-- Read `/scheme.yaml` `selected.language` (supports `en`, `zh-CN`, `ja`; default to `en` if missing/invalid).
+- Read `/scheme.yaml` `selected.language` (supports `en`, `zh`, `ja`; default to `en` if missing/invalid).
 - Generate `/specs/models/` docs and all prototype UI copy in the selected language consistently.
 
 Flow:
@@ -182,26 +182,6 @@ Flow:
 12. Load `prompts/harness/post_verify_click_check.md` to detect clickable UI elements that do nothing. If it outputs any issues, show the issue list and stop.
 13. Load `prompts/harness/post_verify_verify.md` to validate the prototype completeness. If it outputs any issues, show the issue list and stop.
 
-### `/vspec:proto-survey`
-
-Use this command to generate a complete Survey (questionnaire) prototype (Web admin + Mobile filling) on top of an existing prototype project.
-
-Flow:
-0. If `/specs/prototypes/` is missing or empty, stop and ask the user to run `/vspec:verify` first.
-1. Read `/specs/functions/*`, `/specs/details/`, `/specs/models/*.md`, `/specs/background/roles.md`, `/specs/background/dependencies.md`, and `/scheme.yaml` (if any).
-2. Load `prompts/vspec_verify/prototype_survey.md` to generate/update survey pages, routes, and mock data.
-3. Write only survey-related incremental changes and keep the prototype runnable.
-
-### `/vspec:proto-auth`
-
-Use this command to generate a complete non-SSO auth/account page set (Web + Mobile) on top of an existing prototype project.
-
-Flow:
-0. If `/specs/prototypes/` is missing or empty, stop and ask the user to run `/vspec:verify` first.
-1. Read `/specs/functions/*`, `/specs/details/`, `/specs/background/roles.md`, `/specs/background/dependencies.md`, and `/scheme.yaml` (if any).
-2. Load `prompts/vspec_verify/prototype_auth.md` to generate/update auth pages, routes, session mock, and route guards.
-3. Write only auth-related incremental changes and keep the prototype runnable.
-
 ### `/vspec:qc`
 
 Use this command to run a quality check on the generated requirement artifacts under `/specs/`.
@@ -209,7 +189,7 @@ Use this command to run a quality check on the generated requirement artifacts u
 Note: The Pro edition supports broader quality checks (e.g. more post-run prototype/implementation verifications) and requires a paid plan.
 
 Language:
-- Read `/scheme.yaml` `selected.language` (supports `en`, `zh-CN`, `ja`; default to `en` if missing/invalid).
+- Read `/scheme.yaml` `selected.language` (supports `en`, `zh`, `ja`; default to `en` if missing/invalid).
 - The QC report `/specs/qc_report.md` must use the selected language consistently.
 
 Flow:
@@ -224,7 +204,7 @@ Flow:
 Use this command to generate acceptance test cases.
 
 Language:
-- Read `/scheme.yaml` `selected.language` (supports `en`, `zh-CN`, `ja`; default to `en` if missing/invalid).
+- Read `/scheme.yaml` `selected.language` (supports `en`, `zh`, `ja`; default to `en` if missing/invalid).
 - All acceptance documents under `/specs/acceptance/` must use the selected language consistently.
 
 Flow:
@@ -237,7 +217,7 @@ Flow:
 Use this command to generate automation test code based on acceptance cases and specs.
 
 Language:
-- Read `/scheme.yaml` `selected.language` (supports `en`, `zh-CN`, `ja`; default to `en` if missing/invalid).
+- Read `/scheme.yaml` `selected.language` (supports `en`, `zh`, `ja`; default to `en` if missing/invalid).
 - Test case titles/descriptions should follow the selected language as much as possible.
 
 Flow:
@@ -264,7 +244,7 @@ Flow:
 Use this command to upgrade/retrofit requirements based on materials stored under `/docs/` (`/docs/legacy` for legacy system, `/docs/current` for new inputs), and regenerate the `/specs/` artifacts in the same structure as `/vspec:new`.
 
 Language:
-- Read `/scheme.yaml` `selected.language` (supports `en`, `zh-CN`, `ja`; default to `en` if missing/invalid).
+- Read `/scheme.yaml` `selected.language` (supports `en`, `zh`, `ja`; default to `en` if missing/invalid).
 - All regenerated `/specs/**` artifacts must use the selected language consistently.
 
 Flow:
@@ -279,7 +259,7 @@ Flow:
 Use this command to break down requirements, estimate efforts, and schedule via a user story map.
 
 Language:
-- Read `/scheme.yaml` `selected.language` (supports `en`, `zh-CN`, `ja`; default to `en` if missing/invalid).
+- Read `/scheme.yaml` `selected.language` (supports `en`, `zh`, `ja`; default to `en` if missing/invalid).
 - Both `/specs/plan/plan_estimate.md` and `/specs/plan/plan_schedule.html` must use the selected language consistently.
 
 Flow:

package/skills/{visual-spec-skill → visual-spec}/prompts/vspec_more_q/more_q.md

@@ -1,7 +1,7 @@
 你是一名资深业务分析师。你的任务是：在现有 questions 清单的基础上，补充更多“待确认问题”，并追加到 `/specs/background/questions.md` 的末尾，保持可追踪与可回答。
 
 语言与本地化（必须）：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）
 - 新增问题的字段名、状态值与内容必须统一使用该语言；禁止混用其他语言
 
 终止条件（必须）：
@@ -58,6 +58,17 @@
    - 回答时间：
    - 状态：未回答
 
+语言=zh：
+1. 编号：<next_id>
+   - 背景：
+   - 提问：
+   - 提问者：BA/系统分析
+   - 提问时间：
+   - 回答：
+   - 回答者：
+   - 回答时间：
+   - 状态：未回答
+
 语言=ja：
 1. 番号：<next_id>
    - 背景：
@@ -79,4 +90,3 @@
    - 建议的回答方式（在 `questions.md` 逐条填写“回答/回答者/回答时间/状态”）
    - 填写完成后执行 `/vspec:refine-q` 合并答案进入 `original.md`
    - 若暂时无法回答：允许先保留未回答，但需要标注原因/预计时间（写在“回答”里即可）
-

package/skills/{visual-spec-skill → visual-spec}/prompts/vspec_mrd/mrd.md

@@ -1,7 +1,7 @@
 你是一名资深产品经理/市场分析师。你的任务是：基于现有需求信息，输出一份“市场与产品定位分析包”（MRD），用于帮助团队在早期阶段对齐市场环境、竞品格局、用户定位与产品设计方向。
 
 语言与本地化（必须）：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）
 - 本次生成的 4 份文档必须统一使用该语言（标题、表格、字段名、结论文案）；禁止混用其他语言
 
 输入信息包含：

package/skills/{visual-spec-skill → visual-spec}/prompts/vspec_new/background.md

@@ -5,12 +5,12 @@
 请严格按以下步骤执行：
 
 语言与本地化（必须）：
-- 读取 `/scheme.yaml` 的 `selected.language` 作为“文档输出默认语言”（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 读取 `/scheme.yaml` 的 `selected.language` 作为“文档输出默认语言”（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理）
 - 若存在 `/scheme.yaml` `selected.languages`（数组）：将其作为“项目支持语言集合”（用于原型语言切换等）；若缺失则默认 `[selected.language]`
 - 若用户在 `/vspec:new` 命令参数或本次输入中显式指定 `lang=<...>`：
   - 支持两种形式：
-    - 单语言：`lang=en` / `lang=zh-CN` / `lang=ja`
-    - 多语言：`lang=zh-CN,en`（逗号分隔；第一个为文档默认语言；其余为可切换语言；允许 `zh` 作为 `zh-CN` 的别名）
+    - 单语言：`lang=en` / `lang=zh` / `lang=ja`
+    - 多语言：`lang=zh,en`（逗号分隔；第一个为文档默认语言；其余为可切换语言；允许 `zh-CN` 作为 `zh` 的别名）
   - 本次必须以该值为准，并将 `/scheme.yaml` 更新为：
     - `selected.language` = 解析后的第一个语言
     - `selected.languages` = 解析后的语言数组（去重，保序）

package/skills/visual-spec/prompts/vspec_qc/banking_quality_cases.md

@@ -0,0 +1,99 @@
+#### 1. 金额计算口径不清：关键词“金额/精度/舍入/分摊/尾差”
+- 问题分类：模糊表达
+- 关键词：关键词“金额/精度/舍入/分摊/尾差”
+- 问题描述：金额/费用/税费/折扣/汇率换算的口径不清，会导致前后端实现不一致、对账失败、尾差累计、审计不可追溯
+- 错误问题示例：应收 = 单价 * 数量 - 优惠（未说明币种、精度、舍入规则、是否含税、分摊顺序）
+- 解决方案：用“公式表 + 口径说明 + 输入输出样例”明确：币种；精度（小数位）；舍入（round/floor/ceil）与时点；计算顺序；分摊维度与尾差处理（尾差归属策略）；前后端一致性
+- 解决方案示例：应收金额(元)=round(含税单价(元)*数量 - 优惠(元) + 运费(元), 2)；分摊顺序：先分摊优惠再分摊运费；尾差处理：尾差归最后一条明细；提供 3 组输入输出样例
+- 方案收益：避免实现与验收偏差，减少财务差错与返工，提升可测试性与可审计性
+- 应用场景：计费/收费/手续费/利息/分期/分摊/退款/对账等所有涉及金额的需求
+- 关联质量标准：精确性
+
+#### 2. 平账/对账口径缺失：关键词“对账/平账/清算/入账”
+- 问题分类：遗漏关键规则
+- 关键词：关键词“对账/平账/清算/入账”
+- 问题描述：未定义“账目如何平、以谁为准、差异如何处理”，会导致清算失败、财务无法落账、差错无法闭环
+- 错误问题示例：每日对账后生成对账报表（未说明对账维度、差异阈值、差异处理与责任系统）
+- 解决方案：补齐对账模型与流程：对账对象（订单/流水/分录/清算文件）；对账维度键（商户号/渠道/日期/金额/币种/流水号）；对账周期与截止时间（cutoff）；差异分类；差异处理（自动/人工）；以谁为准与回写方式；对账报表口径；可追溯链路
+- 解决方案示例：对账维度=渠道+商户号+交易日+币种；差异阈值=0.01 元；差异类型=缺单/多单/金额不一致/状态不一致；处理=自动生成差错单→分派→补单/冲正/人工复核；以支付渠道清算文件为准，系统侧生成差额分录
+- 方案收益：确保资金与账务一致，降低结算风险，提升运营效率与可审计性
+- 应用场景：支付、清算、分账、代付、充值、退款、资金归集等
+- 关联质量标准：完整性
+
+#### 3. 误差与容差规则缺失：关键词“误差/容差/尾差/差额”
+- 问题分类：边界条件缺失
+- 关键词：关键词“误差/容差/尾差/差额”
+- 问题描述：未定义误差阈值与处理策略，会导致小额差异长期累积、对账无法自动化、争议无法裁决
+- 错误问题示例：对账差额自动处理（未说明差额阈值与归属）
+- 解决方案：明确容差策略：阈值（按币种/渠道/产品不同）；差额归属（平台/商户/渠道/用户）；自动处理条件与审批；累计阈值；报表展示口径；审计留痕
+- 解决方案示例：容差阈值=0.01 元；当差额绝对值<=阈值且同一渠道同日累计<=1 元时自动平账；超出则生成差错单并需财务复核；所有自动平账必须记录原因码与规则版本
+- 方案收益：提升对账自动化率，降低人工成本，减少争议
+- 应用场景：分摊、汇兑、清算、跨系统统计对齐
+- 关联质量标准：一致性
+
+#### 4. 冲正/补记/退款的会计口径不清：关键词“冲正/补记/退款/撤销”
+- 问题分类：状态与动作口径缺失
+- 关键词：关键词“冲正/补记/退款/撤销”
+- 问题描述：冲正与退款/撤销语义混淆，会导致分录方向错误、重复记账、对账无法闭环
+- 错误问题示例：交易失败后做退款处理（未区分“未入账/已入账/已清算”）
+- 解决方案：定义动作语义与前置状态：撤销（未清算/未入账）、冲正（已入账需反向分录）、退款（资金已清算需走资金回退）；定义每个动作的分录模板、状态机、对外通知、对账影响与追溯字段
+- 解决方案示例：已入账但需撤回：生成冲正分录（debit/credit 反向），关联 original_entry_id；退款必须产生 refund_id、refund_entry_id，且与原交易一一关联；提供状态机图与 2 组例子
+- 方案收益：减少财务差错与重复操作，提升可审计性
+- 应用场景：支付/代扣/代付/充值/退款/冲正/撤销
+- 关联质量标准：正确性
+
+#### 5. 幂等与重复扣款/重复入账风险：关键词“幂等/重试/重复扣款/重复入账”
+- 问题分类：可靠性不足
+- 关键词：关键词“幂等/重试/重复扣款/重复入账”
+- 问题描述：金融链路中重试与网络抖动常见，若未设计幂等键与去重策略，会产生重复扣款、重复入账、对账差异与客诉
+- 错误问题示例：请求超时后前端重试下单/扣款（后端未做幂等）
+- 解决方案：定义幂等策略：幂等键来源（业务单号/渠道流水号）；幂等范围（扣款/入账/通知）；去重存储（幂等表/唯一索引）；幂等窗口；并发控制；回放与补偿；对账字段一致性
+- 解决方案示例：idempotency_key=merchant_order_no；扣款接口以该 key 建唯一索引；重复请求返回同一结果（含交易状态）；对账以 channel_txn_id + merchant_order_no 双键匹配
+- 方案收益：降低资金风险与客诉，提升链路可靠性
+- 应用场景：支付/清算/通知回调/批处理/文件导入
+- 关联质量标准：鲁棒性
+
+#### 6. 反洗钱（AML）规则与流程缺失：关键词“KYC/AML/可疑交易/制裁名单”
+- 问题分类：合规缺失
+- 关键词：关键词“KYC/AML/可疑交易/制裁名单”
+- 问题描述：未定义 AML/KYC 要求，会导致合规风险、监管处罚、系统无法通过内控审计
+- 错误问题示例：用户开通后即可大额交易（未做实名/黑名单/可疑监测）
+- 解决方案：补齐合规能力清单：KYC 等级与要素；制裁/黑名单筛查；交易监测规则（阈值、频率、结构化交易、异常地理/设备）；可疑交易处理流程（冻结/人工审核/上报）；留痕与审计字段；数据保留期限
+- 解决方案示例：KYC level=0/1/2；level2 才允许单笔>5 万；命中制裁名单：禁止交易并记录 hit_detail；可疑交易：生成 STR case，状态=待复核/已上报/已结案；所有规则需有 version 与生效时间
+- 方案收益：降低合规风险，提升可审计性与可运营性
+- 应用场景：开户、转账、充值、提现、跨境、交易撮合等
+- 关联质量标准：合规性
+
+#### 7. 反欺诈规则与风控处置缺失：关键词“反欺诈/风控/限额/黑白名单”
+- 问题分类：风险控制缺失
+- 关键词：关键词“反欺诈/风控/限额/黑白名单”
+- 问题描述：未定义风控策略与处置动作，会导致盗刷、套现、撞库、薅羊毛等损失
+- 错误问题示例：活动补贴发放（未限制同设备/同账号/同银行卡多次领取）
+- 解决方案：补齐风控策略：限额（单笔/日/月/渠道/用户等级）；设备指纹/地理位置/行为特征；黑白名单；风险评分阈值；处置（拦截/二次验证/人工审核/冻结）；申诉流程与放行策略；监控告警
+- 解决方案示例：风险分>=80 拦截；60-79 触发短信/人脸二次验证；同设备 24h 内最多领取 1 次；失败原因必须可解释并展示给用户（含客服口径码）
+- 方案收益：降低欺诈损失，提升可运营与可解释性
+- 应用场景：支付、营销补贴、开户、提现、转账、登录
+- 关联质量标准：安全性
+
+#### 8. 利息/汇率/跨币种口径缺失：关键词“计息/利率/汇率/币种”
+- 问题分类：模糊表达
+- 关键词：关键词“计息/利率/汇率/币种”
+- 问题描述：利息计算（年化/日利率）、汇率来源与生效时点不清，会导致金额偏差、争议与审计问题
+- 错误问题示例：按日计息（未说明日切时间、计息基数、是否含当日、利率取值规则）
+- 解决方案：定义金融口径：计息方法（单利/复利）、计息基数（360/365/366）、日切时间与时区、是否含首尾日；汇率来源（中间价/牌价/渠道价）、取价时点、锁价规则与有效期；异常策略（缺汇率/汇率波动）
+- 解决方案示例：日利率=年利率/365；计息天数=自然日，含起息日不含止息日；汇率取支付时刻的渠道汇率并锁定到订单；缺汇率则阻断并给出错误码
+- 方案收益：减少金额争议，提升一致性与可审计性
+- 应用场景：跨境支付、分期、贷款、理财、结售汇
+- 关联质量标准：精确性
+
+#### 9. 数据留痕与不可抵赖不足：关键词“审计/日志/留痕/不可篡改”
+- 问题分类：合规缺失
+- 关键词：关键词“审计/日志/留痕/不可篡改”
+- 问题描述：资金类操作缺少审计留痕（操作者/时间/前后值/原因码/规则版本），会导致无法追责与无法通过审计
+- 错误问题示例：管理员修改限额（未记录修改前后与审批链）
+- 解决方案：定义审计日志矩阵：记录哪些操作；字段级前后值；原因/备注；审批链；日志保留期限；不可篡改策略（WORM/哈希链/签名）；查询与导出权限
+- 解决方案示例：变更限额需审批；审批通过后写入 audit_log：actor、role、ip、device、before/after、reason_code、approval_id、rule_version；审计导出仅合规角色可见
+- 方案收益：提升可审计性与可追责性
+- 应用场景：资金、风控、权限、配置、清算、对账
+- 关联质量标准：可追溯性
+

package/skills/{visual-spec-skill → visual-spec}/prompts/vspec_qc/qc.md

@@ -1,11 +1,12 @@
 你是一名资深交付质量负责人（QA Lead）。你的任务是：基于质量标准对项目内的 `/specs/` 产物进行质量检查，并输出“质量不合格清单”表格。
 
 语言与本地化（必须）：
-- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理；`zh-CN` 视为 `zh` 的别名）
 - 输出报告必须统一使用该语言（标题、表头、描述文案等）；禁止混用其他语言
 
 输入信息：
 - 内嵌质量标准：`prompts/vspec_qc/quality_standard.md`
+- 内嵌领域案例补充：`prompts/vspec_qc/banking_quality_cases.md`（如存在；作为领域补充标准参与合并）
 - 用户质量标准（如存在）：项目根目录下的 `quality_standard.md`
 - 领域/行业质量标准（如存在）：项目根目录下的 `domain_quality_standard.md`
 - 需求质量错题本（如存在）：项目下 `qc/` 目录内的“需求质量错题本”文件（文件名以实际为准）
@@ -17,6 +18,7 @@
    - 生成/更新项目根目录 `quality_standard.md`，用于本次与后续 `/vspec:qc` 的检查
 1. 合并质量标准：
    - 以“内嵌质量标准”为默认基线
+   - 若存在 `prompts/vspec_qc/banking_quality_cases.md`：将其作为内嵌的领域补充标准（优先级高于内嵌基线，但低于项目级覆盖）
    - 若存在 `domain_quality_standard.md`：将其作为“领域/行业规范”补充标准（优先级高于内嵌）
    - 若用户提供 `quality_standard.md`：将其作为项目级补充/覆盖标准（优先级最高；同名条款以用户为准）
 2. 检查范围：
@@ -30,7 +32,7 @@
   - 语言=en：
     - `| ID | Checkpoint | Standard Source | Location | Nonconformance | Severity | Fix Suggestion |`
     - `| --- | --- | --- | --- | --- | --- | --- |`
-  - 语言=zh-CN：
+  - 语言=zh：
     - `| 编号 | 检查点 | 标准来源 | 发现位置 | 不合格描述 | 严重级别 | 修复建议 |`
     - `| --- | --- | --- | --- | --- | --- | --- |`
   - 语言=ja：

package/skills/{visual-spec-skill → visual-spec}/prompts/vspec_qc/quality_standard.md

@@ -1,7 +1,5 @@
 ## 质量规范（内置）
 
-本文件基于 `prompts/vspec_qc/需求分析错题本.xlsx` 整理，用于 `/vspec:qc` 的质量扫描基线。
-
 ### 需求分析错题本规则清单
 
 #### 1. 模糊表达
@@ -776,3 +774,155 @@
 - 方案收益：降低耦合与失败影响面，提升吞吐与可恢复性，减少联调与回归风险
 - 应用场景：涉及异步通知、跨系统集成、长耗时任务、大批量处理、状态机副作用扩散等场景
 - 关联质量标准：完整性
+
+### 需求质量问题类型及解决方案（补充）
+
+#### 104. 模糊表达类：表述不明确、有歧义
+- 问题分类：模糊表达
+- 关键词：关键词“等/随机/高亮/模糊查询/顺序倒序/编号规则/控件命名/超过X天”
+- 问题描述：表述不明确或存在歧义，导致实现与验收口径不一致
+- 错误问题示例：用“等”列举事项；用“随机”描述算法；用“高亮”定义颜色；用“模糊查询”未明确匹配规则；文案“你确认取消吗？”；用“顺序/倒序”描述排序；编号规则仅写“ABC-234格式”；控件无明确名称（如“（？）控件”）；用“超过5天”描述时间范围
+- 解决方案：枚举所有可选项并用列表呈现；明确随机算法与概率；定义颜色 RGB；指定模糊查询类型（前/后/包含）；优化文案并补充影响；用“升序/降序”；用表格拆解编号组成与含义；控件编号明确指代；采用 >=、<=、开闭区间或 T+x/D+x
+- 方案收益：减少歧义与返工，提升可验收性
+- 应用场景：所有规则、算法、查询、排序、编号、文案与范围描述
+- 关联质量标准：精确性
+
+#### 105. 需求遗漏：场景遗漏
+- 问题分类：需求遗漏
+- 关键词：关键词“角色/场景/闭环/旅程”
+- 问题描述：缺失关键角色或关键使用场景，导致功能整体缺一大块
+- 错误问题示例：个人理财 App 遗漏财务顾问角色；收单系统遗漏合同处理功能；新人注册有礼活动忘记引流环节
+- 解决方案：闭环思维按用户视角完整走通；干系人识别梳理角色列表；用对象旅程/用户旅程梳理全功能，并建立小功能检查单
+- 方案收益：避免重大功能缺失，降低上线风险
+- 应用场景：业务场景与角色梳理阶段
+- 关联质量标准：完整性
+
+#### 106. 需求遗漏：流程遗漏
+- 问题分类：需求遗漏
+- 关键词：关键词“流程图/状态-操作/决策矩阵/逆向流程”
+- 问题描述：主流程或逆向流程缺失，或状态-操作组合不完整，导致实现与测试反复确认
+- 错误问题示例：插卡处理流程未考虑卡片损坏的逆向场景；状态-操作组合梳理不完整
+- 解决方案：扫描流程图每个节点挖掘逆向流程；用决策矩阵梳理状态-操作组合，确保覆盖率 100%
+- 方案收益：减少遗漏与返工，提升可测试性
+- 应用场景：流程型业务、状态机业务
+- 关联质量标准：完整性
+
+#### 107. 需求遗漏：细节遗漏
+- 问题分类：需求遗漏
+- 关键词：关键词“格式/加载/控件/交互/响应式/导出/埋点/行业规则”
+- 问题描述：UI/交互/导出/埋点/行业约定等细节缺失，导致实现与体验偏差或验收争议
+- 错误问题示例：数字未定义显示格式；页面加载时控件加载描述缺失；下拉框无空白选项；组合控件交互规则未明确；动画效果描述模糊；响应式页面未说明设备规则；导出报表未明确格式/排序；埋点需求遗漏；行业规则遗漏
+- 解决方案：制定 UI 细节规范；枚举控件并明确加载逻辑；为下拉/选择类控件提供空白/全部选项策略；明确组合控件联动影响；定义动画参数（方向/角度/时长）；制定响应式布局规则；明确导出格式/排序/查询条件；将埋点纳入非功能性需求；收集并明确行业约定
+- 方案收益：减少返工与争议，提升交付一致性
+- 应用场景：页面设计、导出、交互、非功能需求
+- 关联质量标准：完整性
+
+#### 108. 需求遗漏：权限/依赖遗漏
+- 问题分类：需求遗漏
+- 关键词：关键词“角色权限/数据权限/外部依赖/对账/定时任务/时区”
+- 问题描述：权限体系或外部依赖分析不足，会导致越权、数据泄露、联调失败或定时任务错误
+- 错误问题示例：角色定义混乱导致权限遗漏；系统依赖外部对账系统但未分析；定时任务未考虑跨时区影响
+- 解决方案：用角色权限矩阵/数据权限矩阵明确权限边界；用对象生命周期分析外部系统依赖与职责边界；用结构化工具与场景推演梳理定时任务、时区与日切口径
+- 方案收益：降低安全与集成风险，提升可运营性
+- 应用场景：权限、集成、周期任务相关需求
+- 关联质量标准：完整性
+
+#### 109. 需求遗漏：边界/异常遗漏
+- 问题分类：需求遗漏
+- 关键词：关键词“上限/下限/超售/超发/重试/失败提示/并发/快捷键”
+- 问题描述：缺少边界与异常策略会引发线上故障、数据异常与用户体验问题
+- 错误问题示例：库存超售；推广活动超发；数字类型未考虑上限；网络带宽不足导致下载拥堵；批处理出错无重试；上传失败无提示；Ctrl+C/V 跨 App 规则缺失
+- 解决方案：从项目发起者视角分析隐藏上下限；评估技术上限；用枚举/矩阵分析复杂场景影响；明确批处理/上传/通知等出错处理（重试、幂等、降级、提示）
+- 方案收益：降低事故概率，提升鲁棒性
+- 应用场景：并发、资源、批处理、文件、通知等场景
+- 关联质量标准：鲁棒性
+
+#### 110. 干系人识别不足
+- 问题分类：需求遗漏
+- 关键词：关键词“干系人/组织/审批链/运维/合规”
+- 问题描述：未识别关键干系人会导致权限、流程、运维与合规要求遗漏
+- 错误问题示例：OA 考勤审批仅考虑员工提交、HR 审核，未识别 IT 部门、部门负责人
+- 解决方案：通过组织干系图充分识别干系人，并把其目标/约束映射到流程、权限与验收项
+- 方案收益：减少返工与扯皮，提升可落地性
+- 应用场景：企业系统、审批流、跨部门协作场景
+- 关联质量标准：完整性
+
+#### 111. 对称业务流程缺失
+- 问题分类：需求遗漏
+- 关键词：关键词“对称流程/逆向流程/退货/撤销/冲正”
+- 问题描述：只覆盖正向流程而缺少反向/对称流程，导致业务无法闭环
+- 错误问题示例：购物 App 只考虑下单流程，未考虑退货流程
+- 解决方案：识别业务流程的正反两面，并用流程图/状态机补齐对称流程与其权限、数据与日志口径
+- 方案收益：确保闭环交付，减少线上补丁
+- 应用场景：订单/支付/审批/执行等存在撤销/退回/回滚的流程
+- 关联质量标准：完整性
+
+#### 112. 冗余处理/内容类：复杂且难维护的表述
+- 问题分类：冗余处理/内容
+- 关键词：关键词“状态重复/判定矩阵膨胀/纯文本长句/表格长句”
+- 问题描述：存在多余状态、冗长纯文本与膨胀矩阵，导致理解困难与维护成本高
+- 错误问题示例：状态重复命名；判定矩阵膨胀；用纯文本描述复杂条件与流程；长句嵌套；表格中包含长句
+- 解决方案：用过去式命名状态并用流程图去重；拆分独占条件与参数以缩减矩阵；用表达式树/判定矩阵/流程图替代长文本；用符号简化重复词；拆分表格并提供样例数据
+- 方案收益：提升可读性与可维护性，减少遗漏
+- 应用场景：复杂条件、复杂流程、规则引擎类需求
+- 关联质量标准：可维护性
+
+#### 113. 表述/格式类问题：格式不规范与工具混用
+- 问题分类：表述/格式
+- 关键词：关键词“错别字/公式括号/行业规范/UI规范/流程图规范”
+- 问题描述：格式不规范或表达方式晦涩，会导致误读与实现偏差
+- 错误问题示例：错别字；数学公式括号缺失或位置错误；校验规则不符合行业规范；未遵循 UI 规范；流程图符号不规范
+- 解决方案：拼写检查；按国际/国家/行业规范定义校验；导入并定期更新 UI 规范；统一描述工具并遵循流程图规范
+- 方案收益：减少误解与返工，提升规范性
+- 应用场景：文档评审、交互与规则定义
+- 关联质量标准：规范性
+
+#### 114. 逻辑/数据模型错误类：与业务要求不一致
+- 问题分类：逻辑/数据模型错误
+- 关键词：关键词“认证/数据建模/算法/计数/财务记账”
+- 问题描述：处理逻辑或数据模型与业务要求不一致，导致后续实现与验收全错
+- 错误问题示例：身份验证方式不充分（仅单一密码）；数据模型错误导致业务逻辑全错；算法与计数规则错误；财务记账未采用复式记账法；数学公式笔误
+- 解决方案：采用双因素认证或统一身份认证机制；进行正确数据建模并用场景验证；明确算法与计数规则并给出样例；资金/仓储按行业口径；核对公式与括号位置
+- 方案收益：避免致命错误与大规模返工
+- 应用场景：认证、计费、计数、财务、核心算法模块
+- 关联质量标准：正确性
+
+#### 115. 工具使用错误类：滥用或混用描述工具
+- 问题分类：工具使用错误
+- 关键词：关键词“流程图/思维导图/鱼骨图/树形目录/符号规范”
+- 问题描述：不恰当或混用工具导致结构表达不清、不规范
+- 错误问题示例：用流程图处理所有逻辑；同一类关系混用思维导图/鱼骨图/树形目录；流程图中出现非标准符号
+- 解决方案：按场景选择工具；约定同类事物的工具规范；遵循行业标准符号与表达习惯
+- 方案收益：提升表达一致性与可复用性
+- 应用场景：需求文档结构化与可视化表达
+- 关联质量标准：规范性
+
+#### 116. 日志处理缺失类：关键操作不可追溯
+- 问题分类：日志处理缺失
+- 关键词：关键词“导出/批处理/上传/通知/发送结果/审计”
+- 问题描述：关键操作未记录日志，会导致出错后无法追溯、定位与审计
+- 错误问题示例：导出未记录时间/内容/状态；批处理未记录运行时间/数量/结果；上传未记录校验/解析状态；邮件发送未记录发送结果
+- 解决方案：明确日志记录要求：时间、操作者、对象、条件、结果、失败原因、重试与追踪 id，支撑审计与排查
+- 方案收益：提升可追溯性与问题定位效率
+- 应用场景：导出、批处理、文件、通知、外部集成
+- 关联质量标准：可追溯性
+
+#### 117. 易遗漏处理类：刷新/断网/多设备并发等边缘场景
+- 问题分类：容易遗漏的处理
+- 关键词：关键词“刷新/断网/重试/离线/并发冲突/加载反馈/防重复提交/转发收藏”
+- 问题描述：忽略边缘场景会造成数据丢失、冲突或体验差
+- 错误问题示例：刷新导致未保存数据丢失；断网无重试/离线；多设备并发冲突；加载慢无反馈；双击按钮重复提交；转发分享/收藏夹打开规则缺失
+- 解决方案：在通用处理中统一定义刷新/转发/收藏/防重复提交规则；断网提供重试/网络检查/离线策略；并发冲突提供锁/版本号/提示；加载慢使用 skeleton 与超时进度反馈
+- 方案收益：提升体验与稳定性，减少线上投诉
+- 应用场景：Web/移动端通用交互与网络场景
+- 关联质量标准：鲁棒性
+
+#### 118. 重复描述类：重复控件/流程/文案导致维护成本高
+- 问题分类：重复描述
+- 关键词：关键词“通用控件/通用处理/消息列表/多语言”
+- 问题描述：重复描述会形成大量冗余，修改困难且容易遗漏
+- 错误问题示例：多次描述提示框/消息框/查询框；重复描述未保存返回提示；多个相似流程分别描述；多语言场景重复维护同一文案
+- 解决方案：抽取通用控件与通用处理统一描述；抽象相似流程的共性；将重复消息纳入消息列表并支持多语言
+- 方案收益：降低维护成本，提升一致性与复用性
+- 应用场景：全局交互、通用组件、消息文案与多语言
+- 关联质量标准：复用性