mcpField
P
product-context-builder

product-context-builder

github.com/thedesignprojectAgent 工作流9739 次安装9 周前更新
代码仓库

关于 product-context-builder

Product Context Builder 帮助团队为在产品代码仓库中工作的编码 Agent 构建精简且有证据依据的上下文体系。它先检查现有规范与设计资料,再通过可审阅的步骤编写必要文件,而非默认生成全部文档。

主要功能

  1. 01检查仓库规范与项目结构
  2. 02依据现有产品和设计资料
  3. 03仅选择相关的上下文文件
  4. 04逐个起草文件以供审阅
  5. 05对照仓库审计生成的上下文

适用场景

  1. 01为编码 Agent 准备仓库指南
  2. 02记录已有的产品与视觉系统
  3. 03根据稳定工作流创建可重复使用的项目技能
  4. 04检查上下文文件中的无依据假设

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/thedesignproject/agent-skills --skill product-context-builder

安装后在 Claude Code 中输入/product-context-builder确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

assets/templates/
AGENTS.template.md
CLAUDE.template.md
DESIGN.template.md
PRODUCT.template.md
references/
always-loaded-files.md
design.md
product.md
project-skills.md
validation.md

详细介绍

产品上下文构建器

基于用户的真实产品和代码仓库,构建一个精简、互联的上下文系统。完成后的文件应帮助 AI Agent 理解代码库、产品背后的判断、必须复用的视觉系统,以及在相关任务中可加载的特定工作流。

先了解现有内容

在采访用户之前,先检查代码仓库。查找:

  • 现有的 AGENTS.md、CLAUDE.md、PRODUCT.md、DESIGN.md 和技能文件夹
  • 软件包脚本、构建和测试命令、源代码目录及贡献规范
  • UI 组件、Storybook 故事、主题文件、CSS 变量、Tailwind 配置和设计令牌包
  • 产品文档、PRD、研究资料、品牌指南和无障碍要求

报告发现了什么、哪些内容可以安全推断,以及哪些问题需要人工回答。绝不臆造命令、组件名称、产品定位、设计令牌或约束。

只创建确有必要的文件

不要自动生成所有文件。

  • 当多个编码 Agent 需要稳定的代码仓库说明时,创建或更新 AGENTS.md。
  • 当 Claude Code 需要有实际区别的工具专属指导时,创建或更新 CLAUDE.md。确保共享规则与 AGENTS.md 保持一致。
  • 当 Agent 需要持久的产品判断时,创建 PRODUCT.md:受众、目的、个性、原则、参考对象和反面参考。
  • 当有真实的视觉系统或组件库可依据证据记录时,创建 DESIGN.md。
  • 只有在任务可重复、有明确触发条件且工作流稳定时,才创建项目技能。

起草文件前,请先阅读相应指南:

将 assets/templates/ 中的模板用作证据提示,而不是必须机械填写的表格。删除空白和不相关的章节。

分轮完成,便于审阅

每次只起草一个文件,并说明:

  1. 哪些代码仓库证据影响了文件内容
  2. 哪些表述来自用户
  3. 还存在哪些问题或冲突

在将战略判断作为持久上下文之前,请用户审阅。产品个性、反面参考、例外情况和硬性约束都需要明确确认。

保持各层互联

始终加载的文件应包含尽可能精简且有用的路由规则。例如:

Before writing or changing UI, read PRODUCT.md and DESIGN.md. Reuse documented components and tokens. If the system does not cover a design need, ask before creating a new pattern.

不要将 PRODUCT.md 或 DESIGN.md 的全部内容复制到 AGENTS.md 或 CLAUDE.md 中。不要把适用于整个代码仓库的通用规则藏在任务技能中。

最后审计上下文

阅读验证,根据代码仓库检查每个生成的文件,并总结:

  • 创建或更新的文件
  • 使用的证据
  • 已解决的矛盾
  • 仍待确认的假设
  • 用户应使用新上下文系统测试的下一个真实任务

评论

支持 Markdown