speclite-create-ux-design
执行 SpecLite Create UX Design workflow,生成用户体验与交互设计规格。用于用户要求 create UX design、创建 UX 设计、生成 UX spec 或规划体验。核心能力:配置驱动激活、发现来源产物、按步骤编排、生成 `.md` 输出并交接完成。
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 4
- Forks
- 0
01 前言 Front Matter
- name
- speclite-create-ux-design
- metadata
- { "author": "fancyliu", "catalog": "speclite", "version": "1.0.0" }
- description
- 执行 SpecLite Create UX Design workflow,生成用户体验与交互设计规格。用于用户要求 create UX design、创建 UX 设计、生成 UX spec 或规划体验。核心能力:配置驱动激活、发现来源产物、按步骤编排、生成 `.md` 输出并交接完成。
- allowed-tools
- Read, Write, Bash, Grep, Glob, WebSearch
02 资源文件 22
- 资产文件assets/ux-design-template.md236 B
- 参考文档CHANGELOG.md351 B
- 其他config.toml.example917 B
- 其他customize.toml1.6 KB
- 参考文档references/steps/step-01-init.md9.2 KB
- 参考文档references/steps/step-01b-continue.md5.4 KB
- 参考文档references/steps/step-02-discovery.md6.6 KB
- 参考文档references/steps/step-03-core-experience.md8.1 KB
- 参考文档references/steps/step-04-emotional-response.md8.1 KB
- 参考文档references/steps/step-05-inspiration.md8.5 KB
- 参考文档references/steps/step-06-design-system.md8.7 KB
- 参考文档references/steps/step-07-defining-experience.md8.6 KB
- 参考文档references/steps/step-08-visual-foundation.md9.5 KB
- 参考文档references/steps/step-09-design-directions.md9.7 KB
- 参考文档references/steps/step-10-user-journeys.md8.2 KB
- 参考文档references/steps/step-11-component-strategy.md9.7 KB
- 参考文档references/steps/step-12-ux-patterns.md7.8 KB
- 参考文档references/steps/step-13-responsive-accessibility.md9.1 KB
- 参考文档references/steps/step-14-complete.md8.0 KB
- 参考文档references/workflow-details.md9.0 KB
- 脚本scripts/ux-artifact-operation.mjs10.6 KB
- 参考文档SKILL.en.md5.0 KB
03 SKILL.md 正文
[技能说明] Create Ux Design 是 Speclite 规划与产品设计工作流 Skill,用于在目标项目中按配置语言、输出语言和工作流步骤完成对应制品或交付动作。
源入口说明:Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX"
[核心能力]
- UX 路径治理:新产物统一写入 real {planning_artifacts}/ux/ physical owner 内的三个精确文件;exclusive create 与 design-system/ on-demand mkdir 必须由 private {skill-root}/scripts/ux-artifact-operation.mjs 在 commit-time physical-owner / nearest-existing-ancestor revalidation 后立即执行,不向调用方返回 approval 后再自行写入。create-file 使用 node "{skill-root}/scripts/ux-artifact-operation.mjs" create-file --project-root "{project-root}" --planning-root "{planning_artifacts}" --target "{target}" --source "{source-file}";create-directory 使用 node "{skill-root}/scripts/ux-artifact-operation.mjs" create-directory --project-root "{project-root}" --planning-root "{planning_artifacts}" --target "{target}"。stdout 必须是恰一个 JSON object;non-zero、invalid JSON 或 ok !== true 必须 HALT 且不得推进 frontmatter/progress/append target。该 script 是 Skill-private binding,不是 public speclite CLI。Existing legacy UX artifacts 仅在 real Planning owner 内只读发现并原位继续。本地 Markdown duplicate definition 采用 first-definition-wins;local-ish HTML href / src raw value 含 & 时 fail closed。
- Speclite 激活解析:解析三层 customize(base→team→user)、workflow.persistent_facts 和 workflow.on_complete,并通过 speclite resolve config --project-root {project-root} 加载 merged runtime config。
- 源制品发现与上下文加载:按 workflow 规约读取项目制品、配置字段、历史上下文和必要数据文件,保持源流程的输入发现语义。
- 步骤化工作流执行:按 references/workflow-details.md 与拆分后的 reference/step 文件逐步执行,遵守顺序、HALT 条件、菜单等待和状态推进规则。
- 模板化输出生成:使用 assets 中的模板或示例骨架生成文档、报告、规格或交付产物,输出语言服从 document_output_language。
- 质量校验与交接:执行清单、报告、状态同步或 completion handoff,并在退出前解析和执行 workflow.on_complete。
- 迁移一致性约束:当前运行规约只依赖 Speclite runtime,不读取旧运行目录、旧配置文件或旧命令命名空间。
[约定]
裸路径相对于 {skill-root} 解析;{project-root} 是目标项目工作目录;{speclite-runtime-root} 是 {project-root}/_speclite;{skill-name} 是目录 basename。
[激活流程]
触发后先解析 workflow,执行 activation_steps_prepend,加载 persistent_facts,运行 speclite resolve config --project-root {project-root},按 communication_language 与用户沟通,并执行 activation_steps_append。配置文件缺失或关键字段为空时必须 HALT;config.toml.example 只说明字段结构,不作为 runtime fallback。
customization 必须通过 `speclite resolve customization --skill {skill-root} --project-root {project-root}` 读取 merged JSON;`workflow.on_complete` 使用 `speclite resolve customization --skill {skill-root} --project-root {project-root} --key workflow.on_complete` 解析。默认 activation 不手写 TOML merge,不使用 `--human` 作为 machine input。
[执行流程]
1. 先完整阅读 references/workflow-details.md;该文件是从源入口转换后的权威工作流规约。随后按需读取 references/workflow-details.md、references/steps/step-01-init.md、references/steps/step-01b-continue.md、references/steps/step-02-discovery.md、references/steps/step-03-core-experience.md、references/steps/step-04-emotional-response.md 等 reference 文件。
2. 执行工作流前,确认 {skill-root}、{project-root}、{speclite-runtime-root}、{skill-name} 四个路径变量均已明确。
3. 若 workflow 指向 step 文件,必须一次只读取当前 step,完整执行后再进入下一步;遇到菜单或用户确认点时 HALT 等待。
4. 生成或更新产物时,按源 workflow 的模板、清单、状态字段和输出位置要求执行,不得因为迁移而改变核心需求。
5. 收尾前运行 checklist 或质量检查,解析 workflow.on_complete,并在输出文档末尾追加本 Skill 的生成标注。
[注意事项]
- 名称、目录与 YAML name 字段保持 kebab-case 一致:speclite-create-ux-design。
- references/workflow-details.md 和配套 reference 文件均为有效执行规约,不是背景资料。
- 模板或示例骨架位于 assets/ux-design-template.md。
- 如工作流需要项目配置,必须读取目标项目运行时配置。
- config.toml.example 仅作字段结构参考,不作为 runtime fallback。
- 当前运行规约不得依赖旧运行目录、旧 YAML 配置或旧命令命名空间。
- 输出文档末尾必须追加 *本文档由 speclite-create-ux-design Skill 自动生成* 标注。
[生成信息] 本 Skill 由 speclite-skill-creator 自动生成。
04 同仓库更多 Skills
speclite-dev-story
暂无简介
speclite-code-review-01-reviewer
Fixture-owned installed skill entry for the minimal artifact loop.
speclite-skill-lint
只读检查 Skill 定义;用于 lint skill、check skill、检查技能或评估 Skill 规范。区分基础格式、Codex 适配和 SpecLite 约定,报告证据及未检查项;Agent 定义包转交 speclite-agent-lint。
speclite-skill-creator
创建或迭代 SpecLite workflow Skill;用于 create skill、新建技能、生成技能包或封装工作流。设计入口、辅助资源和验证用例;Agent 定义包转交 speclite-agent-creator。
speclite-html-ppt-generator
生成 SpecLite-owned 单文件 HTML PPT。用于用户要求创建 docs presentation、HTML PPT、网页 slides、Swiss Style deck、杂志风 deck,或其他可直接浏览器打开的介绍/分享型 deck。核心能力:使用本 Skill 内置模板、主题、layout 和 validator 生成横向翻页 HTML,并避免依赖外部个人 skill 路径。
speclite-docs-intro-ppt-creator
生成 SpecLite docs 下的介绍型 HTML PPT。用于用户要求把某个项目体系、系统设计、治理机制、理念或工作流总结成 docs presentation、HTML PPT、网页 slides、介绍 deck。核心能力:限定输出目录、基于事实材料规划叙事、调用 speclite-html-ppt-generator 生成单 HTML deck,并用确定性检查和浏览器抽样收口。