使用 Blockstudio 进行氛围式编程
Andrej Karpathy 于 2 月 2025创造了“氛围编程”一词,用来描述这样一种工作流:你向 AI 描述想要的东西,由它编写代码。一年后,这种实践已发展成熟,他现在称之为“智能体工程”:开发者编排 AI 智能体,而不是逐行编写代码。
Blockstudio正是为此而打造。它基于文件的架构、零构建工具和可预测的项目结构,使其成为最适合 AI 辅助 WordPress开发的环境之一。
本指南介绍将 AI 编码智能体用于 Blockstudio的实用模式,涵盖从项目设置到完整网站生成的内容。
为什么 Blockstudio适合与 AI 智能体配合使用
文件,而非数据库
AI 编码智能体读写文件,这是它们的主要交互方式。Blockstudio将所有内容保存在文件系统中:每个区块各有一个 block.json和模板文件,每个页面各有一个 page.json,每个模式各有一个 pattern.json。无需管理数据库条目,无需在管理后台 UI中逐项操作,也无需运行构建步骤。
这很重要,因为文件系统和 shell 命令是 LLM 预训练数据的最大来源之一。每个模型都见过数百万个读取、写入和整理文件的示例。当你的 WordPress开发工作流与这种交互方式一致时,智能体只需很少的指令就能开展工作。
结构可预测
每个 Blockstudio区块都遵循相同的模式:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
这种一致性意味着,能够构建一个区块的智能体就能构建一百个。没有意外情况,没有特殊情况,也没有隐藏配置。页面(page.json + 模板)、模式(pattern.json + 模板)和扩展(extend.json)也都遵循相同的模式。
完整页面以文件形式存储
传统的 WordPress页面构建需要使用区块编辑器:拖动区块、配置设置,再通过管理后台保存。AI 智能体无法完成这些操作,它们需要文件。
Blockstudio的基于文件的页面彻底解决了这个问题。page.json定义页面元数据,index.php模板则使用 HTML定义区块结构:
pages/about/
├── page.json # Title, slug, post type, template lock
└── index.php # Block structure as HTML
<block name="core/cover" key="hero" url="https://example.com/bg.jpg">
<h1 blockEditingMode="contentOnly">About Us</h1>
<p blockEditingMode="contentOnly">Our story.</p>
</block>
<div key="team">
<h2>The Team</h2>
<block name="my/team-member" />
<block name="my/team-member" />
</div>
智能体只需编写两个文件,就能搭建完整的 WordPress页面,包括核心区块、自定义区块、模板锁定和编辑控件。运行 wp bs pages sync即可将源文件应用到 WordPress;打开管理后台不会自动执行同步。
这是 AI 辅助开发中最强大的功能之一。你无需描述页面布局后再手动在编辑器中拼装,只需向智能体描述需求,它就会编写模板。生成的结果可进行版本控制、可重复生成,也能在几秒内迭代更新。
无需构建步骤
无需编译、打包或转译。智能体创建文件后即可立即使用。SCSS在服务器端编译。ES 模块在运行时解析。Tailwind CSS在每次前端请求时编译。“智能体编写代码”到“代码在浏览器中运行”的反馈周期已经短到了极致。
为什么 Tailwind CSS是合适的选择
Blockstudio既支持常规的 CSS,也支持 Tailwind CSS,但在与 AI 智能体协作时,Tailwind有明显优势。
LLM 非常熟悉 Tailwind
Tailwind CSS广泛应用于数万个开源仓库,为 Claude.ai、Vercel、Shopify、Cursor 以及 OpenAI自家产品的界面提供支持。它在训练数据中十分常见,因此 LLM 能够准确生成 Tailwind类名,很少会臆造不存在的实用类。
类名词汇有限且定义明确。智能体无法臆造不存在的 CSS属性;与自由编写 CSS相比,这大幅减少了样式错误,因为自由编写时,智能体可能会生成无效选择器或误解层叠行为。
样式与标记同处一处
使用 Tailwind时,所有样式信息都与 HTML模板放在一起。智能体可以在一处看到元素完整的视觉描述,无需查阅单独的 .css文件、理解层叠顺序或追踪优先级冲突。
这对 Blockstudio区块尤其有用,因为模板本身就是一个独立文件。智能体可以一次性生成完整且带样式的组件:
<div useBlockProps class="bg-white rounded-2xl shadow-lg p-8">
<h2 class="text-2xl font-bold text-gray-900">
<?php echo $a['title']; ?>
</h2>
<p class="mt-4 text-gray-600 leading-relaxed">
<?php echo $a['description']; ?>
</p>
</div>
并行智能体互不冲突
由于 Tailwind样式限定在各自的模板中,多个智能体(或开发者)可以同时处理不同区块,而不会产生 CSS合并冲突。没有共享样式表,因此一个组件的修改不会意外破坏另一个组件。每个区块都是独立的。
使用常规 CSS和 Blockstudio的作用域样式(style.scoped.css)时,这种方式同样有效;但 Tailwind完全省去了 CSS文件,这意味着智能体每处理一个区块就少管理一个文件。
常规 CSS依然可用
Tailwind并非必需。Blockstudio的资源管线会自动处理 .css和 .scss文件,包括限定作用域并按区块划分命名空间的样式。如果你的项目采用其他 CSS方法,智能体也可以配合使用。Tailwind的优势在于训练数据覆盖面广,而且样式与标记同处一处,因此 LLM 更擅长处理它。
AI 编码智能体
以下 CLI工具都能开箱即用地处理 Blockstudio项目。它们可以读写文件、运行 shell 命令,并根据上下文文件理解项目结构。
终端智能体(CLI)
| 工具 | 提供方 | 备注 |
|---|---|---|
| Claude Code | Anthropic | 以终端为核心的智能体。读取 CLAUDE.md以了解项目上下文。 |
| Codex CLI | OpenAI | 使用 Rust构建的开源 CLI。也提供桌面应用。 |
| Gemini CLI | 开源,拥有 1M token 上下文窗口。读取 GEMINI.md。 |
|
| GitHub Copilot CLI | GitHub | 提供专用于探索、任务、规划和审查的并行智能体。 |
| Aider | 开源 | 支持 100+ 个 LLM 提供方,包括本地模型。 |
| OpenCode | 开源 | 带 LSP 集成的终端 TUI。支持 75+ 个提供方。 |
| Amazon Q Developer CLI | AWS | 提供免费套餐。适合与 AWS集成的项目。 |
IDE 智能体
| 工具 | 提供方 | 备注 |
|---|---|---|
| Cursor | Cursor | 基于 VS Code分叉并内置 AI。还提供 CLI(测试版)。 |
| Windsurf | Cognition AI | 基于 VS Code分叉,内置 Cascade 智能体助手。 |
| Cline | 开源 | VS Code扩展,支持逐步审批。还提供 CLI。 |
| Kilo Code | 开源 | 编排模式,可协调多个子智能体。 |
| Continue | 开源 | VS Code/JetBrains扩展,提供异步 CI/CD 智能体。 |
| Augment Code | Augment | 面向企业,提供深入的代码库索引。 |
所有这些工具都能在 Blockstudio项目目录中创建和编辑文件。终端智能体尤其适合这种场景,因为 Blockstudio开发不需要 IDE 专属功能,完全以文件为基础。
为 AI 智能体设置项目
LLM 上下文文件
Blockstudio自带一个预构建的上下文文件,其中索引了完整的框架文档。它不是摘要或速查表:每份文档只列出一次,并附有其路由、用途和所属标识符,因此智能体可以找到能回答问题的那一页,只打开该页面。另一个文件保留了每份文档和架构的完整文本,供需要一次获取全部内容的工具使用。
在你的 blockstudio.json中启用它:
{
"ai": {
"enableContextGeneration": true
}
}
现在,索引可通过 your-site.com/blockstudio-llm.txt访问,完整文本则位于 your-site.com/blockstudio-llm-full.txt。让 AI 工具读取索引,它就能在无需额外指令的情况下访问完整的 Blockstudio API。请参阅AI 集成文档,了解针对各类工具的设置方法。
这样就无需再自行编写针对特定框架的指令。能够访问 blockstudio-llm.txt的智能体可以查找如何创建区块、定义字段、编写模板、配置 Tailwind、设置页面,以及使用 Blockstudio提供的每个钩子。
项目专属上下文文件
大多数 AI 编码智能体还会读取项目级上下文文件,以获取针对代码库的专属指令。不同工具采用的约定各不相同:
| 文件 | 工具 |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI、Gemini CLI、Copilot CLI等 |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
由于 blockstudio-llm.txt已经涵盖了框架内容,你的项目上下文文件只需描述项目的独有信息:目录布局、命名约定、命令和边界。
如果安装了 blockstudio/phpstan,就不必手动编写这段说明。vendor/bin/blockstudio-agents会根据你的 blockstudio.json和项目文件生成 AGENTS.md,列出项目编写了哪些内容、启用了哪些功能、哪些分析会被拒绝,以及适用的命令。它不会覆盖自己未写入的文件,并且在重新生成时会保留你自己的备注。
# My WordPress Site
Built with Blockstudio 7. File-based blocks with Tailwind CSS.
Fetch https://example.com/blockstudio-llm.txt for full framework docs.
## Structure
- `blockstudio/` - Custom blocks (block.json + index.php)
- `pages/` - File-based pages (page.json + index.php)
- `patterns/` - Block patterns (pattern.json + index.php)
- `blockstudio.json` - Plugin settings
## Conventions
- Use Tailwind utility classes for all styling
- Keep blocks small and focused: one component per block
- Use `$a['fieldId']` to access field values in templates
## Commands
- `wp server` - Start local development server
面向 AI 工作流的开发者工具
Blockstudio包含两个专为 AI 辅助开发设计的开发者工具。
画布
Canvas以类似 Figma的方式概览所有 Blockstudio页面,将它们作为实时 iframe 画板呈现在同一视图中。使用触控板平移,或通过捏合和 Ctrl+滚动缩放。
对于 AI 智能体协作而言,这很有用:无需切换标签页或浏览 WordPress管理后台,就能直观查看所有页面。智能体修改页面模板后,你可以立即看到结果。启用实时模式后,每当文件发生变化,Canvas 都会自动刷新。
在 blockstudio.json中启用:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
然后前往 /wp-admin/admin.php?page=blockstudio-canvas。你可以在页面视图(全宽画板)和区块视图(展示所有已注册区块及默认值的网格)之间切换。
元素抓取器
元素抓取器解决了 AI 工作流中的一个常见问题:如何告诉智能体页面上的某个元素由哪个文件渲染。
在任何前端 URL后附加 ?blockstudio-devtools,然后按住 Cmd+C(Mac)或 Ctrl+C(Windows)100ms。此时会启用十字准星选择器,悬停时会高亮显示 Blockstudio区块。点击元素即可将其上下文复制到剪贴板:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
将内容粘贴到 AI 编码工具中后,智能体会立即知道文件路径、HTML结构,以及你所指向的元素。无需再手动查找模板文件路径。
在 blockstudio.json中启用:
{
"dev": {
"grab": {
"enabled": true
}
}
}
实用模式
构建单个区块
最简单的工作流:描述你的需求,然后让智能体创建。
提示词:
创建一个推荐语区块,包含以下字段:引言(textarea)、作者姓名 (text)、作者职位(text)和作者照片(files)。使用 Tailwind设置 样式。引言使用大号斜体字,并配上装饰性引号。
智能体将创建:
blockstudio/testimonial/
├── block.json
└── index.php
构建完整页面
Blockstudio的基于文件的页面使智能体能够将完整的 WordPress页面搭建为模板。这正是它真正发挥作用的地方:智能体无需逐个构建区块,而是一次性创建包含所有区块的完整页面结构。
提示词:
创建一个“关于”页面,包含主视觉区域、团队网格和联系表单 占位符。尽可能使用现有区块,需要时再编写新区块。将其固定到文章 ID 2。 锁定模板,但允许编辑标题和段落内容。
智能体将创建:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
此外还会创建引用到的任何自定义区块(e.g、blockstudio/team-member/)。运行
wp bs pages sync以创建带有模板锁定和编辑控件的 WordPress文章。整个页面都可进行版本控制,并能重复生成。
构建完整网站
Blockstudio的架构在这里大放异彩。只需一个提示词就能生成整个网站,因为每项内容都是一个文件:
提示词:
构建一个作品集网站,包含这些页面:主页、作品、关于、联系。 创建以下自定义区块:主视觉区域、项目网格、项目卡片、 团队成员、联系信息和页脚。使用深色主题和 Tailwind。 在 blockstudio.json中配置 Tailwind,并设置自定义调色板。
智能体会创建区块目录、页面模板、带有 Tailwind配置的 blockstudio.json,还可以为可重复使用的版块创建模式。所有内容都会作为一个变更集提交到 git。
并行智能体工作流
某些工具(Codex桌面应用、GitHub Copilot CLI、Kilo Code)支持并行运行多个智能体。Blockstudio按区块分别存放文件的架构让这种做法十分安全:
- 智能体 1:构建主视觉区块和主页
- 智能体 2:构建项目卡片区块和作品页
- 智能体 3:构建联系表单区块和联系页
由于每个区块都有自己的目录,且 Tailwind样式与模板放在一起,这些智能体不会互相冲突。唯一的共享文件是 blockstudio.json,通常只需在开始时设置一次。
获取更好结果的技巧
-
引用 LLM 上下文文件。 能访问框架文档时,智能体生成的 Blockstudio代码会好得多。务必让它们读取
blockstudio-llm.txt,并为项目本身提供生成的AGENTS.md。 -
明确指定字段类型。 不要只说“添加一个图像字段”,而要说“添加一个包含
allowedTypes: ['image']和returnFormat: 'object'的 files 字段”。字段定义越精确,需要的迭代就越少。 -
从一个区块开始,再逐步扩展。 先让智能体正确构建一个区块,检查其模式,然后让它遵循相同约定构建其余区块。这样能建立一个参考范例,改善后续输出。
-
检查生成结果。 氛围编程不代表盲目接受代码。检查字段类型是否符合预期、模板能否正确渲染,以及 Tailwind类是否呈现出正确的视觉效果。发布前应审查 AI 生成的代码。
-
使用
block.json架构。 Blockstudio在https://blockstudio.dev/schema/block提供 JSON Schema。在你的 block.json中添加"$schema",即可为智能体提供验证反馈,避免生成格式错误的配置。 -
让区块保持小巧且专注。 每个视觉组件对应一个区块。这样智能体更容易理解每个区块,也能让模板足够精简,在一次上下文窗口处理中容纳完整内容。