用途
setup-ux 是 UX Skills 中的初始化技能，目标是为后续 UX 工作建立一个小而实用的上下文层，让工作从产品意图和证据出发，而不是靠猜测。它同时支持新建项目和已有项目两条路径，但两条路径最终都会落到同一个 .ux/ 上下文目录。
主要能力
判断设置路径：先确定这是新项目还是已有项目。如果现有项目能明显推断出来就直接推断，否则只问一个简短问题。
新项目：以对话方式捕获意图。从用户自己的想法开始，只问下一个可能实质改变设计答案的问题。可能涉及的方向包括：为什么需要这个产品、应带来什么改善或新可能；谁受影响、他们需要完成什么；核心体验或旅程；当前范围与明确的非目标；已知约束；成功标准（如果已定义）；可用证据与假设、未知之间的区分。一次只问一个或少量相关问题，不执行固定问卷。
已有项目：先检查再重建意图。在提问前先探索仓库和已连接的来源，包括 README 与产品文档、已有用户研究、分析与支持证据、包文件、Storybook、组件、tokens、设计系统文档、Figma 或其他已连接设计源、无障碍指南、issue/PR 模板以及已有决策。基于权威证据重建产品意图草稿，但把当前行为与预期结果分开；代码能证明流程存在，通常无法证明组织为何选择它。只就材料缺口、冲突或无法可靠确立的意图提问，不向用户询问可以自行发现的信息。若旧 .ux/ 目录只含 CONTEXT.md、DESIGN-SYSTEM.md 和 DECISIONS.md，则保留这些文件并新增 INTENT.md，不强行改写已有上下文。
维护核心上下文文件。创建或刷新最小可用核心：.ux/ 下包含 INTENT.md、CONTEXT.md、DESIGN-SYSTEM.md 和 DECISIONS.md。INTENT.md 负责产品为何存在、预期结果、受影响人群、核心任务/体验、当前范围与非目标、材料约束、已知成功标准以及重要假设或未知，保持简短，是指南针而非 PRD。CONTEXT.md 负责运行环境：可观察的产品机制、主要旅程、证据位置、工程栈与工作流、无障碍期望、术语以及稳定项目事实。DESIGN-SYSTEM.md 记录实际设计系统来源与规则：Storybook、Figma、组件包、tokens、事实来源顺序、复用期望与贡献路径。DECISIONS.md 保持一份重要的 UX 或架构决策轻量索引；若项目已有 ADR 或其他决策体系，则指向它而非另建一套。
渐进式上下文：默认不在设置阶段创建研究仓库、人物库、旅程目录或约束文件夹。只有当信息密度、重复使用或不同归属使拆分确实有用时才拆分，例如 .ux/users/tasks.md、.ux/evidence/research.md 或 .ux/constraints/accessibility.md。未来技能在产品目的、结果、范围或成功标准可能改变答案时加载 INTENT.md，然后只加载与任务相关的额外上下文，不把整个 .ux/ 目录视为每次请求的强制上下文。.ux/STATE.md 不属于设置内容，也不是第五个核心上下文文件，未来代理仅在实质性多步工作且连续性会丢失时创建它。
允许信息缺失：不因未知而阻塞设置，只在答案会实质影响未来建议时提问。绝不把假设当成事实；当区分重要时，将关于人群、证据、需求、决策、意图和材料未知的陈述标记为已知、推断、假设、未知或冲突。
谨慎刷新意图：INTENT.md 是稳定的，不是冻结的。已有意图是默认值，应经受常规设计与实现工作。只有当明确的人类指示或权威证据表明产品的目的、预期结果、人群、范围、非目标、材料约束或成功定义确实改变时才修改，并做最小必要编辑而非重新生成文件。小的澄清可在不改变含义的情况下就地细化；重大变更应在 DECISIONS.md 或现有 ADR/RFC 体系中保留导致变更的决策或证据。绝不为了合理化当前实现、移除不便约束或让已完成工作事后显得对齐而重写意图；仅凭代理推断不能覆盖已确立的意图。
有用收尾：告诉设计师你了解到了什么、发现的少数重要缺口，以及意图、用户上下文和设计系统是否已被充分理解到可以开始工作，然后停止，不把设置变成审计或调研工作坊。
使用方式
在新建或已有项目中调用该技能，按其判断路径进行对话或仓库/资料检查，最终生成或刷新 .ux/ 目录下的核心上下文文件。具体安装命令与调用方式暂未提供。
适用场景
希望在开始 UX 工作前先对齐产品意图、用户与证据、设计系统及工程环境的项目，既包括从零开始的新项目，也包括需要在已有代码和文档基础上重建 UX 上下文的存量项目。
限制
不编造证据、需求、理由、实现状态或合规性。不创造用户需求、行为或人物角色。不为信息缺失而阻塞设置。设置阶段默认不建立研究仓库、人物库、旅程目录或约束文件夹。不重写已确立的意图来迎合当前实现。定价、平台支持与具体安装命令等事实暂未提供。