visual-spec 0.1.8 → 0.1.9

package/skills/visual-spec-skill/SKILL.md

@@ -27,12 +27,20 @@ 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).
+- 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`.
+
 Flow:
 0. Ensure `/docs/` exists, and ensure subfolders exist:
    - `/docs/legacy/`
    - `/docs/current/`
-   - `/docs/change/`
    - `/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.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
@@ -41,7 +49,7 @@ Flow:
 3. Load the prompt file at `prompts/vspec_new/background.md`.
 4. Use that prompt to analyze the requirement and expand the business context.
 5. Write the raw requirement and background analysis output to `/specs/background/original.md`.
-6. Ask the user to answer the questions from the `待确认问题` section.
+6. Ask the user to answer the questions from the Open Questions section (use the section title in the selected language).
 7. After the user replies, load `prompts/vspec_new/stakeholders.md` to analyze stakeholders.
 8. Write the stakeholder result to `/specs/background/stakeholder.md` (markdown table).
 9. Load `prompts/vspec_new/roles.md` to analyze system user roles (direct users) and their work tasks.
@@ -91,12 +99,26 @@ Flow:
 4. Load `prompts/vspec_refine/refine_q.md` to merge answers into the canonical requirement.
 5. Append the refinement result to `/specs/background/original.md`.
 6. Update `/specs/background/questions.md` to mark items that are treated as answered in this run:
-   - Wrap the `回答` and `状态` values with `<mark>...</mark>` so the answered items are visually highlighted.
+   - Wrap the answer and status values with `<mark>...</mark>` (use the field names in the selected language) so answered items are visually highlighted.
+
+### `/vspec:more-q`
+
+Use this command to generate more clarification questions and append them to `/specs/background/questions.md`.
+
+Flow:
+1. If `/specs/background/questions.md` is missing, stop and ask the user to run `/vspec:new` first.
+2. Load `prompts/vspec_more_q/more_q.md` to generate additional questions (avoid duplicates and continue numbering).
+3. Append the new items to `/specs/background/questions.md` (do not rewrite existing items).
+4. Provide a clear instruction for the user to answer the questions and then run `/vspec:refine-q`.
 
 ### `/vspec:detail`
 
 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).
+- All generated spec documents under `/specs/` must use the selected language consistently (headings, tables, field descriptions, statuses, button names, messages).
+
 Flow:
 1. Read the feature/function list from `/specs/functions/*`.
    - You must iterate every function row across all files under `/specs/functions/` (not just core.md), so no module or external-system function is missed.
@@ -139,6 +161,10 @@ 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).
+- Generate `/specs/models/` docs and all prototype UI copy in the selected language consistently.
+
 Flow:
 0. Ensure `/specs/details/` exists and is non-empty; if missing, stop and output the prerequisite message: “Run /vspec:detail to generate /specs/details/ before /vspec:verify”.
 1. If `/specs/background/questions.md` exists and contains unanswered questions, ask the user to answer them before continuing (allow skip per question, but ensure none remains unanswered).
@@ -182,6 +208,10 @@ 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).
+- The QC report `/specs/qc_report.md` must use the selected language consistently.
+
 Flow:
 1. Read built-in standard at `prompts/vspec_qc/quality_standard.md`.
 2. If a requirement quality error book exists under project `qc/`, generate/update project root `quality_standard.md` based on it.
@@ -193,6 +223,10 @@ 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).
+- All acceptance documents under `/specs/acceptance/` must use the selected language consistently.
+
 Flow:
 1. Read `/specs/functions/*`, `/specs/background/scenarios.md`, `/specs/background/scenario_details/`, `/specs/background/roles.md`, `/specs/models/*.md`.
 2. Load `prompts/vspec_accept/accept.md` to generate acceptance test cases covering core flows, exceptions, boundary, permissions, and data scope.
@@ -202,6 +236,10 @@ 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).
+- Test case titles/descriptions should follow the selected language as much as possible.
+
 Flow:
 1. Read `/specs/acceptance/`, `/specs/functions/*`, `/specs/details/`, and detect the existing test frameworks in the repository.
 2. Load `prompts/vspec_test/test.md` to generate automation tests using the existing frameworks and conventions.
@@ -225,6 +263,10 @@ 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).
+- All regenerated `/specs/**` artifacts must use the selected language consistently.
+
 Flow:
 1. Ensure the input entry file exists at `/docs/current/file_list.md`; if missing, generate it with the expected input list template.
 2. Read `/docs/current/file_list.md`, then read the listed sources under `/docs/` (typically `/docs/legacy/*`, `/docs/current/*`, optionally `/docs/templates/*`, `/docs/texts/*`, `/docs/assets/*`) in order and extract structured information (functions, dependencies, UI style, roles/permissions, technical spec).
@@ -236,6 +278,10 @@ 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).
+- Both `/specs/plan/plan_estimate.md` and `/specs/plan/plan_schedule.html` must use the selected language consistently.
+
 Flow:
 1. Read `/specs/functions/*`, `/specs/background/roles.md`, `/specs/background/scenarios.md`, `/specs/details/`, `/specs/background/dependencies.md`.
 2. Load `prompts/vspec_plan/estimate.md` to generate estimates aligned to the function list.
@@ -243,6 +289,20 @@ Flow:
 4. Load `prompts/vspec_plan/schedule.md` to generate the schedule and delivery map.
 5. Write schedule HTML to `/specs/plan/plan_schedule.html`.
 
+### `/vspec:mrd`
+
+Use this command to generate a market research and product positioning pack (MRD): market landscape, competitor analysis, user positioning, and product design notes.
+
+Flow:
+1. Ensure `/docs/market/` exists.
+2. Read baseline artifacts when available: `/specs/background/original.md`, `/specs/background/roles.md`, `/specs/background/terms.md`, `/specs/background/scenarios.md`, `/specs/flows/*.puml`, `/specs/background/dependencies.md`, and `/specs/functions/*` (if any).
+3. Load `prompts/vspec_mrd/mrd.md`.
+4. Write outputs to:
+   - `/docs/market/market.md`
+   - `/docs/market/competitors.md`
+   - `/docs/market/users.md`
+   - `/docs/market/product_design.md`
+
 ## Prompt Files
 
 - `prompts/vspec_new/background.md`: the prompt used right after `/vspec:new` receives the raw requirement.
@@ -259,6 +319,8 @@ Flow:
 - `prompts/vspec_new/dependencies.md`: the prompt used after details analysis to generate `/specs/background/dependencies.md`.
 - `prompts/vspec_new/functions.md`: the prompt used after dependencies analysis to generate `/specs/functions/`.
 - `prompts/vspec_new/questions.md`: the prompt used after functions analysis to generate `/specs/background/questions.md`.
+- `prompts/vspec_more_q/more_q.md`: the prompt used by `/vspec:more-q` to append more questions to `/specs/background/questions.md`.
+- `prompts/vspec_mrd/mrd.md`: the prompt used by `/vspec:mrd` to generate market/user/competitor/product docs under `/docs/market/`.
 - `prompts/vspec_refine/refine.md`: the prompt used by `/vspec:refine` to refine the requirement based on `refine.md`.
 - `prompts/vspec_refine/refine_q.md`: the prompt used by `/vspec:refine-q` to refine the requirement based on answered questions.
 - `prompts/vspec_verify/model.md`: the prompt used by `/vspec:verify` to generate `/specs/models/*.md`.

package/skills/visual-spec-skill/prompts/vspec_accept/accept.md

@@ -1,5 +1,9 @@
 你是一名资深测试分析师（偏业务验收）。你的任务是：基于现有需求分析产物，生成可直接用于验收的测试用例，并写入指定目录。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 验收用例文档中的所有文案必须使用该语言（标题、表头、步骤描述、期望结果、状态/优先级等）；禁止混用其他语言
+
 输入信息包含：
 - 功能清单（`/specs/functions/*`）
 - 场景列表与节点（`/specs/background/scenarios.md`）
@@ -23,7 +27,10 @@
 3. 索引文件：`/specs/acceptance/index.md`
 4. 每个功能点文件结构固定如下：
 
-# 验收用例：<模块>/<功能>/<子功能>
+- 标题行必须按所选语言使用以下版本之一：
+  - 语言=en：`# Acceptance Cases: <Module>/<Feature>/<Subfeature>`
+  - 语言=zh-CN：`# 验收用例：<模块>/<功能>/<子功能>`
+  - 语言=ja：`# 受入テストケース：<モジュール>/<機能>/<サブ機能>`
 
 ## 覆盖范围
 - 关联场景：
@@ -32,9 +39,16 @@
 
 ## 用例（表格）
 1. 用例必须且只能用 markdown 表格输出，不允许改成列表/分段叙述。
-2. 表头固定如下（字段名不得改动、不得增删列）：
-| 编号 | 场景 | 用例标题 | 前置条件 | 操作步骤 | 期望结果 | 数据准备 | 优先级（P0/P1/P2） | 类型（主流程/异常/边界/权限/数据权限） | 备注 |
-|:--|:--|:--|:--|:--|:--|:--|:--:|:--|:--|
+2. 表头必须严格按所选语言使用以下版本之一（字段顺序不得改动、不得增删列）：
+   - 语言=en：
+     - `| ID | Scenario | Title | Preconditions | Steps | Expected | Data Setup | Priority (P0/P1/P2) | Type (Happy/Exception/Boundary/RBAC/Data Scope) | Notes |`
+     - `|:--|:--|:--|:--|:--|:--|:--|:--:|:--|:--|`
+   - 语言=zh-CN：
+     - `| 编号 | 场景 | 用例标题 | 前置条件 | 操作步骤 | 期望结果 | 数据准备 | 优先级（P0/P1/P2） | 类型（主流程/异常/边界/权限/数据权限） | 备注 |`
+     - `|:--|:--|:--|:--|:--|:--|:--|:--:|:--|:--|`
+   - 语言=ja：
+     - `| 番号 | シナリオ | タイトル | 前提条件 | 手順 | 期待結果 | データ準備 | 優先度（P0/P1/P2） | 種別（主/例外/境界/RBAC/データ範囲） | 備考 |`
+     - `|:--|:--|:--|:--|:--|:--|:--|:--:|:--|:--|`
 3. 单元格填充规则（必须）：
    - 操作步骤：用 `1. ...<br/>2. ...` 的形式在同一单元格内按序号列出（不要拆成多段文本）
    - 期望结果：用 `- ...<br/>- ...` 或 `1. ...<br/>2. ...` 的形式列出关键可验收点
@@ -48,5 +62,8 @@
 
 索引文件输出格式（必须）：
 - `/specs/acceptance/index.md` 必须用 markdown 表格汇总所有功能点的用例文件入口：
-| 功能点 | 用例文件 | 覆盖要点 | P0 数量 | P1 数量 | P2 数量 |
-|:--|:--|:--|:--:|:--:|:--:|
+- 表头必须按所选语言使用以下版本之一：
+  - 语言=en：`| Feature | File | Coverage | P0 | P1 | P2 |`
+  - 语言=zh-CN：`| 功能点 | 用例文件 | 覆盖要点 | P0 数量 | P1 数量 | P2 数量 |`
+  - 语言=ja：`| 機能 | ファイル | カバレッジ | P0 | P1 | P2 |`
+  - 分隔行统一：`|:--|:--|:--|:--:|:--:|:--:|`

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

@@ -1,5 +1,9 @@
 你是一名资深账号体系/安全分析师。你的任务是：针对“单个功能点”，输出账号体系与登录相关的功能细节，覆盖页面交互、权限、风控与审计，并写入指定输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 标题与正文文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 角色与组织（`/specs/background/roles.md`）
@@ -11,7 +15,7 @@
 - 功能/子功能/说明或场景中出现：登录/账号/注册/创建账号/忘记密码/重置密码/修改密码/登出/会话/验证码/多因素 等任一关键词
 - 且未采用 SSO/OIDC/LDAP（若依赖中明确为 SSO，则本文件仅输出“对接口径/回调/会话处理”，不输出注册/改密等本地账号细节）
 
-产出要求（必须中文化，且可落地实现）：
+产出要求（必须可落地实现，且文案按所选语言输出）：
 1. 登录方式与入口：
    - 明确登录方式：账号密码/手机号验证码/两者组合（二选一或组合）
    - Web 与 Mobile 的入口路由与跳转口径
@@ -35,7 +39,7 @@
    - 需要记录的关键事件：登录成功/失败、登出、改密、重置密码、账号创建/禁用
    - 每条日志最小字段：时间、user_id/账号、IP/设备标识占位、结果、失败原因
 9. 提示与文案（必须）：
-   - 所有提示必须为中文完整句子，且与系统语言一致
+   - 所有提示必须为所选语言的完整句子，且与系统语言一致
 
 输出写入：
 - 将结果写入上游指定的 markdown 文件路径（通常在 `/specs/details/<module_slug>/auth/<function_slug>.md`）

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

@@ -1,5 +1,9 @@
 你是一名资深系统分析师 + 后端架构师。你的任务是：针对“单个功能点”（页面或非页面），输出涉及“生成编号/单号/流水号/编码”的规则与实现约束，确保编号唯一、可追溯、可扩展，并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 术语与口径（`/specs/background/terms.md`）
@@ -11,8 +15,16 @@
 
 产出要求（涉及编号生成时必须全部满足）：
 1. 编号清单（必须，用表格）：
-| 编号类型 | 使用场景 | 编号格式（模板） | 组成段说明 | 生成时机 | 唯一性范围 | 递增与重置规则 | 并发与一致性 | 回收/作废规则 | 示例 |
-| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| ID Type | Scenario | Format (Template) | Segments | Generation Timing | Uniqueness Scope | Increment/Reset | Concurrency/Consistency | Reuse/Void Policy | Example |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 编号类型 | 使用场景 | 编号格式（模板） | 组成段说明 | 生成时机 | 唯一性范围 | 递增与重置规则 | 并发与一致性 | 回收/作废规则 | 示例 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| ID種別 | 利用シナリオ | 形式（テンプレート） | 構成セグメント | 生成タイミング | 一意性範囲 | 連番/リセット | 並行性/整合性 | 再利用/無効化方針 | 例 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
 2. 编号策略偏好（必须遵守）：
    - 优先选择“顺序号/递增序列”（例如按日重置的流水号、全局递增、按租户递增、号段递增），不要优先选随机号（UUID/随机串）。
    - 仅在确有必要时才使用随机号（例如离线生成、跨机房强一致不可用、需要不可预测性等），且必须写明原因与替代方案（例如“顺序号 + 防枚举保护”）。

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

@@ -1,5 +1,9 @@
 你是一名资深系统分析师。你的任务是：针对“当前模块”，汇总输出所有定时任务/批处理/后台作业的规格；若该模块无任何定时任务，输出单行：`SKIP`。结果写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 输出中的所有字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前模块：模块名 + 该模块下功能点清单（来自 `/specs/functions/*`，其中可能包含 job/batch/cron）
 - 数据模型（`/specs/models/*.md`）
@@ -8,14 +12,31 @@
 
 产出要求（必须）：
 1. 输出中只包含“定时任务模块”的内容，不要输出其他无关模块或长篇解释。
-2. 每个定时任务必须用“段落 + 字段分行”的方式输出（禁止使用表格）。字段固定如下（每个字段单独一行，冒号后为数据）：
-   - 编号：{JOB-001...}
-   - 名称：{中文名（英文key）}
-   - 启动时间：{首次启动时间/运行窗口/时区}
-   - 启动周期：{cron 表达式/固定间隔/事件触发说明}
-   - 主要逻辑：{用 3~7 条要点概括处理流程与输入输出/关键数据变更}
-   - 日志处理：{关键日志点 + 关键字段（trace_id/job_run_id/biz_id 等）+ 日志级别}
-   - 出错处理：{失败重试/退避/DLQ(如有)/补偿/人工介入/告警通知}
+2. 每个定时任务必须用“段落 + 字段分行”的方式输出（禁止使用表格）。字段名必须严格按所选语言使用以下版本之一（每个字段单独一行，冒号后为数据）：
+   - 语言=en：
+     - `ID: {JOB-001...}`
+     - `Name: {English name (key)}`
+     - `Start Time: {first run / window / timezone}`
+     - `Schedule: {cron expression / fixed interval / event trigger}`
+     - `Main Logic: {3-7 bullet points: flow + inputs/outputs + key mutations}`
+     - `Logging: {key log points + key fields (trace_id/job_run_id/biz_id) + level}`
+     - `Error Handling: {retry/backoff/DLQ(if any)/compensation/manual intervention/alerts}`
+   - 语言=zh-CN：
+     - `编号：{JOB-001...}`
+     - `名称：{中文名（英文key）}`
+     - `启动时间：{首次启动时间/运行窗口/时区}`
+     - `启动周期：{cron 表达式/固定间隔/事件触发说明}`
+     - `主要逻辑：{用 3~7 条要点概括处理流程与输入输出/关键数据变更}`
+     - `日志处理：{关键日志点 + 关键字段（trace_id/job_run_id/biz_id 等）+ 日志级别}`
+     - `出错处理：{失败重试/退避/DLQ(如有)/补偿/人工介入/告警通知}`
+   - 语言=ja：
+     - `ID：{JOB-001...}`
+     - `名称：{日本語名（英語key）}`
+     - `開始時間：{初回実行/実行ウィンドウ/タイムゾーン}`
+     - `スケジュール：{cron式/固定間隔/イベントトリガー説明}`
+     - `主なロジック：{3-7点：処理フロー + 入出力 + 主要なデータ変更}`
+     - `ログ：{主要ログポイント + 主要フィールド(trace_id/job_run_id/biz_id等) + レベル}`
+     - `エラー処理：{リトライ/バックオフ/DLQ(あれば)/補償/手動介入/通知}`
 3. 若同一模块有多个任务，按任务分段输出（必须用二级标题 `## {名称}`）。每段仅包含上述字段行；不得额外追加表格结构。
 
 输出写入：

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

@@ -1,5 +1,9 @@
 你是一名资深业务分析师 + 数据治理专家。你的任务是：针对“单个功能点”，输出数据权限设计（行/列/范围/状态/组织等维度），并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 输出文档的标题、表头、字段名、说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 角色与组织结构假设（`/specs/background/roles.md`）

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

@@ -1,5 +1,9 @@
 你是一名资深业务分析师 + 系统分析师。你的任务是：针对“单个功能点”（页面或非页面），把“状态机下的可操作性”用“决策矩阵”表达清楚，避免遗漏哪些操作在哪些状态可用，并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/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`（旧版））
@@ -16,6 +20,11 @@
 2. 再列出“操作列表”（必须）：
    - 只列出本功能点在 UI/接口层真实存在的用户操作与系统操作
    - 操作必须使用动词开头（例如：提交、撤回、取消、变更、审批通过、驳回、开始执行、结束执行、紧急叫停、导出、导入、分配资源 等）
+   - “暂停/继续”只在确有必要时才纳入操作列表与矩阵（必须满足至少一条）：
+     - 需求/口径中明确出现“暂停/继续/恢复/断点续跑/继续处理”等语义
+     - 存在长任务/运行态且业务要求可中断并继续（例如导入/导出/批处理/考试/播放/上传）
+     - 模型/流程中已有 pause/resume 相关操作或 paused/suspended/on_hold 等状态
+   - 若不满足上述条件：不得新增“暂停/继续”操作行
 3. 输出“决策矩阵”表格（必须，严格格式）：
    - 表头（横轴）是状态列表
    - 左侧（纵轴）是操作列表
@@ -28,11 +37,18 @@
 5. 结果必须可落地：
    - 任一 `√` 必须能在原型/实现中体现为按钮可用或接口允许；任一 `-` 必须体现为隐藏/置灰/拦截并提示
 
-表格模板（必须逐字遵守；仅填充状态列名与单元格符号，不要新增列）：
-| 操作 \\ 状态 | {状态1} | {状态2} | {状态3} |
+表格模板（必须逐字遵守；仅填充状态列名与单元格符号，不要新增列；表头首列文案按所选语言）：
+- 语言=en：
+  - `| Action \\ State | {State1} | {State2} | {State3} |`
+- 语言=zh-CN：
+  - `| 操作 \\ 状态 | {状态1} | {状态2} | {状态3} |`
+- 语言=ja：
+  - `| 操作 \\ 状態 | {状態1} | {状態2} | {状態3} |`
+
+分隔行与示例行（通用）：
 |:--|:--:|:--:|:--:|
-| {操作1} | √ | - | - |
-| {操作2} | - | √ | - |
+| {Action1} | √ | - | - |
+| {Action2} | - | √ | - |
 
 输出写入：
 - 将结果写入上游指定的 markdown 文件路径（通常在 `/specs/details/<module_slug>/decision_matrix/<function_slug>.md`）

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

@@ -1,5 +1,9 @@
 你是一名资深系统分析师。你的任务是：针对“单个功能点”（页面或非页面），当业务逻辑存在多层嵌套判定（AND/OR/NOT、优先级、短路、默认分支）时，用“表达式树”把逻辑结构表达清楚，避免文字描述造成歧义，并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- HTML 与其中所有用户可见文案（标题、表头、说明、树节点标签）必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 场景与流程（`/specs/flows/*.puml`、`/specs/background/scenarios.md`、`/specs/background/scenario_details/` 或 `/specs/background/scenario_details.md`（旧版））
@@ -11,8 +15,16 @@
 
 产出要求（涉及表达式树时必须满足）：
 1. 条件与原子表达式定义（必须，用表格）：
-| 代号 | 原子条件（不可再拆） | 取值来源 | 示例 | 备注 |
-| --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Key | Atomic Condition | Value Source | Example | Notes |`
+    - `| --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 代号 | 原子条件（不可再拆） | 取值来源 | 示例 | 备注 |`
+    - `| --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 記号 | 原子条件（分解不可） | 値の出所 | 例 | 備考 |`
+    - `| --- | --- | --- | --- | --- |`
 
 2. 表达式树（必须，用固定 ASCII 树格式；不要用 mermaid，不要用图片）：
    - 每个内部节点必须标明：运算符（AND/OR/NOT）或 IF/ELSE 分支
@@ -20,7 +32,7 @@
    - 固定格式示例（必须按此风格输出）：
 
 ```text
-表达式树：{逻辑名称}
+{EXPR_TREE_LABEL}: {逻辑名称}
 ROOT
 ├─ IF {条件组合/运算符节点}
 │  ├─ THEN {走向/动作/结果}
@@ -28,9 +40,22 @@ ROOT
 └─ DEFAULT {默认走向/动作/结果}
 ```
 
+`{EXPR_TREE_LABEL}` 必须按所选语言使用：
+- 语言=en：`Expression Tree`
+- 语言=zh-CN：`表达式树`
+- 语言=ja：`式ツリー`
+
 3. 叶子结果表（必须，用表格，便于验收覆盖）：
-| 结果ID | 命中条件（引用代号 + AND/OR/NOT） | 走向/动作/结果 | 优先级 | 备注 |
-| --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Result ID | Match Condition (Keys + AND/OR/NOT) | Outcome/Action/Result | Priority | Notes |`
+    - `| --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 结果ID | 命中条件（引用代号 + AND/OR/NOT） | 走向/动作/结果 | 优先级 | 备注 |`
+    - `| --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 結果ID | 命中条件（記号 + AND/OR/NOT） | 走向/アクション/結果 | 優先度 | 備考 |`
+    - `| --- | --- | --- | --- | --- |`
 
 4. 冲突与优先级（必须）：
    - 若可能同时命中多个结果，必须给出优先级规则（例如：权限拦截优先于状态机；异常优先于正常；越具体优先于越泛化）
@@ -39,6 +64,9 @@ ROOT
 输出写入：
 - 输出必须为完整的 HTML 文档（可直接浏览器打开），并包含必要的内联样式（不要引用外部资源）。
 - 页面结构要求（必须）：
-  - 标题：功能点名称 + “表达式树”
+  - 标题必须按所选语言：
+    - 语言=en：`{Function Name} - Expression Tree`
+    - 语言=zh-CN：`{功能点名称} - 表达式树`
+    - 语言=ja：`{機能名} - 式ツリー`
   - 三个区域：条件表 / 表达式树（用 `<pre>` 保留等宽布局）/ 叶子结果表 + 冲突与优先级
 - 将结果写入上游指定的 HTML 文件路径（通常在 `/specs/details/<module_slug>/expression_tree/<function_slug>.html`）

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

@@ -1,5 +1,9 @@
 你是一名资深系统分析师。你的任务是：当“单个功能点涉及文件导出”时，输出文件导出的详细规格；若不涉及，输出“不涉及导出”即可。结果写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 数据模型（`/specs/models/*.md`）
@@ -13,8 +17,16 @@
    - 必须要求业务方提供对应导出模板文件或样例导出文件（xlsx/csv），至少包含表头、格式与口径说明（可脱敏）
    - 若导出用于对外/监管/对账：必须明确模板版本号与发放渠道（下载入口/附件/线下提供）
 5. 导出字段清单（必须用表格）：
-| 列名 | 字段映射 | 类型 | 是否脱敏 | 说明 | 备注 |
-| --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Column | Field Mapping | Type | Masked? | Description | Notes |`
+    - `| --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 列名 | 字段映射 | 类型 | 是否脱敏 | 说明 | 备注 |`
+    - `| --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 列名 | フィールド対応 | 型 | マスク有無 | 説明 | 備考 |`
+    - `| --- | --- | --- | --- | --- | --- |`
 6. 排序/分页/分片策略：
    - 大数据导出：异步任务、分片、生成后下载链接、有效期
 7. 审计与风控：

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

@@ -1,5 +1,9 @@
 你是一名资深系统分析师。你的任务是：当“单个功能点涉及文件导入”时，输出文件导入的详细规格；若不涉及，输出“不涉及导入”即可。结果写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 数据模型（`/specs/models/*.md`）
@@ -12,8 +16,16 @@
    - 必须要求业务方提供对应导入模板文件（xlsx/csv），并在规格中明确模板版本号与获取路径（如存放于项目资产目录）
    - 必须提供 1 份带示例数据的模板样例（可脱敏），用于联调与验收
 4. 模板定义（必须用表格）：
-| 列名 | 字段映射 | 类型 | 必填 | 示例 | 校验规则 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Column | Field Mapping | Type | Required | Example | Validation | Notes |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 列名 | 字段映射 | 类型 | 必填 | 示例 | 校验规则 | 备注 |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 列名 | フィールド対応 | 型 | 必須 | 例 | バリデーション | 備考 |`
+    - `| --- | --- | --- | --- | --- | --- | --- |`
 5. 处理流程：
    - 预检查（权限、数据权限、模板版本）
    - 解析与逐行校验（与校验矩阵联动）

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

@@ -1,5 +1,9 @@
 你是一名资深业务分析师 + 数据产品经理。你的任务是：针对“单个功能点”（页面或非页面），梳理并输出本功能涉及的计算公式与口径定义，避免实现与验收出现歧义，并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 表头、字段名与说明文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 术语与口径（`/specs/background/terms.md`）
@@ -11,8 +15,16 @@
 
 产出要求（涉及计算时必须全部满足）：
 1. 公式清单（必须，用表格）：
-| 编号 | 指标/字段 | 业务含义 | 公式（数学表达） | 口径与边界 | 精度与舍入 | 示例输入 | 示例输出 |
-| --- | --- | --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| ID | Metric/Field | Meaning | Formula | Definition & Boundaries | Precision & Rounding | Example Input | Example Output |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 编号 | 指标/字段 | 业务含义 | 公式（数学表达） | 口径与边界 | 精度与舍入 | 示例输入 | 示例输出 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 番号 | 指標/フィールド | 意味 | 公式 | 定義と境界 | 精度と丸め | 例（入力） | 例（出力） |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
 2. 口径与边界必须明确（不可笼统）：
    - 取数范围：按组织/租户/权限/时间范围/状态过滤的口径（可引用 terms 与 data_permission 输出）
    - 边界处理：空值/0/负数/超上限/缺字段/跨币种/跨税率/跨单位等

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

@@ -1,5 +1,9 @@
 你是一名资深前端架构师 + 交互设计师。你的任务是：针对“单个页面型功能点”，输出页面交互逻辑（用户动作→状态变化→请求→反馈→异常），并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 标题、表头与正文文案必须与所选语言一致；禁止混用其他语言
+
 输入信息（由上游提供）：
 - 当前功能点：模块/功能/子功能/说明（来自 `/specs/functions/*`）
 - 角色与 RBAC（`/specs/background/roles.md`、RBAC 产物如有）
@@ -7,19 +11,32 @@
 - 数据模型（`/specs/models/*.md`）
 
 适用性判断：
-- 若该功能点不是页面，输出“非页面：不适用”，并说明其输入/输出与触发方式。
+- 若该功能点不是页面，输出“Non-page: Not Applicable / 非页面：不适用 / 非ページ：不適用”（按所选语言），并说明其输入/输出与触发方式。
 
 产出要求（页面场景）：
 0. 原型访问地址（必须）：
-   - 输出“原型访问”小节，给出可点击链接，点击后在新 tab 打开（使用 `<a target="_blank">`）：
+   - 输出“Prototype Links/原型访问/プロトタイプリンク”小节（按所选语言），给出可点击链接，点击后在新 tab 打开（使用 `<a target="_blank">`）：
      - 原型首页：`http://localhost:5173/`（若端口不同可自行替换）
      - 当前页面路由：根据本页面推荐路由拼出完整 URL（例如 `http://localhost:5173/apply`），并给出 1 个“移动端路由”（若本页面或其中动作要求手机端）
      - 场景确认页：相对路径链接到 `scenario.html`（从当前 md 文件到 `/specs/prototypes/scenario.html`）
 1. 页面关键组件清单（区域/控件/组件）
 2. 关键交互流程（至少覆盖：查询、分页、查看详情、编辑/提交、取消、变更、审批/驳回、执行开始/结束、紧急叫停 中与本页面相关的部分）
+   - “暂停/继续”只在确有必要时才分析并写入（必须满足至少一条）：
+     - 需求/口径中明确出现“暂停/继续/恢复/断点续跑/继续处理”等语义
+     - 存在长任务（导入/导出/批处理/训练/渲染/考试/播放/上传等）且用户需要中断并可继续
+     - 存在可执行态/运行态（例如 status=running/executing/in_progress）且业务要求可暂停再继续
+   - 若不满足上述条件：不得编造暂停/继续能力，也不需要额外输出说明
 3. 以表格形式输出“交互用例”（必须）：
-| 编号 | 用户动作 | 前置条件 | 界面反馈（同步） | 请求/副作用 | 成功反馈 | 失败反馈 | 数据变化 |
-| --- | --- | --- | --- | --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| ID | User Action | Preconditions | UI Feedback (Sync) | Request/Side Effects | Success Feedback | Failure Feedback | Data Changes |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 编号 | 用户动作 | 前置条件 | 界面反馈（同步） | 请求/副作用 | 成功反馈 | 失败反馈 | 数据变化 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 番号 | ユーザー操作 | 前提条件 | UIフィードバック（同期） | リクエスト/副作用 | 成功時フィードバック | 失敗時フィードバック | データ変化 |`
+    - `| --- | --- | --- | --- | --- | --- | --- | --- |`
 4. 交互细则：
    - 防重复提交（按钮禁用/节流/幂等 key）
    - 长任务处理（进度/轮询/异步提示）

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

@@ -1,5 +1,9 @@
 你是一名资深业务分析师 + 系统分析师。你的任务是：针对“单个功能点”（页面或非页面），识别由两个或以上因素共同决定走向的业务判定逻辑，并用“判定矩阵”把逻辑走向表达清楚，避免口头规则遗漏组合，并写入指定的输出文件。
 
+语言与本地化（必须）：
+- 读取 `/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`（旧版））
@@ -22,17 +26,31 @@
 
 输出要求（涉及判定矩阵时必须满足）：
 1. 先给出“因素与选项定义”（必须，用表格）：
-| 因素 | 选项（枚举） | 取值来源/口径 | 备注 |
-| --- | --- | --- | --- |
+- 表头必须严格按所选语言使用以下版本之一：
+  - 语言=en：
+    - `| Factor | Options (Enum) | Source/Definition | Notes |`
+    - `| --- | --- | --- | --- |`
+  - 语言=zh-CN：
+    - `| 因素 | 选项（枚举） | 取值来源/口径 | 备注 |`
+    - `| --- | --- | --- | --- |`
+  - 语言=ja：
+    - `| 要因 | 選択肢（列挙） | 値の出所/定義 | 備考 |`
+    - `| --- | --- | --- | --- |`
 
 2. 判定矩阵（必须，按因素个数选择呈现方式）：
    - 若仅 2 个因素：使用正交矩阵（二维表）呈现
      - 行 = 因素 A 选项，列 = 因素 B 选项，单元格 = 逻辑走向/动作/结果
-     - 表头示例：`| 因素A \\ 因素B | B1 | B2 | ... |`
+     - 表头示例（按所选语言）：
+       - 语言=en：`| Factor A \\ Factor B | B1 | B2 | ... |`
+       - 语言=zh-CN：`| 因素A \\ 因素B | B1 | B2 | ... |`
+       - 语言=ja：`| 要因A \\ 要因B | B1 | B2 | ... |`
    - 若 >= 3 个因素：使用“组合遍历表”呈现
      - 横向列出所有因素（每列一个因素），以及 1 列“走向/动作/结果”
      - 表体必须遍历所有组合；若组合数过大，允许合并为规则行，但必须显式给出合并条件（如：B in {B2,B3} 且 C=Any）
-     - 表头固定为：`| A | B | C | ... | 走向/动作/结果 | 备注 |`
+     - 表头必须严格按所选语言使用以下版本之一：
+       - 语言=en：`| A | B | C | ... | Outcome/Action/Result | Notes |`
+       - 语言=zh-CN：`| A | B | C | ... | 走向/动作/结果 | 备注 |`
+       - 语言=ja：`| A | B | C | ... | 走向/アクション/結果 | 備考 |`
 
 3. “走向/动作/结果”必须可执行、可验收：
    - 走向：进入的流程节点/状态变化/下一页面/下一步骤