使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill ux-journey-architect开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
UX Journey Architect
Use this skill after the site goal, primary audience, and rough URL structure are known.
Read references/journey-workflow.md before producing a full journey map.
Owns
- user journey maps;
- onboarding paths;
- entry point and first-action design;
- CTA hierarchy by intent;
- trust points and credibility signals;
- accessibility and mobile journey risks;
- UX handoff requirements for SEO/LLM page roles.
Does Not Own
- final visual design;
- component implementation;
- browser rendering tests;
- SEO schema or canonical decisions;
- live site code changes;
- conversion instrumentation implementation.
Workflow
- Identify audience segments and entry sources.
- Map what each segment needs to understand in the first viewport and first scroll.
- Define the primary action, secondary actions, and proof needed for trust.
- Map the path from entry page to next useful page.
- Check that the journey does not hide SEO/LLM-critical content or break the content model.
- Identify mobile, accessibility, and cognitive-load risks.
- Produce a journey map using assets/journey-map.template.md.
- Defer visual layout validation, retention systems, and onboarding implementation to the backlog when needed.
Non-Negotiables
- Do not propose generic landing-page filler.
- Do not hide actual content behind oversized decoration.
- Do not add CTAs that have no user intent.
- Do not weaken the declared SEO/LLM content model.
- Do not replace short news and longform pages with a marketing funnel unless the site goal changed.
- Do not claim conversion uplift without measurement.
Safety And Privacy Boundaries
- Do not include private analytics rows, raw IP logs, account identifiers, session recordings, or private user data in public journey artifacts.
- Do not recommend dark patterns, forced subscriptions, misleading urgency, fake social proof, or inaccessible interactions.
- Do not request credentials unless the user explicitly asks for a credentialed analytics task and a privacy policy exists.
Journey Types
New Reader
Needs fast positioning, why this source is different, where to start, and how to follow updates.
Returning Reader
Needs freshness signals, clear latest content, saved mental model, and quick route to news or explainers.
Project Reviewer
Needs proof of work, repository or artifact links, project status, and relation to site expertise.
Community Member
Needs public social links, Telegram/community routes, and expectation-setting about what happens there.
AI Agent Or Researcher
Needs crawlable static content, clear page roles, source trails, entity pages, and low ambiguity.
Output Shape
Return:
- Audience segments and entry sources.
- Journey map table.
- First viewport requirements.
- CTA hierarchy and labels.
- Trust and proof points.
- Accessibility/mobile risks.
- SEO/LLM handoff notes.
- Backlog items for layout validation, retention, conversion, and onboarding.
Validation
Validate skill edits with:
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/SKILLForward tests live in evals.json.
