visual-spec 0.1.9 → 0.1.10

package/README.md

@@ -1,11 +1,13 @@
 This repo provides a requirements analysis and delivery assistant Skill. It offers a `/vspec:*` command-driven workflow that turns raw requirements into reviewable artifacts: specs, data models, runnable prototypes, detailed design, acceptance cases, tests, and integrated implementation inputs.
 
+Version: 0.1.10 (2026-04-12)
+
 ## Installation
 
 Install the Skill into your AI editor configuration directory (Trae / Claude Code / Cursor / GitHub Copilot, etc.):
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 Docs:
@@ -37,8 +39,8 @@ Docs:
 
 ## Directory Structure
 
-- `skills/visual-spec-skill/SKILL.md`: Skill definition and command workflow
-- `skills/visual-spec-skill/prompts/`: prompt files used by each command
+- `skills/visual-spec/SKILL.md`: Skill definition and command workflow
+- `skills/visual-spec/prompts/`: prompt files used by each command
 
 ## Licensing / Plans
 

package/docs/en-US/ai-platform-installation.md

@@ -7,29 +7,29 @@ Recommended: use the official skills.sh installer (the skills CLI). It can insta
 The installer can auto-detect supported agents and prompt you for installation scope (project vs global).
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 Target a specific agent (examples):
 
 ```bash
 # Trae (project scope)
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a trae
+npx skills add visual-req/visual-spec --skill visual-spec -a trae
 
 # Claude Code (project scope)
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a claude-code
+npx skills add visual-req/visual-spec --skill visual-spec -a claude-code
 
 # Cursor (project scope)
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a cursor
+npx skills add visual-req/visual-spec --skill visual-spec -a cursor
 
 # GitHub Copilot (project scope)
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a github-copilot
+npx skills add visual-req/visual-spec --skill visual-spec -a github-copilot
 ```
 
 Global install (available across all projects for the current user):
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill -g
+npx skills add visual-req/visual-spec --skill visual-spec -g
 ```
 
 List skills in this repository:

package/docs/en-US/getting-started.md

@@ -11,15 +11,15 @@ Install the Skill into your AI editor configuration directory:
 Install / update (skills.sh):
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 ### 2. Recommended Workflow
 
 - Initial spec: `/vspec:new`
   - Optional language:
-    - Single language: `/vspec:new lang=zh-CN` (or `lang=en`, `lang=ja`) sets `/scheme.yaml` `selected.language` and generates docs in that language
-    - Multi-language (prototype switch): `/vspec:new lang=zh-CN,en` sets docs default to `zh-CN` and sets `/scheme.yaml` `selected.languages` for prototype UI language switching
+    - Single language: `/vspec:new lang=zh` (or `lang=en`, `lang=ja`) sets `/scheme.yaml` `selected.language` and generates docs in that language
+    - Multi-language (prototype switch): `/vspec:new lang=zh,en` sets docs default to `zh` and sets `/scheme.yaml` `selected.languages` for prototype UI language switching
   - Midway it generates the canonical requirement file (`/specs/background/original.md`) and asks clarification questions
   - Answer those questions in chat first, then type “continue” to finish `/vspec:new` (do not write these clarification answers into `questions.md`)
   - It also generates an open question list (`/specs/background/questions.md`) for later merging

package/docs/en-US/installation.md

@@ -1,6 +1,6 @@
 ## Install into Skill-Enabled AI Editors
 
-Recommended: use the official skills.sh installer (the skills CLI) to install into a Skill-enabled AI editor (Trae / Qwen / Kiro, etc.). The installer can auto-detect available agents and place `visual-spec-skill` into the correct `skills/` directory.
+Recommended: use the official skills.sh installer (the skills CLI) to install into a Skill-enabled AI editor (Trae / Qwen / Kiro, etc.). The installer can auto-detect available agents and place `visual-spec` into the correct `skills/` directory.
 
 ### Prerequisites
 
@@ -9,7 +9,7 @@ Recommended: use the official skills.sh installer (the skills CLI) to install in
 ### Install / Update (Recommended: skills.sh)
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 ### Next

package/docs/en-US/scheme.example.yaml

@@ -7,8 +7,8 @@ selected:
   prototype_backend_stack: java17_springboot3
   prototype_database: mysql8
   package_manager: npm
-  language: en # default output language: en | zh-CN | ja
-  languages: [en] # optional supported languages for prototype switching, e.g. [zh-CN, en]
+  language: en # default output language: en | zh | ja
+  languages: [en] # optional supported languages for prototype switching, e.g. [zh, en]
 
 prototype_options:
   calendar_view:

package/docs/en-US/workflows.md

@@ -57,5 +57,5 @@ Optional: segmented prototype generation
 ## Installation (skills.sh)
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```

package/docs/ja-JP/ai-platform-installation.md

@@ -7,29 +7,29 @@
 インストーラは利用可能な agent を自動検出し、プロジェクト単位/グローバル単位のインストールも選択できます。
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 特定の agent を指定する例：
 
 ```bash
 # Trae（プロジェクト単位）
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a trae
+npx skills add visual-req/visual-spec --skill visual-spec -a trae
 
 # Claude Code（プロジェクト単位）
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a claude-code
+npx skills add visual-req/visual-spec --skill visual-spec -a claude-code
 
 # Cursor（プロジェクト単位）
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a cursor
+npx skills add visual-req/visual-spec --skill visual-spec -a cursor
 
 # GitHub Copilot（プロジェクト単位）
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a github-copilot
+npx skills add visual-req/visual-spec --skill visual-spec -a github-copilot
 ```
 
 グローバルインストール（ユーザーの全プロジェクトで利用）：
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill -g
+npx skills add visual-req/visual-spec --skill visual-spec -g
 ```
 
 このリポジトリ内の skills を一覧表示：

package/docs/ja-JP/getting-started.md

@@ -7,15 +7,15 @@
 - インストール：`installation.md`
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 ### 2. 推奨フロー
 
 - 初期 spec：`/vspec:new`
   - 言語（任意）：
-    - 単一言語：`/vspec:new lang=zh-CN`（または `lang=en`、`lang=ja`）。`/scheme.yaml` `selected.language` を設定し、文書成果物をその言語で統一します
-    - 多言語（プロトタイプ切替）：`/vspec:new lang=zh-CN,en`。文書の既定言語を `zh-CN` にし、`/scheme.yaml` `selected.languages` を切替用言語集合として設定します
+    - 単一言語：`/vspec:new lang=zh`（または `lang=en`、`lang=ja`）。`/scheme.yaml` `selected.language` を設定し、文書成果物をその言語で統一します
+    - 多言語（プロトタイプ切替）：`/vspec:new lang=zh,en`。文書の既定言語を `zh` にし、`/scheme.yaml` `selected.languages` を切替用言語集合として設定します
   - 実行中に要件口径（`/specs/background/original.md`）を生成し、確認質問を提示
   - まずチャットで回答し、その後「continue」と入力して `/vspec:new` を完了
 - Q&A を要件へ反映：`/vspec:refine-q`（`/specs/background/questions.md` の回答済み項目を `original.md` に取り込む）

package/docs/ja-JP/installation.md

@@ -1,6 +1,6 @@
 ## Skill 対応 AI エディタへのインストール
 
-推奨：skills.sh の公式インストーラ（skills CLI）を使って、Skill 対応の AI エディタ（Trae / Qwen / Kiro など）へインストールします。インストーラは利用可能な agent を自動検出し、`visual-spec-skill` を適切な `skills/` ディレクトリへ配置します。
+推奨：skills.sh の公式インストーラ（skills CLI）を使って、Skill 対応の AI エディタ（Trae / Qwen / Kiro など）へインストールします。インストーラは利用可能な agent を自動検出し、`visual-spec` を適切な `skills/` ディレクトリへ配置します。
 
 ### 前提条件
 
@@ -9,7 +9,7 @@
 ### インストール / 更新（推奨：skills.sh）
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 ### 次へ

package/docs/ja-JP/scheme.example.yaml

@@ -7,8 +7,8 @@ selected:
   prototype_backend_stack: java17_springboot3
   prototype_database: mysql8
   package_manager: npm
-  language: en # デフォルト言語：en | zh-CN | ja
-  languages: [en] # 任意：プロトタイプ言語切替用（例：[zh-CN, en]）
+  language: en # デフォルト言語：en | zh | ja
+  languages: [en] # 任意：プロトタイプ言語切替用（例：[zh, en]）
 
 prototype_options:
   calendar_view:

package/docs/ja-JP/workflows.md

@@ -36,5 +36,5 @@
 ## インストール（skills.sh）
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```

package/docs/zh-CN/ai-platform-installation.md

@@ -7,29 +7,29 @@
 安装器会自动检测本机支持的 agent，并提示选择安装位置与范围（项目级或全局）。
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 指定安装到某个 AI 平台（示例）：
 
 ```bash
 # Trae（项目级）
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a trae
+npx skills add visual-req/visual-spec --skill visual-spec -a trae
 
 # Claude Code（项目级）
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a claude-code
+npx skills add visual-req/visual-spec --skill visual-spec -a claude-code
 
 # Cursor（项目级）
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a cursor
+npx skills add visual-req/visual-spec --skill visual-spec -a cursor
 
 # GitHub Copilot（项目级）
-npx skills add visual-req/visual-spec --skill visual-spec-skill -a github-copilot
+npx skills add visual-req/visual-spec --skill visual-spec -a github-copilot
 ```
 
 全局安装（对当前用户所有项目生效）：
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill -g
+npx skills add visual-req/visual-spec --skill visual-spec -g
 ```
 
 查看该仓库包含的 skills：

package/docs/zh-CN/getting-started.md

@@ -11,15 +11,15 @@
 安装/更新（skills.sh）：
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 ### 2. 推荐流程
 
 - 初始规格：`/vspec:new`
   - 可选语言：
-    - 单语言：`/vspec:new lang=zh-CN`（或 `lang=en`、`lang=ja`），会把 `/scheme.yaml` 的 `selected.language` 设为该值，并让后续文档产物全程按该语言输出
-    - 多语言（原型可切换）：`/vspec:new lang=zh-CN,en`，文档默认输出 `zh-CN`，并把 `/scheme.yaml` 的 `selected.languages` 设为可切换语言集合
+    - 单语言：`/vspec:new lang=zh`（或 `lang=en`、`lang=ja`），会把 `/scheme.yaml` 的 `selected.language` 设为该值，并让后续文档产物全程按该语言输出
+    - 多语言（原型可切换）：`/vspec:new lang=zh,en`，文档默认输出 `zh`，并把 `/scheme.yaml` 的 `selected.languages` 设为可切换语言集合
   - 执行中会先生成需求口径文件（`/specs/background/original.md`），并在该步骤提出若干澄清问题
   - 你需要先在对话中回答这些问题，然后输入“继续”才能完成 `/vspec:new` 全流程（这些澄清回答不写入 `questions.md`）
   - 执行过程中还会生成开放问题清单（`/specs/background/questions.md`），用于后续合并

package/docs/zh-CN/installation.md

@@ -1,6 +1,6 @@
 ## 安装到支持 Skill 的 AI 编辑器
 
-推荐使用 skills.sh 的官方安装器（skills CLI）安装到支持 Skill 的 AI 编辑器（Trae / Qwen / Kiro 等）。安装器会自动识别可用的 agent，并把 `visual-spec-skill` 安装到对应的 `skills/` 目录。
+推荐使用 skills.sh 的官方安装器（skills CLI）安装到支持 Skill 的 AI 编辑器（Trae / Qwen / Kiro 等）。安装器会自动识别可用的 agent，并把 `visual-spec` 安装到对应的 `skills/` 目录。
 
 ### 前置条件
 
@@ -9,7 +9,7 @@
 ### 安装/更新（推荐：skills.sh）
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```
 
 ### 下一步

package/docs/zh-CN/quality_check.md

@@ -6,7 +6,7 @@
 
 - 质量标准文件路径（任选其一，取当前环境存在者）：
   - Skill 根目录：`/prompts/vspec_qc/quality_standard.md`
-  - 源码路径：`skills/visual-spec-skill/prompts/vspec_qc/quality_standard.md`
+  - 源码路径：`skills/visual-spec/prompts/vspec_qc/quality_standard.md`
 - 你的需求文档（PRD、功能说明、规格等），支持 Word/PDF/Markdown 等
 
 ### 使用方式（以 DeepSeek 聊天式 AI 为例）
@@ -30,4 +30,3 @@
 
 - 对于“上下限、时间口径、公式精度、权限与数据权限、外部依赖失败策略”等容易遗漏的部分，可在提问中强调“请重点覆盖边界/异常/幂等/回滚/审计/对账”等关键维度
 - 如果发现高频问题，可将其沉淀到你项目根目录的 `domain_quality_standard.md`，作为领域补充标准，供 `/vspec:qc` 合并使用
-

package/docs/zh-CN/scheme.example.yaml

@@ -7,8 +7,8 @@ selected:
   prototype_backend_stack: java17_springboot3
   prototype_database: mysql8
   package_manager: npm
-  language: en # 文档默认语言：en | zh-CN | ja
-  languages: [en] # 可选：原型可切换语言集合，例如 [zh-CN, en]
+  language: en # 文档默认语言：en | zh | ja
+  languages: [en] # 可选：原型可切换语言集合，例如 [zh, en]
 
 prototype_options:
   calendar_view:

package/docs/zh-CN/workflows.md

@@ -58,7 +58,7 @@
 
 内置质检标准文件位于（任选其一，取你当前环境中存在的路径）：
 - Skill 根目录下：`/prompts/vspec_qc/quality_standard.md`
-- 本仓库源码路径：`skills/visual-spec-skill/prompts/vspec_qc/quality_standard.md`
+- 本仓库源码路径：`skills/visual-spec/prompts/vspec_qc/quality_standard.md`
 
 你可以把它作为“通用需求质检标准”，独立用于检查其他方式写出来的需求文档（不要求必须由 `/vspec:*` 生成）。
 
@@ -81,5 +81,5 @@
 ## 安装（skills.sh）
 
 ```bash
-npx skills add visual-req/visual-spec --skill visual-spec-skill
+npx skills add visual-req/visual-spec --skill visual-spec
 ```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "visual-spec",
-  "version": "0.1.9",
-  "description": "AI skill: visual-spec-skill (/vspec:* commands) for requirement analysis, prototyping, detailing, testing, and planning.",
+  "version": "0.1.10",
+  "description": "AI skill: visual-spec (/vspec:* commands) for requirement analysis, prototyping, detailing, testing, and planning.",
   "license": "MIT",
   "type": "commonjs",
   "bin": {
@@ -14,21 +14,21 @@
     "build-skill": "node scripts/build_skill.cjs"
   },
   "files": [
-    "skills/visual-spec-skill/SKILL.md",
-    "skills/visual-spec-skill/SKILL-zh-CN.md",
-    "skills/visual-spec-skill/SKILL-ja-JP.md",
-    "skills/visual-spec-skill/prompts/vspec_accept/",
-    "skills/visual-spec-skill/prompts/vspec_detail/",
-    "skills/visual-spec-skill/prompts/vspec_impl/",
-    "skills/visual-spec-skill/prompts/vspec_new/",
-    "skills/visual-spec-skill/prompts/vspec_more_q/",
-    "skills/visual-spec-skill/prompts/vspec_mrd/",
-    "skills/visual-spec-skill/prompts/vspec_plan/",
-    "skills/visual-spec-skill/prompts/vspec_qc/",
-    "skills/visual-spec-skill/prompts/vspec_refine/",
-    "skills/visual-spec-skill/prompts/vspec_test/",
-    "skills/visual-spec-skill/prompts/vspec_upgrade/",
-    "skills/visual-spec-skill/prompts/vspec_verify/",
+    "skills/visual-spec/SKILL.md",
+    "skills/visual-spec/SKILL-zh-CN.md",
+    "skills/visual-spec/SKILL-ja-JP.md",
+    "skills/visual-spec/prompts/vspec_accept/",
+    "skills/visual-spec/prompts/vspec_detail/",
+    "skills/visual-spec/prompts/vspec_impl/",
+    "skills/visual-spec/prompts/vspec_new/",
+    "skills/visual-spec/prompts/vspec_more_q/",
+    "skills/visual-spec/prompts/vspec_mrd/",
+    "skills/visual-spec/prompts/vspec_plan/",
+    "skills/visual-spec/prompts/vspec_qc/",
+    "skills/visual-spec/prompts/vspec_refine/",
+    "skills/visual-spec/prompts/vspec_test/",
+    "skills/visual-spec/prompts/vspec_upgrade/",
+    "skills/visual-spec/prompts/vspec_verify/",
     "bin/",
     "docs/",
     "scripts/",

package/scripts/build_skill.cjs

@@ -19,7 +19,7 @@ function main() {
   const repoRoot = getRepoRoot();
   const pkg = readPackageJson(repoRoot);
 
-  const skillDir = path.join(repoRoot, "skills", "visual-spec-skill");
+  const skillDir = path.join(repoRoot, "skills", "visual-spec");
   if (!fs.existsSync(skillDir)) {
     throw new Error(`Skill dir not found: ${skillDir}`);
   }
@@ -28,7 +28,7 @@ function main() {
   ensureDir(distDir);
 
   const version = pkg.version || "0.0.0";
-  const outputPath = path.join(distDir, `visual-spec-skill-${version}.skill`);
+  const outputPath = path.join(distDir, `visual-spec-${version}.skill`);
 
   if (fs.existsSync(outputPath)) {
     fs.rmSync(outputPath);
@@ -54,4 +54,3 @@ function main() {
 }
 
 main();
-

package/scripts/postinstall.cjs

@@ -76,7 +76,7 @@ async function main() {
   const { dryRun, force, target, skillDir, skillsDir } = parseArgs(process.argv.slice(2));
 
   const packageRoot = path.resolve(__dirname, "..");
-  const sourceSkillDir = path.join(packageRoot, "skills", "visual-spec-skill");
+  const sourceSkillDir = path.join(packageRoot, "skills", "visual-spec");
   const initCwd = target || process.env.INIT_CWD || process.cwd();
   const resolvedSkillsDir =
     skillsDir && path.resolve(initCwd, skillsDir);
@@ -85,8 +85,8 @@ async function main() {
   const targetSkillDir =
     resolvedSkillDir ||
     (resolvedSkillsDir
-      ? path.join(resolvedSkillsDir, "visual-spec-skill")
-      : path.join(initCwd, ".trae", "skills", "visual-spec-skill"));
+      ? path.join(resolvedSkillsDir, "visual-spec")
+      : path.join(initCwd, ".trae", "skills", "visual-spec"));
 
   if (!(await pathExists(sourceSkillDir))) {
     throw new Error(`Skill source directory not found: ${sourceSkillDir}`);

package/skills/visual-spec/SKILL-ja-JP.md

@@ -0,0 +1,170 @@
+---
+name: "visual-spec"
+description: "生要件を分析して visual spec と成果物を生成します。ユーザーが /vspec:new で分析を開始する時、または /vspec:verify でモデル/プロトタイプを生成する時に利用します。"
+---
+
+# Visual Spec Skill（日本語）
+
+ユーザー入力に基づいて visual spec を分析し、短い要件メモをレビュー可能な構造化成果物へ変換します。
+
+## 利用シーン
+
+以下の状況で利用します：
+- ビジネス側の要件説明が非常に簡略で、仕様化に必要な情報が欠けている
+- ユーザーが `/vspec:new` を実行して新しい要件分析フローを開始する
+
+## この Skill が定義すること
+
+- シナリオ駆動のファシリテーションで詳細を補完する
+- データモデルを設計する
+- 補完した詳細に基づき UI モック/原型を生成する
+- 業務ロジック詳細を可視化/構造化して出力する
+
+## Commands
+
+### `/vspec:new`
+
+新しい要件分析セッションを開始します。
+
+言語：
+- `/scheme.yaml` の `selected.language` を読む（`en`、`zh`、`ja`。欠落/不正なら `en`。`zh-CN` は `zh` の別名として扱う）
+- コマンド引数または入力で `lang=<...>` が明示された場合：
+  - 単一言語：`lang=en|zh|ja`
+  - 複数言語：`lang=zh,en`（先頭が文書既定言語。`selected.languages` に切替集合を保存）
+
+Flow:
+0. `/docs/` の存在を保証し、サブフォルダを作成：
+   - `/docs/legacy/`
+   - `/docs/current/`
+   - `/docs/refine/`
+   - `/docs/dependencies/`
+   - `/docs/change/` は作成しない（廃止）
+0.2 引数で `lang=...` が渡された場合、`/scheme.yaml` の `selected.language` と `selected.languages` を更新（該当フィールドのみ。その他のフィールド/フォーマットは保持）
+0.5 早期に調整できるように制約ファイルを作成（既存なら上書きしない）：
+   - `/scheme.yaml`（原型スタック選定 + catalog）
+   - `/prototype_ui_convention.md`（`/scheme.yaml` と同階層）
+1. ユーザーに原始要件の入力を依頼
+2. 入力を raw requirement として扱う
+3. `prompts/vspec_new/background.md` を読み込み、要件分析と背景補完を実行
+4. `/specs/background/original.md` に書き込み
+5. Open Questions/要確認事項の回答を促す（自己回答でも、AI の回答案→ユーザー確認でも可）
+6. 以降、`prompts/vspec_new/*` に従い `/specs/` 配下の成果物を生成
+
+### `/vspec:refine`
+
+`/docs/refine/` の追補資料（またはコマンド引数で指定されたファイル/ディレクトリ）に基づき、要件を追補して更新します。
+
+Flow:
+0. `/specs/details/` が存在し非空であることを確認（欠ける場合は停止し `/vspec:detail` を促す）
+1. refine 入力を読む（引数があれば優先、無ければ `/docs/refine/refine.md`）
+2. `prompts/vspec_refine/refine.md` を読み込み、口径と影響成果物を更新
+3. `/specs/background/original.md` に追記し、影響する `/specs/details/` と `/specs/prototypes/` を同期更新
+
+### `/vspec:refine-q`
+
+回答済みの質問に基づき要件を更新します。
+
+Flow:
+1. `/specs/background/questions.md` が無い場合は停止
+2. 回答済み項目を抽出
+3. `prompts/vspec_refine/refine_q.md` を読み込み、回答を口径へマージ
+4. `/specs/background/original.md` に追記
+5. `/specs/background/questions.md` を更新し、回答済みとして扱った項目を `<mark>...</mark>` で強調
+
+### `/vspec:more-q`
+
+追加の確認質問を生成し、`/specs/background/questions.md` に追記します（重複排除・番号継続）。
+
+Flow:
+1. `/specs/background/questions.md` が無い場合は停止（先に `/vspec:new` を促す）
+2. `prompts/vspec_more_q/more_q.md` を読み込み、追加質問を生成
+3. 新規項目のみを `questions.md` 末尾へ追記（既存は書き換えない）
+4. ユーザーが回答し、その後 `/vspec:refine-q` を実行するための指示を出す
+
+### `/vspec:detail`
+
+機能一覧に基づき要件詳細を展開します（`/specs/details/` に生成）。
+
+### `/vspec:verify`
+
+モデル（`/specs/models/`）と実行可能プロトタイプ（`/specs/prototypes/`）を生成して検証します。
+
+### `/vspec:qc`
+
+`/specs/` 配下の成果物を品質チェックし、`/specs/qc_report.md` を生成します。
+
+### `/vspec:accept`
+
+受入テストケースを `/specs/acceptance/` に生成します。
+
+### `/vspec:append-test`
+
+受入ケースと既存テストスタックをもとに、自動テストコードを生成します（テスト実行はしない）。
+
+### `/vspec:impl`
+
+仕様に基づき、統合実装コード（API 契約、backend、frontend 連携）を `/specs/` 配下に生成します。
+
+### `/vspec:upgrade`
+
+`/docs/` 配下の資料（legacy/current）に基づき、`/vspec:new` と同様の構造で `/specs/` を再生成/更新します。
+
+### `/vspec:plan`
+
+ストーリーマップで分解し、見積（SP）と排期（HTML）を生成します。
+
+### `/vspec:mrd`
+
+MRD（市場/競合/ユーザー/プロダクト設計）分析パックを生成し、`/docs/market/` に書き出します。
+
+## Prompt Files
+
+- `prompts/vspec_new/background.md`
+- `prompts/vspec_new/stakeholders.md`
+- `prompts/vspec_new/roles.md`
+- `prompts/vspec_new/terms.md`
+- `prompts/vspec_new/flows.md`
+- `prompts/vspec_new/scenarios.md`
+- `prompts/vspec_new/details_pre_post.md`
+- `prompts/vspec_new/details_constraints.md`
+- `prompts/vspec_new/details_variations.md`
+- `prompts/vspec_new/details_boundaries.md`
+- `prompts/vspec_new/details_symmetry.md`
+- `prompts/vspec_new/dependencies.md`
+- `prompts/vspec_new/functions.md`
+- `prompts/vspec_new/questions.md`
+- `prompts/vspec_more_q/more_q.md`
+- `prompts/vspec_mrd/mrd.md`
+- `prompts/vspec_refine/refine.md`
+- `prompts/vspec_refine/refine_q.md`
+- `prompts/vspec_verify/model.md`
+- `prompts/vspec_verify/prototype.md`
+- `prompts/vspec_verify/validation.md`
+- `prompts/vspec_detail/rbac.md`
+- `prompts/vspec_detail/data_permission.md`
+- `prompts/vspec_detail/page_load.md`
+- `prompts/vspec_detail/interaction.md`
+- `prompts/vspec_detail/timeline.md`
+- `prompts/vspec_detail/formula.md`
+- `prompts/vspec_detail/expression_tree.md`
+- `prompts/vspec_detail/code_rules.md`
+- `prompts/vspec_detail/judgemental_matrix.md`
+- `prompts/vspec_detail/validation_matrix.md`
+- `prompts/vspec_detail/post_submit_check.md`
+- `prompts/vspec_detail/post_submit_processing.md`
+- `prompts/vspec_detail/post_submit_navigation.md`
+- `prompts/vspec_detail/mq.md`
+- `prompts/vspec_detail/logging_matrix.md`
+- `prompts/vspec_detail/notification_matrix.md`
+- `prompts/vspec_detail/nfp.md`
+- `prompts/vspec_detail/file_import.md`
+- `prompts/vspec_detail/file_export.md`
+- `prompts/vspec_detail/cron_job.md`
+- `prompts/vspec_accept/accept.md`
+- `prompts/vspec_test/test.md`
+- `prompts/vspec_impl/implement.md`
+- `prompts/vspec_upgrade/upgrade.md`
+- `prompts/vspec_plan/estimate.md`
+- `prompts/vspec_plan/schedule.md`
+- `prompts/vspec_qc/qc.md`
+- `prompts/vspec_qc/quality_standard.md`