user-context

用户上下文

用户上下文会保存设计师常用的产品和设计参考资料，让未来的产品设计工作从正确的来源开始。

当用户要求以下事项时，使用此技能：

• 设置产品设计
• 开始使用产品设计
• 熟悉产品设计
• 保存产品或设计资料
• 查看产品设计记住了什么
• 更新已保存的产品或设计上下文
• 记住产品设计偏好
• 设置我的插件

关键覆盖规则

• 继续操作前，请参阅插件路由器 $index。
• 遵循 $critical-overrides。
• 在提供引导或为未来对话保存上下文之前，请确认本地 shell 访问可用、可以解析 $CODEX_HOME，并且 $CODEX_HOME/state/plugins/product-design/ 已存在且可写，或可以在可写的父目录中创建。如果 user-context.md 已存在，也请确认其可写。
• 如果任何检查无法完成或未通过，则无法使用持久化上下文。不要提供已保存上下文的引导，也不要声称新上下文已保存以供未来对话使用。如果用户要求保存内容，请说明这些内容可用于当前对话，但无法保存以供未来对话使用。

已保存的用户上下文

如果 user-context.md 存在，默认使用它。

使用已保存的产品 URL、Figma 文件、截图、参考图片、代码库路径、Storybook、设计令牌、设计系统、品牌素材、组件参考、浏览器偏好和分享目标，为产品设计工作提供依据。

构思、原型、审查、克隆和评析应与已保存的产品上下文保持一致，除非用户另有要求。

当工作流需要视觉依据时，在 ImageGen、构思、原型、审查和评析工作中附上或包含相关的已保存截图、参考图片、设计令牌、设计语言和组件参考。

状态文件

已保存的上下文位于此处：

$CODEX_HOME/state/plugins/product-design/user-context.md

已保存的截图和参考图片存放在其旁边：

$CODEX_HOME/state/plugins/product-design/assets/

如果文件不存在，则正常继续，除非用户要求设置产品设计、保存上下文，或当前任务因缺少产品／设计上下文而受阻。

预检

当任何产品设计工作流需要已保存的上下文时，运行：

python3 scripts/user_context_preflight.py

使用返回的已保存条目作为任务的起始上下文。

如果脚本报告不存在已保存的上下文，则根据用户当前的提示继续，除非任务需要设置上下文。

预检时不要浏览、打开或检查所有已保存的参考资料。只检查当前任务所需的已保存参考资料。

设置

当用户要求设置产品设计、询问产品设计可以记住什么、询问产品设计了解其产品的哪些信息，或提供要保存的产品／设计参考资料时，请使用 references/onboarding.md。

对于仅涉及设置的请求，请说明产品设计可以记住什么，并询问用户有哪些有用的资料。

根据用户的请求调整上下文收集方式。首次设置与更新现有上下文有所不同。

设置期间不要检查工作区、安装依赖项、搭建原型框架、生成图片、运行审查或开始实施。

用户提供要保存的参考资料后，运行：

python3 scripts/init_user_context.py

然后将这些参考资料添加到创建的 user-context.md 中。

保存

保存有用且持久的产品设计上下文：

• 产品 URL
• Figma 文件
• 截图和参考图片
• 代码库路径
• Storybook 和组件文档
• 设计令牌和主题来源
• 品牌、徽标、图标、插图、图片和素材来源
• 首选浏览器、截图工具和分享目标
• 能让未来产品设计工作更准确的团队约定

当用户提供要保存的截图或参考图片时，将其复制到 user-context.md 旁边的 assets/ 中，并在已保存的条目中添加链接。

为每张已保存的图片指定清晰且描述性强的文件名，说明图片展示的内容。文件名应让未来的产品设计任务无需打开文件就能理解图片内容。

好的图片名称：

assets/chatgpt-settings-modal-dark-mode.png
assets/payment-sheet-mobile-error-state.png
assets/product-dashboard-sidebar-navigation.png
assets/storybook-primary-button-states.png
assets/brand-logo-lockup-purple-gradient.png
assets/onboarding-flow-welcome-step.png
assets/checkout-confirmation-screen.png
assets/account-menu-open-state.png

不要保存机密、凭据、API 密钥、私有令牌、复制的客户数据或任何不应持久保存的内容。

使用以下结构：

# {Category}

- Description: {what this category is and when future Product Design runs should use it}

## Saved Links And Context

{Saved reference or fact}
- Date Added: YYYY-MM-DD.
- File: assets/{clear-descriptive-name}.png
- Useful Context: {what this reference represents}
- Future Use: {how future Product Design work should use it}

仅当已保存的条目包含本地图片文件时，才添加 File:。

当某个类别尚无已保存的参考资料时，请使用以下内容，且必须完全一致：

status: not provided

精心整理已保存的上下文。优先保留少量高价值参考资料，而不是倾倒所有可能的 URL 或文件。

读取

• 不要将 status: not provided 视为事实。
• 本地 shell 可用时，通过 scripts/user_context_preflight.py 读取。
• 将已保存的上下文作为默认依据，然后仅检查当前任务所需的内容。