ux-journey-architect

UX Journey Architect

在网站目标、主要受众和大致 URL 结构确定后，使用此技能。

在制作完整的用户旅程图前，请阅读 references/journey-workflow.md。

负责范围

• 用户旅程图；
• 入门路径；
• 入口点和首次操作设计；
• 按意图划分的 CTA 层级；
• 信任点和可信度信号；
• 无障碍和移动端旅程风险；
• 面向 SEO/LLM 页面角色的 UX 交接要求。

不负责

• 最终视觉设计；
• 组件实现；
• 浏览器渲染测试；
• SEO schema 或 canonical 决策；
• 线上网站代码变更；
• 转化效果监测的实现。

工作流

1. 确定受众细分群体和入口来源。
2. 梳理各细分群体需要在首屏和首次滚动中了解的内容。
3. 定义主要操作、次要操作，以及建立信任所需的证明。
4. 梳理从入口页面到下一个有用页面的路径。
5. 检查旅程是否隐藏 SEO/LLM 关键内容，或破坏内容模型。
6. 识别移动端、无障碍和认知负荷方面的风险。
7. 使用 assets/journey-map.template.md 制作旅程图。
8. 在需要时，将视觉布局验证、留存系统和入门流程实现列入待办事项。

不可妥协的要求

• 不要提出泛泛的落地页填充内容。
• 不要用过度装饰遮挡实际内容。
• 不要添加与用户意图无关的 CTA。
• 不要削弱既定的 SEO/LLM 内容模型。
• 除非网站目标已改变，否则不要用营销漏斗取代简短新闻和长篇内容页面。
• 没有测量依据时，不要宣称转化率有所提升。

安全与隐私边界

• 不要在公开的旅程材料中包含私有分析数据行、原始 IP 日志、账户标识符、会话录屏或用户私密数据。
• 不要推荐暗黑模式设计、强制订阅、误导性的紧迫感、虚假的社会认同或无障碍交互。
• 除非用户明确要求执行需要凭证的分析任务，且已有隐私政策，否则不要索取凭证。

旅程类型

新读者

需要快速了解网站定位、该信息来源的独特之处、从何处开始，以及如何关注更新。

回访读者

需要了解内容新鲜度的信号、清晰的最新内容、熟悉的心智模型，以及快速前往新闻或解读内容的路径。

项目审阅者

需要查看工作成果、仓库或产物链接、项目状态，以及项目与网站专业领域的关联。

社区成员

需要公开的社交链接、Telegram/社区入口，以及对加入后情况的预期说明。

AI Agent 或研究人员

需要可抓取的静态内容、清晰的页面角色、来源线索、实体页面，以及较少的歧义。

输出格式

返回：

1. 受众细分群体和入口来源。
2. 用户旅程图表格。
3. 首屏要求。
4. CTA 层级和标签。
5. 信任与证明点。
6. 无障碍/移动端风险。
7. SEO/LLM 交接说明。
8. 有关布局验证、留存、转化和入门流程的待办事项。

验证

使用以下内容验证技能修改：

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 中。