跳转到正文

使用 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
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区块尤其有用,因为模板本身就是一个独立文件。智能体可以一次性生成完整且带样式的组件:

PHP
<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 Google 开源,拥有 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中启用它:

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,列出项目编写了哪些内容、启用了哪些功能、哪些分析会被拒绝,以及适用的命令。它不会覆盖自己未写入的文件,并且在重新生成时会保留你自己的备注。

Markdown
# 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中启用:

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中启用:

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,通常只需在开始时设置一次。

获取更好结果的技巧

  1. 引用 LLM 上下文文件。 能访问框架文档时,智能体生成的 Blockstudio代码会好得多。务必让它们读取 blockstudio-llm.txt,并为项目本身提供生成的 AGENTS.md。

  2. 明确指定字段类型。 不要只说“添加一个图像字段”,而要说“添加一个包含 allowedTypes: ['image']和 returnFormat: 'object'的 files 字段”。字段定义越精确,需要的迭代就越少。

  3. 从一个区块开始,再逐步扩展。 先让智能体正确构建一个区块,检查其模式,然后让它遵循相同约定构建其余区块。这样能建立一个参考范例,改善后续输出。

  4. 检查生成结果。 氛围编程不代表盲目接受代码。检查字段类型是否符合预期、模板能否正确渲染,以及 Tailwind类是否呈现出正确的视觉效果。发布前应审查 AI 生成的代码。

  5. 使用 block.json架构。 Blockstudio在 https://blockstudio.dev/schema/block提供 JSON Schema。在你的 block.json中添加 "$schema",即可为智能体提供验证反馈,避免生成格式错误的配置。

  6. 让区块保持小巧且专注。 每个视觉组件对应一个区块。这样智能体更容易理解每个区块,也能让模板足够精简,在一次上下文窗口处理中容纳完整内容。