Visual Spec Skill 是一个需求分析与可视化规格生成技能，主要用途是把业务方给出的简单需求描述，转化为结构化的需求输出，并生成配套的可视化产物。它适用于业务侧只提供了非常简略的需求描述、需要启动需求分析流程的场景。
主要能力 该技能围绕场景化引导方法（scenario-based-facilitation）填充细节，设计数据模型，基于填充的细节生成 UI 原型，并以可视化形式生成业务逻辑细节。它通过一组命令覆盖从需求采集、细化、细节展开、模型与原型验证，到质量检查、验收用例与自动化测试代码生成的完整链路。
使用方式 技能通过命令驱动，主要命令包括：
- /vspec:new：创建新的需求分析会话。流程包括确保 /docs/ 及子文件夹（legacy、current、refine、dependencies）存在，不创建已废弃的 /docs/change/；按需创建 /scheme.yaml 与 /prototype_ui_convention.md；接收用户输入的原始需求；依次加载 prompts/vspec_new/ 下的 background、stakeholders、roles、terms、flows、scenarios、details_pre_post、details_constraints、details_variations、details_boundaries、details_symmetry、dependencies、functions、questions 等提示文件，分别生成背景分析、干系人、角色、术语、业务流程（PlantUML 泳道图）、场景、各节点细节、依赖系统、功能清单与问题清单，并写入 /specs/ 对应目录；最后加载 prompts/harness/post_new_verify.md 校验功能与场景细节是否完整。
- /vspec:refine：基于 /docs/refine/ 或命令参数提供的文件/目录细化需求，更新规范需求与受影响产物。
- /vspec:refine-q：基于已回答的问题细化需求，并将已回答项用 <mark>...</mark> 高亮标记。
- /vspec:more-q：生成更多澄清问题并追加到 /specs/background/questions.md。
- /vspec:detail：基于功能清单展开需求细节，为每个功能生成 rbac.md 与 data_permission.md 等基线文档，并按页面/条件/模块生成相应细节文档。
- /vspec:verify：生成数据模型与可运行页面原型，并生成场景验证网页、入口页，执行多项校验（前端技术栈匹配、移动端选择器、金额格式、可点击元素、原型完整性）。
- /vspec:proto-survey：在已有原型项目上生成完整问卷原型（Web 管理端 + 移动端填写）。
- /vspec:proto-auth：在已有原型项目上生成完整非 SSO 认证/账号页面集（Web + 移动端）。
- /vspec:qc：对 /specs/ 下生成的需求产物执行质量检查，输出 /specs/qc_report.md。Pro 版支持更广泛的质量检查并需要付费计划。
- /vspec:accept：生成验收测试用例，覆盖核心流程、异常、边界、权限与数据范围，输出到 /specs/acceptance/。
- /vspec:append-test：基于验收用例与规格生成自动化测试代码。
语言支持 技能读取 /scheme.yaml 的 selected.language（支持 en、zh-CN、ja，缺失或无效时默认 en）。命令参数或输入中显式提供 lang=<en|zh-CN|ja> 时，该次运行使用该值并更新 selected.language。当 selected.language=en 时，/specs/background/original.md 的所有标题必须为英文，并规范化为指定标题集合。
适用场景 适用于业务方需求描述简略、需要结构化需求分析并生成可视化规格、数据模型、UI 原型、验收用例与测试代码的场景，尤其适合需要多语言输出、需要场景化细节展开与原型验证的需求工程流程。
限制 部分命令有前置条件：/vspec:refine 要求 /specs/details/ 存在且非空；/vspec:verify 要求 /specs/details/ 存在且非空，否则提示先运行 /vspec:detail；/vspec:proto-survey 与 /vspec:proto-auth 要求 /specs/prototypes/ 存在且非空；/vspec:more-q 要求 /specs/background/questions.md 存在。质量检查的 Pro 版需要付费计划。资料未提供具体价格、平台支持范围与效果保证等信息。