关于 product-context-builder
Product Context Builder 帮助团队为在产品代码仓库中工作的编码 Agent 构建精简且有证据依据的上下文体系。它先检查现有规范与设计资料,再通过可审阅的步骤编写必要文件,而非默认生成全部文档。
主要功能
- 01检查仓库规范与项目结构
- 02依据现有产品和设计资料
- 03仅选择相关的上下文文件
- 04逐个起草文件以供审阅
- 05对照仓库审计生成的上下文
适用场景
- 01为编码 Agent 准备仓库指南
- 02记录已有的产品与视觉系统
- 03根据稳定工作流创建可重复使用的项目技能
- 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.mdCLAUDE.template.mdDESIGN.template.mdPRODUCT.template.mdreferences/always-loaded-files.mddesign.mdproduct.mdproject-skills.mdvalidation.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/ 中的模板用作证据提示,而不是必须机械填写的表格。删除空白和不相关的章节。
分轮完成,便于审阅
每次只起草一个文件,并说明:
- 哪些代码仓库证据影响了文件内容
- 哪些表述来自用户
- 还存在哪些问题或冲突
在将战略判断作为持久上下文之前,请用户审阅。产品个性、反面参考、例外情况和硬性约束都需要明确确认。
保持各层互联
始终加载的文件应包含尽可能精简且有用的路由规则。例如:
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