UX Journey Architect 是一个用户体验旅程规划技能，适用于公开网站。使用前提是站点目标、主要受众和大致 URL 结构已经明确。在产出完整旅程地图之前，需要先阅读 references/journey-workflow.md。
用途
该技能用于为公开网站梳理用户旅程，覆盖从入口到下一步有用页面的路径，并确保旅程不会隐藏对 SEO/LLM 关键的内容或破坏内容模型。它关注的是旅程层面的结构设计，而非视觉或实现细节。
主要能力
该技能负责以下内容：
- 用户旅程地图；
- 引导路径；
- 入口点与首次行动设计；
- 按意图划分的 CTA 层级；
- 信任点与可信度信号；
- 无障碍与移动端旅程风险；
- 面向 SEO/LLM 页面角色的 UX 交接要求。
该技能不负责以下内容：
- 最终视觉设计；
- 组件实现；
- 浏览器渲染测试；
- SEO schema 或 canonical 决策；
- 线上站点代码修改；
- 转化埋点实现。
使用方式
工作流程如下：
- 识别受众细分与入口来源。
- 梳理每个细分在首屏和首次滚动时需要理解的内容。
- 定义主要行动、次要行动以及建立信任所需的证明。
- 梳理从入口页面到下一个有用页面的路径。
- 检查旅程是否隐藏了 SEO/LLM 关键内容或破坏了内容模型。
- 识别移动端、无障碍和认知负荷风险。
- 使用 assets/journey-map.template.md 产出旅程地图。
- 在需要时，将视觉布局验证、留存系统和引导实现推迟到待办事项中。
输出结构包括：受众细分与入口来源；旅程地图表格；首屏要求；CTA 层级与标签；信任与证明点；无障碍/移动端风险；SEO/LLM 交接说明；以及针对布局验证、留存、转化和引导的待办事项。
适用场景
该技能定义了多种旅程类型：
- 新读者：需要快速定位、了解该来源为何不同、从哪里开始以及如何跟进更新。
- 回访读者：需要新鲜度信号、清晰的最新内容、已保存的心智模型，以及通往新闻或解释性内容的快速路径。
- 项目评审者：需要工作证明、仓库或制品链接、项目状态，以及与站点专业领域的关系。
- 社区成员：需要公开社交链接、Telegram/社区路径，以及对那里会发生什么的预期设定。
- AI 智能体或研究者：需要可抓取的静态内容、清晰的页面角色、来源线索、实体页面和低歧义性。
限制
该技能包含若干不可妥协的约束：
- 不提出通用的落地页填充内容。
- 不将实际内容隐藏在过大的装饰之后。
- 不添加没有用户意图的 CTA。
- 不削弱已声明的 SEO/LLM 内容模型。
- 除非站点目标发生变化，否则不用营销漏斗替换短新闻和长文页面。
- 在没有测量的情况下不声称转化提升。
安全与隐私边界：
- 不在公开旅程制品中包含私有分析行、原始 IP 日志、账户标识符、会话录制或私有用户数据。
- 不推荐暗黑模式、强制订阅、误导性紧迫感、虚假社会证明或无障碍性差的交互。
- 除非用户明确要求带凭据的分析任务且存在隐私政策，否则不请求凭据。
验证方式：
使用以下命令验证技能编辑：
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $HOME/SKILL/skills/ux-journey-architect python3 $HOME/SKILL/plans/seo-llm-skill-cluster/scripts/lint_skill_cluster.py $HOME/SKILL
前向测试位于 evals.json。