CUSTOMER JOURNEY MAP SKILL · CLAUDE CODE / CODEX

Agent 懂代码。
懂用户吗?

代码在 repo 里,agent 读得到。人的体验不在。
Journey 把它记成 .journey/ 里的一张旅程地图,放在代码旁边。
聊着就能建,需求变了按 diff 改,证据和猜测分开标。

YOUR CODE HAS A MAP.
SO SHOULD YOUR USERS.
BUILD IN CONVERSATION · UPDATE BY DIFF · EXPRESS FOR ANY AUDIENCELOCAL FILES · OPEN SOURCE
01 / WHAT YOU CAN DO

说清楚场景。
地图交给 Journey。

不用先学字段,也不用选模板。
从你手头的一段经历、访谈或产品笔记开始。

01 / BUILD

把对话整理成地图

“梳理用户第一次申请这份工作的经历。”

按里程碑和步骤建立结构,连接人的目标、行为、情绪与触点。留下可继续编辑的旅程文件。

02 / UPDATE

改需求,接着改地图

“现在允许跳过注册,会影响哪些步骤?”

修改相关步骤与引用,记录改了什么、为什么改。下一次对话从已有地图继续。

03 / EXPRESS

同一份理解,交给不同的人

“给评审会一张地图,给工程师一份交接。”

从同一份旅程生成交互视图、简报、故事线或规格说明,按读者需要组织信息。

02 / INSPECT THE MAP

看得到步骤。
也查得到判断的来处。

下方直接读取仓库的求职示例。
15 个步骤、分支与字段都可以逐项检查。

断点说明:AI 筛选未记录情绪,不代表中性或零分。横向看阶段,纵向看体验 · 点击打开完整地图

在项目里,持续保存

Markdown 旅程保存在 .journey/,能进版本控制,也能在后续会话里接着用。

把推断和依据分开

来源标记保留判断来处。缺少依据的内容,可以被找到、追问和补充。

修改前后,有迹可循

脚本写入前检查结构与引用,变更记录保留操作与备注。

04 / THE TOOLKIT

从建立地图,
到持续维护。

了解完整工作方式 ↗
01PLAN

从人的目标,
开始。

把对话里的目标、行为和触点整理成旅程。

了解 PLAN ↗
02REVIEW

看见薄弱处,
再向前。

检查痛点与缺失信息,发现值得继续梳理的旅程。

了解 REVIEW ↗
03MODIFY

改动局部,
保留全貌。

按步骤修改,让新的理解留在原有上下文里。

了解 MODIFY ↗
04VALIDATE

改坏的地图,
存不进去。

写入前校验结构和引用,出错就拦下。

了解 VALIDATE ↗
05PROVENANCE

让判断,
有据可查。

追溯字段来源,区分观察、人工修改与推断。

了解 PROVENANCE ↗
06AUDIT

每次修改,
留下记录。

查询修改内容、作者与备注,保留决策轨迹。

了解 AUDIT ↗
07VIEWS

同一份地图,
换一种视角。

从时间、情绪、协作和依据等角度理解旅程。

了解 VIEWS ↗
08EXPRESS

让下一位,
接得住。

把旅程转成简报、故事线或工程交接。

了解 EXPRESS ↗
05 / START MAPPING

装进你的 agent,
从一句话开始。

“帮我梳理新用户第一次使用产品的旅程,
把你不确定的地方标出来。”

阅读快速开始 ↗
git clone --depth 1 https://github.com/cguodesign/customer-journey-map-skill ~/.claude/skills/journey

安装后,在项目里开始一段关于用户体验的对话。