Bricks

Bricks 为编码 Agent 提供感知实现的组件契约,让构建出的界面组件真正属于现有的产品、代码库和设计系统。写代码之前,Agent 先明确组件的职责、上下文、变体、状态与验收要求,再用项目自己的原语实现,并在真实页面里完成验证。

GitHub
组件层MIT

KOSTJA 维护 · 更新于 2026-09 · MIT · catalog/components.json · Navigation · Content · Conversion · Layout · Agent UI · Agnostic — no fixed framework

$npx skills add kostja94/bricks --skill component-builder
01

为什么需要 Bricks

!

生成的组件自行发明现实

生成的 Footer 可能编造路由;FAQ 可能把答案藏起来,辅助技术根本读不到;Task Input 可能漏掉加载、取消、非法输入和结果恢复——恰恰是用户真正需要的状态。

!

Demo 看着像样,集成一塌糊涂

Agent Workspace 在演示里可以很唬人,却没有任何可用的边界来区分对话、工具、产物和用户控制——Agent 还习惯性地交付孤立 demo 或引入第二套设计系统,而不是贴合项目的实现。

!

难点在于界定职责

写组件代码这件事 Agent 已经很擅长;更难的是在动手之前,决定这个组件负责什么——它的上下文、变体、内容、交互状态和归属边界——并让它融入周围的产品。

02

契约提供什么

感知实现的组件契约

每个组件概念一份持续维护的参考,覆盖职责、上下文、变体、内容、交互状态、技术边界与验收要求。

基于上下文的变体

同一个组件在不同界面含义不同——营销 Footer 组织站点出口,应用 Footer 可能只剩运营链接。Bricks 记录这些上下文决策,而不为每种组合新造一个组件名。

项目原生的构建流程

Agent 先查看路由、token、依赖、数据模型与约定,复用项目原有原语,实现必需状态,并在真实页面里验证组件——而不是只看隔离预览。

机器可读目录

catalog/components.json 覆盖导航、内容、转化与信任、布局、Agent 界面等组件组——ID 稳定,可供 Agent 工具引用。

复杂领域的选型指导

对编辑器、数据表格、图表、日历和无障碍原语这类复杂领域,当项目没有现成方案时,契约会指引 Agent 选用成熟库。

03

安装后下达一个边界任务

1.安装 component-builder Skill。

$npx skills add kostja94/bricks --skill component-builder

2.一个真实的边界任务:任务本体加集成上下文(见 examples/footer-request.md)。

$Use component-builder to build the footer for this bilingual SaaS site. Read the existing routes, components, design tokens, framework, and responsive conventions first. Reuse project primitives, include the real product, resource, company, and legal destinations, and verify keyboard access on mobile and desktop.
04

它不是什么

不做整站规划——它构建界面组件和有边界的组合模式,不负责产品规划或全站信息架构。

不是组件包或设计系统——没有固定的 React/Vue/CSS 组件库,也不允许替换项目自身的约定。

不做审计流程——也绝不宣称从未在目标项目里实际验证过的性能、无障碍、合规或转化结果。

兼容工具

常见问题

Bricks 是可以直接导入的 UI 组件库吗?
不是,它提供组件职责、变体、状态和验证要求等契约。实际实现应复用目标项目的框架、原语和设计约定,而不是换上一套固定组件库。
让 Bricks 构建组件前,需要提供什么?
需要提供边界清晰的组件任务和集成上下文。Agent 还应先检查现有路由、设计 token、依赖和数据模型,并在真实页面中验证实现。
Bricks 能负责整个网站的规划吗?
不能,它负责界面组件与有边界的组合模式。全站信息架构和产品规划超出它的职责;页面级任务可以查看 Pagina。

你的产品,值得被发现。

好产品输的从来不是质量,是无人知晓。我们把它翻转过来——一次复利,一个系统。

开始合作

本网站使用 Cookie 及类似技术,用于数据分析、个性化广告(Google AdSense)和必要功能。点击「全部接受」即表示同意我们使用 Cookie;你也可以选择「仅必要」,拒绝非必要 Cookie。

隐私政策