UX Paths 是一个用户旅程故事生成器技能，通过分析应用代码库，生成详尽且贴近真实的用户旅程目录。产物包括短故事（只使用单一功能）和长故事（完整的多步骤工作流），反映真实用户可能如何使用应用。
主要用途与能力
- 发现与建模：扫描代码库，识别应用类型（Web、移动、桌面、CLI、API 等）、入口点、功能清单、用户角色、导航结构、状态转换、数据实体、外部集成、错误状态与功能开关。
- 主题划分：输出推荐的故事主题（通常 8–12 个），覆盖应用整体。
- 并行生成故事：为每个主题启动一个探索型子智能体，深入阅读相关组件、路由与处理逻辑，产出 5–15 个故事，混合短（2–5 步）、中（5–15 步）、长（15–40 步）三种类型。
- 故事字段：标题、类型、主题、人物画像、目标、前置条件、理想路径（最少步数与理由）、可选路径（同一目标的其它代码路径或“none found”）、步骤（用户操作 → 预期结果）、变体、边界情况。
- 汇总目录：为全部故事分配连续编号、合并相似故事、建立跨主题引用与依赖图、核对功能覆盖、标注缺口，并整理冗余候选（重复路径、多界面重复展示的信息、功能重叠）。
使用方式
- 调用命令：/ux-paths [可选重点领域]
- 参数：重点领域（默认整个应用，可限定如 authentication、checkout flow）；输出目录（默认 docs/ux-paths/）；深度（默认 deep，quick 为更少智能体与更短路径）。
- 执行流程：先创建目录，启动发现智能体并写出 discovery.md；读取推荐主题后，并行启动故事智能体，写入 topics/{topic-slug}.md；全部完成后启动汇总智能体，生成 catalog.md；最后向用户报告故事总数、类型分布、覆盖率、缺口与目录路径。
- 前置操作：mkdir -p docs/ux-paths/topics
适用场景
- 需要系统性梳理应用的用户操作路径与功能覆盖。
- 为 UX 走查（/ux-walker）和流程评估（/ux-flow）提供输入：理想路径用作摩擦基准，可选路径与冗余候选用于评估简洁性与重复性。
- 应用迭代后定期重跑，捕捉新增功能与废弃流程。
限制与注意事项
- 故事必须基于代码中真实存在的界面元素、路由与功能，不得虚构。
- 发现阶段是基础；若遗漏主要功能区域，目录会存在缺口。
- 不应过度约束主题，应让发现智能体依据实际代码确定主题边界。
- 可选路径应如实记录，“none found”是有效答案，不应编造。
- 该技能依赖子智能体与并行执行环境；具体运行环境要求暂未提供。