用途:User Context 用于保存设计师常用的产品与设计参考,让后续 Product Design 工作从正确的来源开始。适用于用户要求设置、入门、保存产品/设计来源、查看已记住内容、更新上下文或记录偏好等场景。
主要能力:默认读取已保存的 user-context.md,利用其中保存的产品 URL、Figma 文件、截图、参考图、代码库路径、Storybook、设计令牌、设计系统、品牌资产、组件引用、浏览器偏好和分享目标来支撑设计工作;在需要视觉依据时,把相关截图、参考图、令牌、设计语言和组件引用带入 ImageGen、构思、原型、审计和评审中。
状态文件:保存在 $CODEX_HOME/state/plugins/product-design/user-context.md,截图和参考图放在同目录 assets/ 下。
使用方式:在执行流程前运行 python3 scripts/user_context_preflight.py,用返回的已保存条目作为起始上下文;设置时参考 references/onboarding.md,用户提供引用后运行 python3 scripts/init_user_context.py,再把引用加入生成的 user-context.md。图片需复制到 assets/ 并起清晰描述性文件名。
限制:必须先确认本地 shell 可用、$CODEX_HOME 可解析且状态目录可创建或可写;检查失败则无法持久化,只能用于当前对话。设置阶段不要检查工作区、安装依赖、搭建原型、生成图片或运行审计。不要保存密钥、凭证、API 密钥、私有令牌或客户数据;未提供的内容不视为既有事实。