visual-spec 0.1.8 → 0.1.10

package/skills/visual-spec/prompts/vspec_new/background.md

@@ -0,0 +1,589 @@
+你是一名资深需求分析师和视觉规格设计师。你会根据用户提供的原始需求，先完成需求澄清与结构化分析，再输出可继续用于界面设计和业务细化的结果。
+
+输入内容为用户刚刚通过 `/vspec:new` 提交的原始需求。
+
+请严格按以下步骤执行：
+
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language` 作为“文档输出默认语言”（支持 `en`、`zh`、`ja`；若缺失/非法则按 `en` 处理）
+- 若存在 `/scheme.yaml` `selected.languages`（数组）：将其作为“项目支持语言集合”（用于原型语言切换等）；若缺失则默认 `[selected.language]`
+- 若用户在 `/vspec:new` 命令参数或本次输入中显式指定 `lang=<...>`：
+  - 支持两种形式：
+    - 单语言：`lang=en` / `lang=zh` / `lang=ja`
+    - 多语言：`lang=zh,en`（逗号分隔；第一个为文档默认语言；其余为可切换语言；允许 `zh-CN` 作为 `zh` 的别名）
+  - 本次必须以该值为准，并将 `/scheme.yaml` 更新为：
+    - `selected.language` = 解析后的第一个语言
+    - `selected.languages` = 解析后的语言数组（去重，保序）
+  - 只更新上述两个字段，其他字段与格式保持不变
+- 本命令生成的所有 `/specs/**` 文档内容必须使用该语言输出（标题、表头、字段说明、状态文案、按钮文案、提示语等均需一致）；禁止混用其他语言
+
+0. 创建材料目录（docs）
+   - 如果 `/docs` 不存在，请先创建目录
+   - 如果 `/docs/README.md` 不存在，请创建并写入以下内容（保持简短）：
+   - 不要创建 `/docs/change/`（已废弃）
+   - 如果 `/docs/refine` 不存在，请创建目录
+   - 如果 `/docs/refine/README.md` 不存在，请创建并写入以下内容（说明如何编写 `refine.md`；保持简短，可 fork 后调整）：
+
+     - 语言=en：
+
+       # refine (Refinement Inputs)
+
+       This directory stores refinement instructions for `/vspec:refine`.
+
+       Recommended file:
+       - `docs/refine/refine.md`: the canonical refinement instruction for this project.
+
+       Suggested structure (keep it short and explicit):
+       - What changed (new/modify/delete/clarify)
+       - Impact scope (modules/functions/pages/APIs)
+       - New/updated rules (validation, permissions, states, dependencies)
+       - Open questions (if any)
+
+     - 语言=zh-CN：
+
+       # refine（补充/澄清输入）
+
+       本目录用于存放 `/vspec:refine` 的修订输入。
+
+       推荐文件：
+       - `docs/refine/refine.md`：本项目统一的修订指令入口文件（建议始终维护它）。
+
+       建议结构（简短、明确）：
+       - 变更点：新增/修改/删除/澄清（逐条列出）
+       - 影响范围：涉及哪些模块/功能/页面/API
+       - 新规则：校验/权限/状态机/外部依赖/失败兜底
+       - 待确认问题（如有）
+
+     - 语言=ja：
+
+       # refine（追補/明確化入力）
+
+       本ディレクトリは `/vspec:refine` の改訂入力を保管します。
+
+       推奨ファイル：
+       - `docs/refine/refine.md`：このプロジェクトの改訂指示の入口ファイル（継続的に更新すること）。
+
+       推奨構成（短く、明確に）：
+       - 変更点（追加/修正/削除/明確化）
+       - 影響範囲（モジュール/機能/画面/API）
+       - 新ルール（バリデーション/権限/状態/外部依存/失敗時対応）
+       - 要確認事項（必要なら）
+   - 如果 `/docs/dependencies` 不存在，请创建目录
+   - 如果 `/docs/dependencies/README.md` 不存在，请创建并写入以下内容（用于构建“外部依赖系统说明文档库”；保持简短，可 fork 后按团队规范调整）：
+
+     - 语言=en：
+
+       # dependencies (External Systems Library)
+
+       Store existing external dependency system docs here (one system per folder). `/vspec:new` and dependency analysis will read this directory to understand what each system does.
+
+       Recommended:
+       - `docs/dependencies/<system_slug>/overview.md`: purpose, owners, environments, auth
+       - `docs/dependencies/<system_slug>/interfaces.md`: APIs/webhooks/topics/files, key fields, SLA
+       - `docs/dependencies/<system_slug>/samples/`: request/response, payload examples
+
+     - 语言=zh-CN：
+
+       # dependencies（外部依赖系统文档库）
+
+       将“已有外部依赖系统”的说明文档沉淀到这里（建议一个系统一个目录）。后续做依赖分析时会优先读取该目录，先理解“有哪些系统、各自做什么”，再梳理本需求与这些系统的交互边界。
+
+       推荐结构：
+       - `docs/dependencies/<system_slug>/overview.md`：系统用途、负责人、环境、鉴权方式
+       - `docs/dependencies/<system_slug>/interfaces.md`：API/webhook/topic/文件等接口清单、关键字段、SLA
+       - `docs/dependencies/<system_slug>/samples/`：请求/响应/消息体样例
+
+     - 语言=ja：
+
+       # dependencies（外部依存システム文書庫）
+
+       既存の外部依存システムの資料をここに集約します（原則：1システム=1フォルダ）。依存関係分析では本ディレクトリを優先的に読み取り、「どのシステムが何を担うか」を整理します。
+
+       推奨：
+       - `docs/dependencies/<system_slug>/overview.md`：目的、担当、環境、認証
+       - `docs/dependencies/<system_slug>/interfaces.md`：API/webhook/topic/ファイル、主要フィールド、SLA
+       - `docs/dependencies/<system_slug>/samples/`：リクエスト/レスポンス/ペイロード例
+
+     - 语言=en：
+
+       # docs (Inputs)
+
+       This directory stores business inputs and delivery alignment materials for this requirement: original docs, flow notes, field definitions, templates/agreements/copy, screenshots, and sample data.
+
+       Prefer organizing by topic or date, and include source + version in filenames.
+
+     - 语言=zh-CN：
+
+       # docs（需求材料）
+
+       本目录用于存放与本需求相关的业务材料与交付对齐资料，例如：原始文档、流程说明、字段口径、模板/协议/文案、截图、样例数据等。
+
+       建议按主题或日期建立子目录，并在文件名中体现来源与版本。
+
+     - 语言=ja：
+
+       # docs（入力資料）
+
+       本ディレクトリは、本要件に関する業務入力と合意形成資料（原本ドキュメント、フロー説明、項目定義、テンプレート/規約/文言、スクリーンショット、サンプルデータ等）を保管します。
+
+       トピックや日付で整理し、ファイル名に出所とバージョンを含めてください。
+
+0.5 创建可编辑的工程约束文件（必须）
+   - 目的：让用户在后续 `/vspec:verify` 与 `/vspec:impl` 前即可手动调整技术栈与 UI 风格
+   - 生成内容必须使用“固定标准模板”，禁止动态变化（必须）：
+     - 禁止调整字段顺序、缩进风格与键名；禁止按项目/行业“智能改写模板内容”
+     - 若文件已存在：不得覆盖、不得重排、不得“格式化重写”
+   - 若 `/scheme.yaml` 不存在：必须创建（不要覆盖已存在文件），写入以下默认模板（必须逐字复制）：
+
+```yaml
+schema_version: 1
+
+selected:
+  prototype_frontend_stack: vue3_vite_ts_antdv
+  prototype_frontend_framework: vue
+  prototype_frontend_ui_library: ant-design-vue
+  prototype_backend_stack: java17_springboot3
+  prototype_database: mysql8
+  package_manager: npm
+  language: en
+  languages:
+    - en
+
+prototype_options:
+  calendar_view:
+    enabled: auto
+    view_default: month
+    resource_dimension: auto
+
+catalog:
+  prototype_frontend_stacks:
+    - id: vue3_vite_ts_antdv
+      name: Vue 3 + Vite + TypeScript + Ant Design Vue
+      framework: vue
+      framework_version: "3"
+      build_tool: vite
+      language: typescript
+      ui_library: ant-design-vue
+      router: vue-router@4
+      state: pinia
+      http_client: axios
+      charting: echarts
+      date_library: dayjs
+      styling: less
+      lint: eslint
+      formatter: prettier
+      unit_test: vitest
+      e2e_test: playwright
+      notes: default_for_vspec_verify
+
+    - id: vue3_vite_ts_elementplus
+      name: Vue 3 + Vite + TypeScript + Element Plus
+      framework: vue
+      framework_version: "3"
+      build_tool: vite
+      language: typescript
+      ui_library: element-plus
+      router: vue-router@4
+      state: pinia
+      http_client: axios
+      charting: echarts
+      date_library: dayjs
+      styling: scss
+      lint: eslint
+      formatter: prettier
+      unit_test: vitest
+      e2e_test: playwright
+      notes: suitable_for_enterprise_admin
+
+    - id: nuxt3_ts_elementplus
+      name: Nuxt 3 + TypeScript + Element Plus (SSR/SSG)
+      framework: nuxt
+      framework_version: "3"
+      build_tool: nuxt
+      language: typescript
+      ui_library: element-plus
+      router: built-in
+      state: pinia
+      http_client: ofetch
+      charting: echarts
+      date_library: dayjs
+      styling: scss
+      lint: eslint
+      formatter: prettier
+      unit_test: vitest
+      e2e_test: playwright
+      notes: ssr_friendly
+
+    - id: react18_vite_ts_antd
+      name: React 18 + Vite + TypeScript + Ant Design
+      framework: react
+      framework_version: "18"
+      build_tool: vite
+      language: typescript
+      ui_library: antd
+      router: react-router@6
+      state: redux-toolkit
+      http_client: axios
+      charting: echarts-for-react
+      date_library: dayjs
+      styling: less
+      lint: eslint
+      formatter: prettier
+      unit_test: vitest
+      e2e_test: playwright
+      notes: common_spa_choice
+
+    - id: nextjs14_ts_antd
+      name: Next.js 14 + TypeScript + Ant Design (App Router)
+      framework: nextjs
+      framework_version: "14"
+      build_tool: next
+      language: typescript
+      ui_library: antd
+      router: app-router
+      state: react-context
+      http_client: fetch
+      charting: echarts-for-react
+      date_library: dayjs
+      styling: css-modules
+      lint: eslint
+      formatter: prettier
+      unit_test: vitest
+      e2e_test: playwright
+      notes: ssr_and_rsc
+
+    - id: angular17_ts_ngzorro
+      name: Angular 17 + TypeScript + NG-ZORRO
+      framework: angular
+      framework_version: "17"
+      build_tool: angular-cli
+      language: typescript
+      ui_library: ng-zorro-antd
+      router: angular-router
+      state: rxjs
+      http_client: angular-http
+      charting: echarts
+      date_library: dayjs
+      styling: less
+      lint: eslint
+      formatter: prettier
+      unit_test: karma-jasmine
+      e2e_test: playwright
+      notes: enterprise_frontend
+
+    - id: sveltekit2_ts
+      name: SvelteKit 2 + TypeScript
+      framework: sveltekit
+      framework_version: "2"
+      build_tool: sveltekit
+      language: typescript
+      ui_library: skeleton
+      router: built-in
+      state: stores
+      http_client: fetch
+      charting: echarts
+      date_library: dayjs
+      styling: tailwindcss
+      lint: eslint
+      formatter: prettier
+      unit_test: vitest
+      e2e_test: playwright
+      notes: lightweight
+
+  prototype_backend_stacks:
+    - id: node18_nestjs10_ts
+      name: Node.js 18 + NestJS 10 + TypeScript
+      language: typescript
+      framework: nestjs
+      api_style: rest
+      auth: jwt
+      orm: prisma
+      notes: suitable_for_enterprise_api
+
+    - id: node18_express_ts
+      name: Node.js 18 + Express + TypeScript
+      language: typescript
+      framework: express
+      api_style: rest
+      auth: jwt
+      orm: prisma
+      notes: lightweight_api
+
+    - id: java17_springboot3
+      name: Java 17 + Spring Boot 3
+      language: java
+      framework: spring-boot
+      api_style: rest
+      auth: spring-security-jwt
+      orm: jpa_or_mybatis
+      notes: enterprise_standard
+
+    - id: dotnet8_webapi
+      name: .NET 8 + ASP.NET Core Web API
+      language: csharp
+      framework: aspnet-core
+      api_style: rest
+      auth: jwt
+      orm: ef-core
+      notes: microsoft_stack
+
+    - id: python311_fastapi
+      name: Python 3.11 + FastAPI
+      language: python
+      framework: fastapi
+      api_style: rest
+      auth: jwt
+      orm: sqlalchemy
+      notes: fast_iteration
+
+    - id: go122_gin
+      name: Go 1.22 + Gin
+      language: go
+      framework: gin
+      api_style: rest
+      auth: jwt
+      orm: gorm
+      notes: high_performance
+
+  databases:
+    - id: none
+      name: No database (in-memory/mock)
+      type: none
+      notes: prototype_default
+    - id: postgres16
+      name: PostgreSQL 16
+      type: relational
+      migration: prisma_or_flyway
+      notes: recommended_relational
+    - id: mysql8
+      name: MySQL 8
+      type: relational
+      migration: prisma_or_flyway
+      notes: common_relational
+    - id: mongodb7
+      name: MongoDB 7
+      type: document
+      migration: none
+      notes: document_store
+    - id: redis7
+      name: Redis 7
+      type: cache
+      migration: none
+      notes: cache_and_lock
+
+  integrations:
+    auth:
+      - id: none
+        name: No auth (prototype role switch)
+      - id: sso_oidc
+        name: OIDC/OAuth2 SSO
+      - id: ldap_ad
+        name: LDAP/AD
+    message_queue:
+      - id: none
+        name: No MQ
+      - id: kafka
+        name: Apache Kafka
+      - id: rabbitmq
+        name: RabbitMQ
+      - id: rocketmq
+        name: Apache RocketMQ
+    object_storage:
+      - id: none
+        name: Local storage
+      - id: s3
+        name: S3 compatible
+      - id: oss
+        name: Aliyun OSS
+      - id: cos
+        name: Tencent COS
+```
+
+   - 若 `/prototype_ui_convention.md` 不存在：必须创建（不要覆盖已存在文件），写入以下默认模板（必须逐字复制；不得增删标题层级）：
+
+```md
+# 原型 UI 规范
+
+## 目标
+- 统一视觉语言与交互口径，确保 Web 与 Mobile 演示一致、可评审、可复用
+
+## 全局布局
+- Web：左侧导航（可折叠）+ 顶部 Header + 内容区（三段式）
+- Mobile：顶部栏 + 内容区 +（按需）底部吸底操作栏
+
+## 色彩与层级
+- 主色：保持 Ant Design 默认主色系
+- 强调色/危险色：仅用于关键动作与风险提示，避免滥用
+- 状态色（示例口径，可按模块裁剪但必须一致）：待处理=蓝、成功=绿、失败/驳回=红、取消/终止=灰
+
+## 字体与间距
+- 标题/正文/辅助文字使用清晰层级，避免同屏字号过多
+- Web 默认内容 padding 16~24，区块间距 16；Mobile 默认 padding 12~16，区块间距 12
+
+## 组件规范
+- 表单：一律用 Drawer 承载；必填用校验规则，不靠 placeholder
+- 日期：一律用日期控件（DatePicker/RangePicker），禁止文本输入日期
+- 金额：右对齐；千分位；两位小数
+- 敏感信息：默认脱敏，按权限可触发展示全量
+
+## 交互反馈
+- 所有关键动作必须有成功/失败反馈；提交中禁重复提交并显示 loading
+- 无权限：隐藏不可见项；不可操作项置灰并提示原因
+
+## 本地化
+- 日期/时间与状态/枚举显示必须中文化；禁止直接展示英文 code
+
+## 补充约束（项目特定）
+- 仅用于追加来自 `/docs/current/ui_spec.md` 或 `/docs/current/ui_style.md` 的更严格约束；不得改动上述模板结构与标题
+```
+
+1. 归档原始需求
+   - 将用户输入的原始需求原文保存到：`/specs/background/original.md`
+   - 如果 `/specs/background` 不存在，请先创建目录
+   - 在该文件中先写入“原始需求”小节，其标题必须按所选语言使用以下版本之一，然后在其下粘贴原文（不要改写）：
+     - 语言=en：`# Raw Requirement`
+     - 语言=zh-CN：`# 原始需求`
+     - 语言=ja：`# 要件原文`
+
+2. 提炼需求摘要
+   - 用 2 到 4 句话总结业务目标
+   - 说明这个需求要解决的核心问题
+
+3. 补全业务背景
+   - 识别需求发起方、目标用户、使用场景
+   - 如果原始需求过于简单，基于合理假设补全背景，并明确标注为“假设”
+
+4. 拆解核心功能
+   - 列出主要功能点
+   - 说明每个功能点的输入、处理、输出
+
+5. 设计页面与交互
+   - 推导需要的页面或模块
+   - 描述页面布局重点、关键组件、用户操作路径
+
+6. 提取数据模型
+   - 列出核心实体
+   - 为每个实体给出关键字段、字段含义、是否必填
+
+7. 细化业务逻辑
+   - 说明关键流程
+   - 标记约束条件、状态变化、异常情况
+
+8. 输出待确认问题
+   - 如果存在信息缺口，列出需要用户下一步补充的问题
+   - 问题要具体、可回答、按优先级排序
+   - 提问设计必须覆盖并按以下分组组织（避免随机发散），每组只问“缺口最大、最影响方案”的问题（分组标题按所选语言使用；不要复制中文分组名）：
+     - Background / 背景 / 背景：业务目标、触发原因、成功口径、现状流程与痛点
+     - Company Profile / 企业类型 / 企業プロファイル：行业/组织形态、集团/多法人/多组织、地域/多语言、管控模式（集权/分权）
+     - Business Type / 业务类型 / 業務タイプ：业务链路类型（ToB/ToC/内部运营）、交易/项目/工单/审批类、线上/线下、跨部门协作方式
+     - Finance / 财务 / 財務：计费/预算/成本/收入口径、币种与税率、对账与结算周期、财务期间/关账、科目/核算维度
+     - People & Org / 人员 / 人員・組織：角色与编制、组织架构与汇报线、权限边界、参与人数与峰值并发、交接/代办/离职处理
+     - Systems & Data / 系统与数据 / システム・データ（如涉及）：数据来源与主数据、历史数据迁移、对接系统、权限/审计/合规要求
+   - 输出格式要求（必须按所选语言）：
+     - 在“Open Questions/待确认问题/要確認事項”段落下，必须按上述分组使用二级标题（`##`）组织，每组 2 到 6 个问题；若某组无信息缺口则可省略该组
+     - 二级标题必须严格按所选语言使用以下版本之一（禁止自造/混用）：
+       - 语言=en：
+         - `## Background`
+         - `## Company Profile`
+         - `## Business Type`
+         - `## Finance`
+         - `## People & Org`
+         - `## Systems & Data`
+       - 语言=zh-CN：
+         - `## 背景`
+         - `## 企业类型`
+         - `## 业务类型`
+         - `## 财务`
+         - `## 人员`
+         - `## 系统与数据`
+       - 语言=ja：
+         - `## 背景`
+         - `## 企業プロファイル`
+         - `## 業務タイプ`
+         - `## 財務`
+         - `## 人員・組織`
+         - `## システム・データ`
+
+请使用以下输出结构（章节标题必须严格按所选语言使用对应版本；禁止混用）：
+
+- 语言=en：
+  - `# Raw Requirement` (write into `/specs/background/original.md`)
+  - `# Summary`
+  - `# Business Context`
+  - `# Core Features`
+  - `# Pages & Interactions`
+  - `# Data Model`
+  - `# Business Logic`
+  - `# Risks & Assumptions`
+  - `# Open Questions`
+
+- 语言=zh-CN：
+  - `# 原始需求`（写入 /specs/background/original.md）
+  - `# 需求摘要`
+  - `# 业务背景`
+  - `# 核心功能`
+  - `# 页面与交互`
+  - `# 数据模型`
+  - `# 业务逻辑`
+  - `# 风险与假设`
+  - `# 待确认问题`
+
+- 语言=ja：
+  - `# 要件原文`（write into `/specs/background/original.md`）
+  - `# 要約`
+  - `# 業務背景`
+  - `# コア機能`
+  - `# 画面と操作`
+  - `# データモデル`
+  - `# 業務ロジック`
+  - `# リスクと仮定`
+  - `# 要確認事項`
+
+写入要求：
+- 将本次完整输出（包含“原始需求、分析内容、待确认问题”）追加写入到：`/specs/background/original.md`
+- 文件中必须保留原始需求原文与本次分析结果，便于后续 stakeholders/roles 阶段引用
+- 交互提示（必须在对话中输出；不要写入 `/specs/background/original.md`）：
+  - 告知用户：回答“待确认问题”可以自己逐条回答，也可以委托 AI 基于当前信息先给出一版“建议答案”，用户再逐条确认/修改
+  - 给出可复制的建议话术（按所选语言输出对应版本）：
+    - 语言=en：`Please propose suggested answers for the Open Questions based on current information. I will confirm or edit each answer.`
+    - 语言=zh-CN：`请你先基于目前信息为“待确认问题”逐条给出建议答案，我再逐条确认/修改。`
+    - 语言=ja：`要確認事項について、現時点の情報に基づく「回答案」を先に提示してください。こちらで各回答を確認・修正します。`
+- 标题语言必须与 `selected.language` 一致（`#`/`##`/`###` 等均包含在内），不得混用：
+  - 语言=en：不得出现中文/日文标题（例如 `# 待确认问题`、`# 业务背景`、`# リスクと仮定` 等）
+  - 语言=zh-CN：不得出现英文/日文标题（例如 `# Open Questions`、`# Business Context`、`# 要確認事項` 等）
+  - 语言=ja：不得出现中文/英文标题（例如 `# 待确认问题`、`# Business Context`、`# 风险与假设` 等）
+- 除上述结构中声明的标题之外，禁止新增其他标题层级；需要补充内容请用列表/表格而不是新增标题。
+- 在写入文件前必须执行“标题归一化”（必须，写入前自检并修正）：
+  1. 一级标题（`# ...`）必须严格归一化为所选语言的以下精确文本（按顺序、不得缺失、不得新增）：
+     - 语言=en：
+       1) `# Raw Requirement`
+       2) `# Summary`
+       3) `# Business Context`
+       4) `# Core Features`
+       5) `# Pages & Interactions`
+       6) `# Data Model`
+       7) `# Business Logic`
+       8) `# Risks & Assumptions`
+       9) `# Open Questions`
+     - 语言=zh-CN：
+       1) `# 原始需求`
+       2) `# 需求摘要`
+       3) `# 业务背景`
+       4) `# 核心功能`
+       5) `# 页面与交互`
+       6) `# 数据模型`
+       7) `# 业务逻辑`
+       8) `# 风险与假设`
+       9) `# 待确认问题`
+     - 语言=ja：
+       1) `# 要件原文`
+       2) `# 要約`
+       3) `# 業務背景`
+       4) `# コア機能`
+       5) `# 画面と操作`
+       6) `# データモデル`
+       7) `# 業務ロジック`
+       8) `# リスクと仮定`
+       9) `# 要確認事項`
+  2. 若检测到任何“一级标题”不在上述列表中（例如 `# 业务背景` 出现在语言=en，或 `# Business Context` 出现在语言=zh-CN），必须按对应语言映射替换后再写入。
+  3. “Open Questions/待确认问题/要確認事項”段落下的二级标题（`## ...`）也必须严格按语言映射（例如语言=en 必须使用 `## Background` 等）；若出现中文/日文/英文混用，必须替换为对应语言版本后再写入。

package/skills/visual-spec/prompts/vspec_new/dependencies.md

@@ -0,0 +1,63 @@
+你是一名资深系统分析师。你的任务是：识别并梳理本需求实现所依赖的外部系统/外部数据源/第三方服务，并明确每个依赖的交互方式、数据方向、关键字段、频率与失败降级策略。
+
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 输出的文档内容必须统一使用该语言（标题、表头、说明文案等）；禁止混用其他语言
+
+输入信息包含：
+- 原始需求与 background 分析（/specs/background/original.md 或等价内容）
+- 干系人与角色任务（/specs/background/stakeholder.md、/specs/background/roles.md 或等价内容）
+- 术语表（/specs/background/terms.md 或等价内容）
+- 流程泳道图（/specs/flows/*.puml 或等价内容）
+- 场景与细节分析（/specs/background/scenarios.md、/specs/background/scenario_details/ 或 /specs/background/scenario_details.md（旧版））
+- 外部依赖系统文档库（如存在，优先读取）：
+  - `/docs/dependencies/`（推荐）
+  - `/docs/dependecies/`（兼容拼写错误目录；如存在则一并读取）
+
+识别范围（逐项检查是否需要）：
+- 主数据/基础数据来源系统（组织、人员、资源、客户、供应商、合同、科目等）
+- 流程协同系统（审批、工单、消息通知、IM/邮件、日程等）
+- 财务/结算/对账相关系统
+- 权限/SSO/统一身份认证
+- 文件与数据导入导出（Excel、对象存储、文档中心）
+- 数据分析/BI/归档/审计留存
+- 第三方接口（支付、短信、地图、OCR 等）
+
+分析要求：
+0. 先建立“外部系统清单基线”（必须）：
+   - 若存在外部依赖系统文档库：先读取并汇总“已有系统清单 + 每个系统负责什么 + 已知接口形态（API/Webhook/MQ/文件等）”
+   - 依赖分析中，除非需求明确需要一个库中不存在的系统，否则不要自造系统名称；若必须新增，标注为“假设（新增系统）”
+1. 只列“本需求范围内确实会发生交互”的外部依赖
+2. 若信息不足，可提出合理候选依赖，但必须标注为“假设”
+3. 对每个依赖明确：
+   - 依赖系统名称（中文）与英文名（如有）
+   - 依赖类型（数据源/数据去向/双向/人工导入/消息通道等）
+   - 交互方式（API/Webhook/消息队列/DB/文件/手工等）
+   - 调用方向（本系统→外部 / 外部→本系统）
+   - 触发场景（对应场景编号或节点，例如 apply/approve/execute-start 等）
+   - 关键数据（至少列 3 个关键字段/数据项）
+   - 频率/时效（实时/准实时/日批/手工触发等）
+   - 失败处理（必须写清“集成失败时怎么做”，禁止只写“重试/告警”等关键词）：
+     - 超时/网络失败：超时阈值、重试次数与退避、熔断（如适用）
+     - 幂等与重复调用：幂等键、去重窗口、重放入口
+     - 数据一致性：是否允许最终一致、补偿/对账方式、失败后的数据状态
+     - 用户可见行为：前端提示文案口径、是否允许继续/回滚/进入“处理中”
+     - 失败升级：告警对象与方式、人工介入入口、SLA 违约处理（如适用）
+   - 安全与合规（鉴权方式、权限边界、敏感数据、留存要求）
+
+输出与写入要求：
+1. 将结果写入：`/specs/background/dependencies.md`
+2. 如果 `/specs/background` 不存在，请先创建目录
+3. 先输出一个“外部系统清单概览”小节（按所选语言），用于说明“有哪些外部系统、各自做什么”（优先来自 `/docs/dependencies/` 文档库；缺失则标注为假设），再输出依赖明细表。
+4. 依赖明细输出为 markdown 表格，表头必须严格按所选语言使用以下版本之一：
+   - 语言=en：
+     - `| Dependency | Type | Interface | Direction | Trigger/Scenario | Key Data | Frequency/SLA | Failure Handling | Security/Compliance | Notes/Assumptions |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=zh-CN：
+     - `| 依赖系统 | 类型 | 交互方式 | 方向 | 触发点/场景 | 关键数据 | 频率/时效 | 失败处理 | 安全与合规 | 备注/假设 |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+   - 语言=ja：
+     - `| 依存先 | 種別 | 連携方式 | 方向 | トリガー/シナリオ | 主要データ | 頻度/SLA | 障害対応 | セキュリティ/コンプライアンス | 備考/仮定 |`
+     - `| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |`
+
+5. 最后附上“待确认外部依赖问题”小节（根据语言输出对应标题），列出仍需向用户确认的问题（如有）

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

@@ -1,5 +1,9 @@
 你是一名资深业务分析师。你的任务是：基于已有节点 Pre/Post 细节（来自 `/specs/background/scenario_details/*/pre_post.md`），逐节点补齐并细化“边界思维（Boundaries）”，并按节点分别输出 markdown 文件。
 
+语言与本地化（必须）：
+- 读取 `/scheme.yaml` 的 `selected.language`（支持 `en`、`zh-CN`、`ja`；若缺失/非法则按 `en` 处理）
+- 每个节点文件中的所有可见文案必须与所选语言一致（一级标题、二级标题、列表项文字、区间与触发条件描述等）；禁止混用其他语言
+
 输入信息包含：
 - 节点 Pre/Post 细节（`/specs/background/scenario_details/*/pre_post.md`）
 - 场景列表（`/specs/background/scenarios.md`，用于校验节点覆盖与节点链条口径）
@@ -33,10 +37,16 @@
 1. 对每个节点目录写入：`/specs/background/scenario_details/<dir_key>/boundaries.md`
 2. 文件结构固定如下（必须）：
 
-# 节点：<节点名>
-
-## 边界思维（Boundaries）
-- <边界要点...>
-
-## 需要确认的问题（如有）
-- <问题...>
+- 标题与小节必须按所选语言使用以下版本之一：
+  - 语言=en：
+    - `# Node: <Node Name>`
+    - `## Boundaries`
+    - `## Open Questions (if any)`
+  - 语言=zh-CN：
+    - `# 节点：<节点名>`
+    - `## 边界思维（Boundaries）`
+    - `## 需要确认的问题（如有）`
+  - 语言=ja：
+    - `# ノード：<ノード名>`
+    - `## 境界（Boundaries）`
+    - `## 要確認事項（あれば）`