visual-spec 0.1.8 → 0.1.9

package/skills/visual-spec-skill/prompts/vspec_detail/logging_matrix.md

@@ -1,5 +1,9 @@
 你是一名资深系统分析师 + 可观测性负责人。你的任务是：针对“单个功能点”，输出是否需要记录日志，并以矩阵形式呈现，写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 交互与处理逻辑（如有）
@@ -15,9 +19,16 @@
    - 业务流水/轨迹（状态流转、审批轨迹）
    - 系统运行日志（异常、超时、重试）
    - 集成日志（外部调用/回调/对账）
-2. 输出日志矩阵（必须），表头固定：
-| 事件/动作 | 是否记录 | 日志类型 | 记录时机 | 关键字段 | 脱敏字段 | 保留期 | 触发角色/系统 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+2. 输出日志矩阵（必须），表头必须严格按所选语言使用以下版本之一：
+   - 语言=en：
+     - `| Event/Action | Log? | Log Type | Timing | Key Fields | Masked Fields | Retention | Actor (Role/System) | Notes |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=zh-CN：
+     - `| 事件/动作 | 是否记录 | 日志类型 | 记录时机 | 关键字段 | 脱敏字段 | 保留期 | 触发角色/系统 | 备注 |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=ja：
+     - `| イベント/操作 | 記録するか | ログ種別 | 記録タイミング | 主要フィールド | マスク対象 | 保持期間 | 実行者（役割/システム） | 備考 |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- |`
 3. “关键字段”至少包含：对象主键、业务单号、状态前后值、操作者、trace_id/request_id（如适用）。
 4. 若不记录，也要写明原因（例如无安全/审计要求、可从其他日志追溯）。
 

package/skills/visual-spec-skill/prompts/vspec_detail/mq.md

@@ -1,5 +1,9 @@
 你是一名资深分布式系统架构师。你的任务是：当“单个功能点涉及 MQ/事件总线/消息队列”时，输出可落地的消息设计与可靠性方案；若不涉及 MQ，输出“不涉及 MQ”即可。结果写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 场景与流程（`/specs/background/scenarios.md`、`/specs/flows/*.puml`、`/specs/background/scenario_details/` 或 `/specs/background/scenario_details.md`（旧版））
@@ -11,9 +15,16 @@
    - 事件通知（领域事件）
    - 异步处理（耗时任务/批处理）
    - 跨系统集成（对外发布/订阅）
-2. 输出“消息清单表”（必须），表头固定：
-| 事件/消息名 | Topic/Queue | 生产者 | 消费者 | 触发条件 | 消息体 schema（字段列表） | 幂等键 | 顺序要求 | 重试策略 | DLQ 策略 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+2. 输出“消息清单表”（必须），表头必须严格按所选语言使用以下版本之一：
+   - 语言=en：
+     - `| Event/Message | Topic/Queue | Producer | Consumer | Trigger | Payload Schema (Fields) | Idempotency Key | Ordering | Retry | DLQ | Notes |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=zh-CN：
+     - `| 事件/消息名 | Topic/Queue | 生产者 | 消费者 | 触发条件 | 消息体 schema（字段列表） | 幂等键 | 顺序要求 | 重试策略 | DLQ 策略 | 备注 |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=ja：
+     - `| イベント/メッセージ | Topic/Queue | 生産者 | 消費者 | トリガー | ペイロードschema（フィールド） | 冪等キー | 順序要件 | リトライ | DLQ | 備考 |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
 3. schema 字段列表要求至少包含：
    - event_id（全局唯一）
    - event_time

package/skills/visual-spec-skill/prompts/vspec_detail/nfp.md

@@ -1,5 +1,9 @@
 你是一名资深架构师 + SRE/安全负责人。你的任务是：针对“当前模块/整体方案”（跨多个功能点），汇总非功能性需求（NFR/NFP），覆盖性能、压测、安全、兼容、容错、稳定性，并输出可验收的约束与检查点，写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 标题与正文文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前模块：模块名 + 该模块下的功能点清单（来自 `/specs/functions/*`）
 - 已生成的细节（如有）：RBAC、数据权限、交互、校验、MQ、通知、导入导出、定时任务等（来自 `/specs/details/`）
@@ -8,13 +12,28 @@
 
 产出要求（必须）：
 1. 仅针对“当前模块/整体方案”输出，不要泛泛而谈；内容必须可落地、可测试、可验收。
-2. 以小节形式输出，标题固定如下（必须全部出现；不适用则写 Not Applicable 并说明原因）：
-   - 性能（Performance）
-   - 压力/容量（Load & Stress）
-   - 安全（Security）
-   - 兼容（Compatibility）
-   - 容错/降级（Fault Tolerance）
-   - 稳定性/可用性（Stability & Availability）
+2. 以小节形式输出，标题必须严格按所选语言使用以下版本之一（必须全部出现；不适用则写 `Not Applicable` 并说明原因）：
+   - 语言=en：
+     - `## Performance`
+     - `## Load & Stress`
+     - `## Security`
+     - `## Compatibility`
+     - `## Fault Tolerance`
+     - `## Stability & Availability`
+   - 语言=zh-CN：
+     - `## 性能（Performance）`
+     - `## 压力/容量（Load & Stress）`
+     - `## 安全（Security）`
+     - `## 兼容（Compatibility）`
+     - `## 容错/降级（Fault Tolerance）`
+     - `## 稳定性/可用性（Stability & Availability）`
+   - 语言=ja：
+     - `## 性能（Performance）`
+     - `## 負荷/容量（Load & Stress）`
+     - `## セキュリティ（Security）`
+     - `## 互換性（Compatibility）`
+     - `## 耐障害/フォールバック（Fault Tolerance）`
+     - `## 安定性/可用性（Stability & Availability）`
 3. 每个小节至少包含：
    - 约束/目标：清晰指标或边界（例如延迟/吞吐/并发/峰值/数据量/可用性目标等，若无法定量则给出定性验收口径）
    - 关键风险：为什么需要该约束（结合该功能点的流程、依赖、数据权限、外部调用、任务形态等）

package/skills/visual-spec-skill/prompts/vspec_detail/notification_matrix.md

@@ -1,5 +1,9 @@
 你是一名资深系统分析师 + 产品运营负责人。你的任务是：针对“单个功能点”，输出是否需要发送通知，并以矩阵形式呈现，写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 角色与组织（`/specs/background/roles.md`）
@@ -12,9 +16,16 @@
    - 短信
    - IM（企业微信/钉钉等）
    - Webhook（第三方回调）
-2. 输出通知矩阵（必须），表头固定：
-| 事件/动作 | 是否通知 | 通知渠道 | 触发时机 | 接收人规则 | 模板变量 | 去重/频控 | 失败处理 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+2. 输出通知矩阵（必须），表头必须严格按所选语言使用以下版本之一：
+   - 语言=en：
+     - `| Event/Action | Notify? | Channel | Timing | Recipient Rule | Template Variables | Dedupe/Rate Limit | Failure Handling | Notes |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=zh-CN：
+     - `| 事件/动作 | 是否通知 | 通知渠道 | 触发时机 | 接收人规则 | 模板变量 | 去重/频控 | 失败处理 | 备注 |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=ja：
+     - `| イベント/操作 | 通知するか | チャネル | タイミング | 受信者ルール | テンプレ変数 | 重複排除/頻度制御 | 障害対応 | 備考 |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- |`
 3. 接收人规则要可实现（示例）：
    - `record.approver_ids`
    - `record.owner_id`

package/skills/visual-spec-skill/prompts/vspec_detail/page_load.md

@@ -1,5 +1,9 @@
 你是一名资深前端架构师 + 业务分析师。你的任务是：针对“单个页面型功能点”，输出页面加载逻辑（首屏、路由参数、请求顺序、并发、缓存、降级），并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 标题、表头与正文文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 数据模型（`/specs/models/*.md`）
@@ -7,11 +11,11 @@
 - 外部依赖（`/specs/background/dependencies.md`）
 
 适用性判断：
-- 若该功能点不是页面（例如定时任务/批处理/接口），输出“非页面：不适用”，并简要说明触发方式与入口即可。
+- 若该功能点不是页面（例如定时任务/批处理/接口），输出“Non-page: Not Applicable / 非页面：不适用 / 非ページ：不適用”（按所选语言），并简要说明触发方式与入口即可。
 
 产出要求（页面场景）：
 0. 原型访问地址（必须）：
-   - 输出“原型访问”小节，给出可点击链接，点击后在新 tab 打开：
+   - 输出“Prototype Links/原型访问/プロトタイプリンク”小节（按所选语言），给出可点击链接，点击后在新 tab 打开：
      - 原型首页：`http://localhost:5173/`（若端口不同可自行替换）
      - 当前页面路由：根据本功能点推荐路由拼出完整 URL（例如 `http://localhost:5173/apply`）
      - 场景确认页：相对路径链接到 `scenario.html`（从当前 md 文件到 `/specs/prototypes/scenario.html`），并用 `<a target="_blank">` 形式输出
@@ -27,15 +31,38 @@
    - 拉取列表/详情数据
    - 计算派生状态（按钮是否可用、步骤条）
 4. 接口与数据依赖清单（用表格）：
-| 请求 | 触发时机 | 入参来源 | 出参用途 | 失败处理 | 缓存策略 |
-| --- | --- | --- | --- | --- | --- |
-5. 数据加载条件（当涉及数据筛选/权限/状态机/时间范围等时必须输出，避免笼统描述）：
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Request | Trigger | Input Source | Output Usage | Failure Handling | Cache Strategy |`
+    - `| --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 请求 | 触发时机 | 入参来源 | 出参用途 | 失败处理 | 缓存策略 |`
+    - `| --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| リクエスト | トリガー | 入力元 | 出力用途 | 障害対応 | キャッシュ戦略 |`
+    - `| --- | --- | --- | --- | --- | --- |`
+5. 数据加载条件（必须输出，避免笼统描述）：
    - 用“SQL 语义”描述主要 where 条件与 join 关系（不要求完全可执行，但要精确表达过滤口径）
-   - 至少覆盖：租户/组织范围、数据权限范围、状态过滤、时间范围、关键字搜索、排序/分页
+   - 至少覆盖（按适用填写；不适用则明确写“无/Not Applicable/該当なし”，不得留空也不得用口号替代）：
+     - 租户/组织范围
+     - 数据权限范围
+     - 状态过滤
+     - 时间范围
+     - 关键字搜索
+     - 排序/分页
+   - 禁止使用模糊表述（例如“按业务规则过滤”“按权限过滤”“按时间过滤”）；必须写成可执行的条件或伪代码（例如 `org_id in {…}`、`status in (…)`、`created_at in [start,end)`）
    - 输出格式（二选一，优先 A）：
      - A. 条件清单表（推荐）：
-       | 场景/查询 | 主表 | 关联表（如有） | 关键条件（SQL 语义） | 排序与分页 | 备注 |
-       | --- | --- | --- | --- | --- | --- |
+       - 表头必须严格按所选语言使用以下版本之一：
+         - 语言=en：
+           - `| Scenario/Query | Main Table | Joined Tables (if any) | Key Conditions (SQL semantics) | Sorting & Paging | Notes |`
+           - `| --- | --- | --- | --- | --- | --- |`
+         - 语言=zh-CN：
+           - `| 场景/查询 | 主表 | 关联表（如有） | 关键条件（SQL 语义） | 排序与分页 | 备注 |`
+           - `| --- | --- | --- | --- | --- | --- |`
+         - 语言=ja：
+           - `| シナリオ/検索 | 主テーブル | 結合テーブル（あれば） | 主要条件（SQLセマンティクス） | ソート/ページング | 備考 |`
+           - `| --- | --- | --- | --- | --- | --- |`
      - B. SQL 伪代码块：
        - `SELECT ... FROM ... LEFT JOIN ... WHERE ... ORDER BY ... LIMIT ... OFFSET ...`
 6. 并发与顺序：

package/skills/visual-spec-skill/prompts/vspec_detail/payment.md

@@ -1,5 +1,9 @@
 你是一名资深支付系统分析师。你的任务是：针对“单个功能点”输出支付与退款的业务与技术细节，确保能覆盖支付/退款相关场景，并可落地实现与验收。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 标题与正文文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 角色与权限（`/specs/background/roles.md`）
@@ -12,7 +16,7 @@
 - 功能/子功能/说明或场景中出现：支付/收款/结算/下单/订单/退款/售后/对账/回调/支付渠道/发票 等任一关键词
 - 或数据模型中出现：order/pay/payment/refund/transaction/bill/settlement 等语义对象或字段
 
-产出结构（必须按顺序输出，且中文化）：
+产出结构（必须按顺序输出；标题与内容按所选语言输出）：
 1. 支付链路概览：
    - 支付对象：订单/报名/补考/购买等（明确本功能点对应的业务对象）
    - 支付方式与通道：列出可选项与适用范围（例如微信/支付宝/线下/余额），并说明是否由配置控制
@@ -44,7 +48,7 @@
    - 谁可以发起退款/审批退款/查看对账（引用 rbac 与 data_permission 口径）
 8. 前端交互（必须）：
    - 支付入口必须从订单/业务单详情进入（说明路由或入口）
-   - 提交成功后跳转到成功页（如 `/payment/success` 或业务 `*/success`），失败必须给出中文完整句子提示与重试入口
+   - 提交成功后跳转到成功页（如 `/payment/success` 或业务 `*/success`），失败提示文案必须使用所选语言的完整句子并提供重试入口
    - 若存在退款：退款成功后订单必须仍保留在订单列表/详情中，并标记为“已退款”，且可追溯退款信息（金额/时间/退款单号 mock）
 9. 发票/开票（命中则必须）：
    - 若涉及订单/支付且存在开票需求：必须说明发票申请入口、字段（抬头/税号/邮箱/内容类目）、状态流转（未开票/开票中/已开票）、下载/预览与记录查询

package/skills/visual-spec-skill/prompts/vspec_detail/post_submit_check.md

@@ -1,5 +1,9 @@
 你是一名资深系统分析师。你的任务是：针对“单个功能点”，输出页面/任务提交后的检查项（提交已发生后的二次校验与一致性检查），并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 数据模型与状态机（`/specs/models/*.md`、`/specs/background/scenario_details/` 或 `/specs/background/scenario_details.md`（旧版））
@@ -8,8 +12,16 @@
 产出要求：
 1. 明确“提交”动作指代（表单提交/审批动作/执行开始/结束/取消/变更/导入/导出/定时任务触发）
 2. 输出检查清单表（必须）：
-| 编号 | 检查点 | 触发时机 | 检查规则（伪代码） | 失败处理（回滚/补偿/提示/重试） | 影响范围 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| ID | Checkpoint | Timing | Rule (Pseudocode) | Failure Handling (Rollback/Compensate/Message/Retry) | Impact Scope | Notes |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 编号 | 检查点 | 触发时机 | 检查规则（伪代码） | 失败处理（回滚/补偿/提示/重试） | 影响范围 | 备注 |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 番号 | チェック項目 | タイミング | ルール（擬似コード） | 障害対応（ロールバック/補償/表示/リトライ） | 影響範囲 | 備考 |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
 3. 检查点类型至少覆盖：
    - 并发一致性（版本号/乐观锁/重复提交）
    - 状态机一致性（非法状态流转）

package/skills/visual-spec-skill/prompts/vspec_detail/post_submit_navigation.md

@@ -1,17 +1,29 @@
 你是一名资深产品经理 + 前端架构师。你的任务是：针对“单个页面型功能点”，输出提交后的返回策略与跳转规则，并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 场景与流程（`/specs/background/scenarios.md`、`/specs/flows/*.puml`）
 - 角色与权限（`/specs/background/roles.md`、RBAC 产物如有）
 
 适用性判断：
-- 若该功能点不是页面，输出“非页面：不适用”，并说明其结果反馈方式（日志/通知/回调/任务状态页）。
+- 若该功能点不是页面，输出“Non-page: Not Applicable / 非页面：不适用 / 非ページ：不適用”（按所选语言），并说明其结果反馈方式（日志/通知/回调/任务状态页）。
 
 产出要求（页面场景）：
 1. 输出跳转规则表（必须）：
-| 触发动作 | 成功后提示 | 成功后跳转 | 成功后是否刷新来源页 | 失败后提示 | 失败后停留/回退策略 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Trigger | Success Message | Success Redirect | Refresh Source Page? | Failure Message | Failure Stay/Back Strategy | Notes |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 触发动作 | 成功后提示 | 成功后跳转 | 成功后是否刷新来源页 | 失败后提示 | 失败后停留/回退策略 | 备注 |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| トリガー | 成功メッセージ | 成功後遷移 | 元ページを更新するか | 失敗メッセージ | 失敗時の滞在/戻る戦略 | 備考 |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
 2. 必须覆盖与本功能点相关的动作：
    - 提交/保存草稿/撤销/取消/变更/审批通过/驳回/执行开始/执行结束/紧急叫停/导入/导出
 3. 若需要跨页面联动（例如提交后进入详情、审批后回到待办并移除该条），在备注中写清楚“来源页行为”。

package/skills/visual-spec-skill/prompts/vspec_detail/post_submit_processing.md

@@ -1,5 +1,9 @@
 你是一名资深系统分析师。你的任务是：针对“单个功能点”，输出提交后的处理逻辑（后置处理、异步任务、数据变更、集成调用、补偿），并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 场景与流程（`/specs/flows/*.puml`、`/specs/background/scenarios.md`）
@@ -8,8 +12,16 @@
 
 产出要求：
 1. 以“处理步骤清单”输出（必须）：
-| 步骤 | 处理内容 | 同步/异步 | 输入 | 输出/数据变更 | 失败处理（重试/补偿/人工介入） | 幂等策略 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Step | Processing | Sync/Async | Inputs | Outputs/Data Changes | Failure Handling (Retry/Compensate/Manual) | Idempotency | Notes |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 步骤 | 处理内容 | 同步/异步 | 输入 | 输出/数据变更 | 失败处理（重试/补偿/人工介入） | 幂等策略 | 备注 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 手順 | 処理内容 | 同期/非同期 | 入力 | 出力/データ変更 | 障害対応（リトライ/補償/手動介入） | 冪等性 | 備考 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
 2. 必须覆盖：
    - 状态变更与历史记录（状态机流转、流水/轨迹）
    - 关联数据更新（子表、汇总、派生字段）

package/skills/visual-spec-skill/prompts/vspec_detail/rbac.md

@@ -1,5 +1,9 @@
 你是一名资深业务分析师 + 安全架构师。你的任务是：针对“单个功能点（通常对应一个页面或一个可操作的功能）”，输出 RBAC 权限设计，精确到页面区域与控件级别，并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 输出文档的标题、表头、字段名、说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 角色列表与任务（`/specs/background/roles.md`）
@@ -17,12 +21,28 @@
 4. 输出 2 张表：
 
 表 1：页面区域/控件权限矩阵（必须）
-| 区域 | 控件/组件 | 动作 | permission_key | 权限名称 | 允许角色 | 条件（可选） | 备注 |
-| --- | --- | --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Area | Control/Component | Action | permission_key | Permission Name | Allowed Roles | Conditions (Optional) | Notes |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 区域 | 控件/组件 | 动作 | permission_key | 权限名称 | 允许角色 | 条件（可选） | 备注 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| エリア | コントロール/コンポーネント | アクション | permission_key | 権限名 | 許可ロール | 条件（任意） | 備考 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
 
 表 2：页面级路由/菜单访问权限（如为页面则必须；非页面则输出“功能访问入口权限”）
-| 入口 | 类型（路由/菜单/按钮/接口） | permission_key | 权限名称 | 允许角色 | 备注 |
-| --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Entry | Type (Route/Menu/Button/API) | permission_key | Permission Name | Allowed Roles | Notes |`
+    - `| --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 入口 | 类型（路由/菜单/按钮/接口） | permission_key | 权限名称 | 允许角色 | 备注 |`
+    - `| --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 入口 | 種別（ルート/メニュー/ボタン/API） | permission_key | 権限名 | 許可ロール | 備考 |`
+    - `| --- | --- | --- | --- | --- | --- |`
 
 5. 若存在“仅本人/本部门/本组织/审批链相关人”等限制，将限制条件写入“条件（可选）”，并说明依赖的数据权限字段（例如 owner_id、org_id）。
 

package/skills/visual-spec-skill/prompts/vspec_detail/state_machine.md

@@ -1,5 +1,9 @@
 你是一名资深业务分析师 + 系统分析师。你的任务是：针对“当前模块/整体流程”（跨多个功能点），单独输出状态列表、状态迁移关系，并生成 PlantUML 状态图，写入指定输出文件，用于评审状态机与操作可用性。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前模块：模块名 + 功能点清单（来自 `/specs/functions/*` 聚合）
 - 场景与流程（`/specs/flows/*.puml`、`/specs/background/scenarios.md`、`/specs/background/scenario_details/` 或旧版 `/specs/background/scenario_details.md`）
@@ -11,15 +15,37 @@
 
 产出要求（必须）：
 1. 状态列表（必须用 markdown 表格）：
-| 状态 | 含义 | 进入条件/触发事件 | 允许的关键操作（概览） | 退出条件 |
-|:--|:--|:--|:--|:--|
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| State | Meaning | Entry Condition/Trigger | Allowed Key Actions (Overview) | Exit Condition |`
+    - `|:--|:--|:--|:--|:--|`
+  - 语言=zh-CN：
+    - `| 状态 | 含义 | 进入条件/触发事件 | 允许的关键操作（概览） | 退出条件 |`
+    - `|:--|:--|:--|:--|:--|`
+  - 语言=ja：
+    - `| 状態 | 意味 | 進入条件/トリガー | 許可される主要操作（概要） | 離脱条件 |`
+    - `|:--|:--|:--|:--|:--|`
 2. 状态迁移表（必须用 markdown 表格）：
-| From | Trigger（用户动作/系统事件） | Guard（条件/权限/数据权限） | To | 副作用（数据变更/通知/MQ/日志/资源占用） |
-|:--|:--|:--|:--|:--|
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| From | Trigger (User Action/System Event) | Guard (Condition/RBAC/Data Scope) | To | Side Effects (Data/Notify/MQ/Logs/Resource) |`
+    - `|:--|:--|:--|:--|:--|`
+  - 语言=zh-CN：
+    - `| From | Trigger（用户动作/系统事件） | Guard（条件/权限/数据权限） | To | 副作用（数据变更/通知/MQ/日志/资源占用） |`
+    - `|:--|:--|:--|:--|:--|`
+  - 语言=ja：
+    - `| From | Trigger（ユーザー操作/システムイベント） | Guard（条件/RBAC/データ権限） | To | 副作用（データ/通知/MQ/ログ/リソース） |`
+    - `|:--|:--|:--|:--|:--|`
 3. 状态图（必须输出 PlantUML 代码块）：
    - 只输出一个代码块，且必须以 `@startuml` 开始、以 `@enduml` 结束
    - 必须覆盖本模块端到端流程中涉及的状态与迁移（至少覆盖 apply/approve/change/cancel/execute 相关语义中实际存在的部分）
    - 每条迁移箭头必须标注 Trigger；如有关键 Guard，用 `[ ... ]` 标注在箭头文案中
+4. “暂停/继续”仅在确有必要时才纳入状态机（必须满足至少一条）：
+   - 需求/口径中明确出现“暂停/继续/恢复/断点续跑/继续处理”等语义
+   - 存在长任务/运行态且业务要求可中断并继续（例如导入/导出/批处理/考试/播放/上传）
+   - 模型/流程中已有 `paused`/`suspended`/`on_hold` 等状态，或已有 pause/resume 相关操作
+   - 若纳入：必须包含 Paused/暂停态 的进入条件、退出条件（Resume/继续）、以及暂停期间允许/禁止的关键操作（与 decision_matrix 一致）
+   - 若不满足：不得新增暂停态/继续操作
 
 输出写入：
 - 将结果写入上游指定的 markdown 文件路径（通常在 `/specs/details/<module_slug>/state_machine/<module_slug>.md`）

package/skills/visual-spec-skill/prompts/vspec_detail/timeline.md

@@ -1,5 +1,10 @@
 你是一名资深业务分析师 + 交互设计师。你的任务是：针对“当前模块/整体流程”（跨多个功能点），当流程存在“长时间跨度”且时间规则会影响流程走向（时间范围判定/时间窗口/生效期/截止期/宽限期/跨天口径/包含边界等）时，用固定模板输出一份时间轴（HTML），以时间轴形式呈现判定结果与行为，避免文字口径歧义，并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- HTML 中所有用户可见文案（标题、表头、说明、图例）必须与所选语言一致；禁止混用其他语言
+- 不允许改动 HTML 的结构层级与 class 名称；仅允许替换可见文案与填充值占位符
+
 输入信息（由上游提供）：
 - 当前模块/流程范围：模块名（从 `/specs/functions/*` 聚合）+ 该模块相关的场景与流程
 - 场景与流程（`/specs/flows/*.puml`、`/specs/background/scenarios.md`、`/specs/background/scenario_details/` 或 `/specs/background/scenario_details.md`（旧版））
@@ -65,12 +70,12 @@ HTML 模板（必须逐字遵守结构；不要输出任何 markdown 文本，
   </head>
   <body>
     <div class="vreq-timeline">
-      <h1 class="vreq-title">时间轴：{功能点名称}</h1>
+      <h1 class="vreq-title">{TITLE}</h1>
       <div class="vreq-meta">
         <table>
-          <tr><th>时间口径</th><td>{时区/自然日切换点/取值字段口径}</td></tr>
-          <tr><th>时间范围</th><td>min={最早时间点}；max={最晚时间点}</td></tr>
-          <tr><th>说明</th><td>{一句话说明本时间轴用于判定什么}</td></tr>
+          <tr><th>{META_TIME_CONVENTION_LABEL}</th><td>{时区/自然日切换点/取值字段口径}</td></tr>
+          <tr><th>{META_TIME_RANGE_LABEL}</th><td>min={最早时间点}；max={最晚时间点}</td></tr>
+          <tr><th>{META_NOTES_LABEL}</th><td>{一句话说明本时间轴用于判定什么}</td></tr>
         </table>
       </div>
 
@@ -106,13 +111,36 @@ HTML 模板（必须逐字遵守结构；不要输出任何 markdown 文本，
       </div>
 
       <div class="legend">
-        <div class="legend-item"><span class="legend-dot inclusive"></span><span>包含边界</span></div>
-        <div class="legend-item"><span class="legend-dot exclusive"></span><span>不包含边界</span></div>
+        <div class="legend-item"><span class="legend-dot inclusive"></span><span>{LEGEND_INCLUSIVE}</span></div>
+        <div class="legend-item"><span class="legend-dot exclusive"></span><span>{LEGEND_EXCLUSIVE}</span></div>
       </div>
     </div>
   </body>
 </html>
 
+占位符本地化（必须）：
+- 语言=en：
+  - `{TITLE}` = `Timeline: {功能点名称}`
+  - `{META_TIME_CONVENTION_LABEL}` = `Time Convention`
+  - `{META_TIME_RANGE_LABEL}` = `Time Range`
+  - `{META_NOTES_LABEL}` = `Notes`
+  - `{LEGEND_INCLUSIVE}` = `Inclusive`
+  - `{LEGEND_EXCLUSIVE}` = `Exclusive`
+- 语言=zh-CN：
+  - `{TITLE}` = `时间轴：{功能点名称}`
+  - `{META_TIME_CONVENTION_LABEL}` = `时间口径`
+  - `{META_TIME_RANGE_LABEL}` = `时间范围`
+  - `{META_NOTES_LABEL}` = `说明`
+  - `{LEGEND_INCLUSIVE}` = `包含边界`
+  - `{LEGEND_EXCLUSIVE}` = `不包含边界`
+- 语言=ja：
+  - `{TITLE}` = `タイムライン：{功能点名称}`
+  - `{META_TIME_CONVENTION_LABEL}` = `時間口径`
+  - `{META_TIME_RANGE_LABEL}` = `時間範囲`
+  - `{META_NOTES_LABEL}` = `説明`
+  - `{LEGEND_INCLUSIVE}` = `境界を含む`
+  - `{LEGEND_EXCLUSIVE}` = `境界を含まない`
+
 布局与填充规则（必须遵守）：
 1. 位置计算：用百分比填写每个 tick 的 left，以及每个 segment 的 left/width，确保时间从左到右递增；同一时间点在所有 lane 的 left 必须一致
 2. ticks：必须覆盖所有用于判定的关键时间点（开始/结束/截止/生效/失效/关账等），并按时间顺序排列

package/skills/visual-spec-skill/prompts/vspec_detail/validation_matrix.md

@@ -1,5 +1,9 @@
 你是一名资深业务分析师 + 测试分析师。你的任务是：针对“单个功能点（页面或任务）”，输出校验逻辑，并以矩阵形式呈现，写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 数据模型（`/specs/models/*.md`）
@@ -8,10 +12,17 @@
 
 产出要求：
 1. 本文件只输出“页面字段的校验规则”（如果该功能点不是页面或没有字段校验，输出“无字段校验”即可）。
-2. 输出为 1 张表（必须），表头固定如下（不要改动列名与顺序）：
+2. 输出为 1 张表（必须），表头必须严格按所选语言使用以下版本之一（不要改动列名与顺序）：
 
-| 字段 | 必填 | 格式 | 长度 | 范围 | 唯一 | 其他 |
-| --- | --- | --- | --- | --- | --- | --- |
+   - 语言=en：
+     - `| Field | Required | Format | Length | Range | Unique | Others |`
+     - `| --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=zh-CN：
+     - `| 字段 | 必填 | 格式 | 长度 | 范围 | 唯一 | 其他 |`
+     - `| --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=ja：
+     - `| フィールド | 必須 | 形式 | 長さ | 範囲 | 一意 | その他 |`
+     - `| --- | --- | --- | --- | --- | --- | --- |`
 
 3. 字段含义与填写规则（必须遵守）：
    - 必填：必填填 `√`，非必填留空

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

@@ -0,0 +1,82 @@
+你是一名资深业务分析师。你的任务是：在现有 questions 清单的基础上，补充更多“待确认问题”，并追加到 `/specs/background/questions.md` 的末尾，保持可追踪与可回答。
+
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 新增问题的字段名、状态值与内容必须统一使用该语言；禁止混用其他语言
+
+终止条件（必须）：
+1. 若 `/specs/background/questions.md` 不存在：立即结束，不做任何写入；仅输出一句“未找到 questions.md，请先执行 /vspec:new 生成基础 questions 清单，再执行 /vspec:more-q”。
+
+输入信息包含：
+- 现有需求归档与分析：`/specs/background/original.md`
+- 现有问答列表：`/specs/background/questions.md`（必须读取，用于去重与续编号）
+- 可参考：`/specs/background/*.md`、`/specs/flows/*.puml`、`/specs/functions/*`、`/specs/background/dependencies.md`
+
+梳理规则（必须）：
+1. 只补充“确实影响范围/规则/验收”的问题：
+   - 不要问泛泛的问题（例如“还有别的吗？”）
+   - 每条必须能被业务方给出明确答案，并能反向更新需求/设计
+2. 必须去重：
+   - 不得重复已有问题（语义相同视为重复）
+   - 若只是已有问题的更细化子问：允许补充，但必须在“背景”说明与原编号的关系（例如“补充编号 12 的边界口径”）
+3. 覆盖维度至少包含（按缺口优先补齐）：
+   - 边界与范围（包含/不包含、上下限、默认值、空值、异常）
+   - 状态与操作（暂停/继续/撤回/取消/驳回/变更/紧急叫停等的口径）
+   - 数据口径（字段含义、单位、精度、舍入、时间口径、唯一性）
+   - 权限与数据权限（角色、组织范围、越权处理、审计）
+   - 外部依赖（系统职责边界、接口清单、失败策略、幂等、对账与补偿）
+   - 资料与模板（导入/导出模板、通知文案、协议、证书等）
+4. 数量控制：
+   - 默认补充 8-15 条（除非需求非常简单或已无明显缺口）
+
+输出与写入要求：
+1. 只输出“新增的问题条目”（不要重写旧内容），用于追加到 `/specs/background/questions.md` 的末尾
+2. 新条目的编号必须延续已有最大编号：
+   - 先从现有 `questions.md` 中找出最大编号（按所选语言：`编号/ID/番号`），新增条目从 `max+1` 开始递增
+3. 输出格式必须严格按所选语言使用以下版本之一（字段名与顺序必须一致）：
+
+```md
+语言=en：
+1. ID: <next_id>
+   - Context:
+   - Question:
+   - Asker: BA/System Analyst
+   - Asked At:
+   - Answer:
+   - Answered By:
+   - Answered At:
+   - Status: Unanswered
+
+语言=zh-CN：
+1. 编号：<next_id>
+   - 背景：
+   - 提问：
+   - 提问者：BA/系统分析
+   - 提问时间：
+   - 回答：
+   - 回答者：
+   - 回答时间：
+   - 状态：未回答
+
+语言=ja：
+1. 番号：<next_id>
+   - 背景：
+   - 質問：
+   - 質問者：BA/システム分析
+   - 質問日時：
+   - 回答：
+   - 回答者：
+   - 回答日時：
+   - 状態：未回答
+```
+
+4. 追加后必须保证文件末尾存在“回答指引”小节（若已存在则不要重复追加）：
+   - 语言=en：`## How to Answer`
+   - 语言=zh-CN：`## 回答指引`
+   - 语言=ja：`## 回答手順`
+
+   指引内容（按语言输出）必须包含：
+   - 建议的回答方式（在 `questions.md` 逐条填写“回答/回答者/回答时间/状态”）
+   - 填写完成后执行 `/vspec:refine-q` 合并答案进入 `original.md`
+   - 若暂时无法回答：允许先保留未回答，但需要标注原因/预计时间（写在“回答”里即可）
+