Pāriet uz saturu

Vibekodēšana ar Blockstudio

Andrej Karpathy 2025. gada februārī 2025 ieviesa terminu “vibe coding”, lai aprakstītu darba procesu, kurā jūs pastāstāt MI, ko vēlaties, un tas uzraksta kodu. Gadu vēlāk šī prakse ir attīstījusies par to, ko viņš tagad dēvē par “agentic engineering”: izstrādātāji vada MI aģentus, nevis raksta kodu rindiņu pa rindiņai.

Blockstudio ir radīts šim nolūkam. Tā failos balstītā arhitektūra, būvēšanas rīku neesamība un paredzamā projekta struktūra padara to par vienu no labākajām vidēm MI atbalstītai WordPress izstrādei.

Šajā ceļvedī aplūkoti praktiski paņēmieni, kā izmantot MI koda aģentus ar Blockstudio — no projekta iestatīšanas līdz pilnas vietnes ģenerēšanai.

Kāpēc Blockstudio labi darbojas ar MI aģentiem

Faili, nevis datubāzes

MI koda aģenti lasa un raksta failus. Tā ir to galvenā saskarne. Blockstudio visu glabā failu sistēmā: block.json un veidnes failu katram blokam, page.json katrai lapai, pattern.json katram rakstam. Nav jāveido datubāzes ieraksti, jāpārlūko administrācijas UI vai jāpalaiž būvēšanas process.

Tas ir svarīgi, jo failu sistēmas un čaulas komandas ir viens no lielākajiem LLM pirmsapmācības datu avotiem. Ikviens modelis ir redzējis miljoniem piemēru failu lasīšanai, rakstīšanai un kārtošanai. Ja jūsu WordPress izstrādes darba process atbilst šai saskarnei, aģenti var strādāt ar minimāliem norādījumiem.

Paredzama struktūra

Katrs Blockstudio bloks veidots pēc viena un tā paša parauga:

Kods
my-block/
├── block.json    # Configuration + fields
├── index.php     # Template
└── style.css     # Styles (optional)

Šī konsekvence nozīmē, ka aģents, kurš izveidojis vienu bloku, var izveidot arī simt. Nav pārsteigumu, īpašu gadījumu vai slēptas konfigurācijas. Tas pats paraugs attiecas uz lapām (page.json + veidne), rakstiem (pattern.json + veidne) un paplašinājumiem (extend.json).

Pilnas lapas kā faili

Tradicionālai WordPress lapu veidošanai nepieciešams bloku redaktors: bloku vilkšana, iestatījumu konfigurēšana un saglabāšana administrācijas panelī. MI aģenti to nevar paveikt. Tiem vajadzīgi faili.

Blockstudio’s lapas, kuru pamatā ir faili, atrisina šo problēmu pilnībā. page.json definē lapas metadatus, bet index.php veidne nosaka bloku struktūru, izmantojot HTML:

Kods
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>

Aģents var izveidot visu WordPress lapas sākotnējo struktūru ar pamata blokiem, pielāgotajiem blokiem, veidnes bloķēšanu un rediģēšanas vadīklām, uzrakstot tikai divus failus. Palaidiet wp bs pages sync, lai lietotu avotu WordPress; atverot administrācijas paneli, šī sinhronizācija netiek veikta automātiski.

Šī ir viena no jaudīgākajām MI atbalstītas izstrādes funkcijām. Tā vietā, lai aprakstītu lapas izkārtojumu un manuāli to veidotu redaktorā, jūs to aprakstāt aģentam, un tas uzraksta veidni. Rezultāts tiek versiju kontrolēts, ir reproducējams un to var uzlabot dažu sekunžu laikā.

Nav būvēšanas procesa

Nekas nav jākompilē, jāapvieno paketē vai jāpārveido. Aģents izveido failu, un tas uzreiz darbojas. SCSS tiek kompilēts servera pusē. ES moduļi tiek atrisināti izpildes laikā. Tailwind CSS tiek kompilēts ar katru priekšgala pieprasījumu. Atgriezeniskā saite starp “aģents raksta kodu” un “kods darbojas pārlūkā” ir maksimāli ātra.

Kāpēc izvēlēties Tailwind CSS

Blockstudio atbalsta gan parasto CSS, gan Tailwind CSS, taču Tailwind ir būtiska priekšrocība darbā ar MI aģentiem.

LLM ļoti labi pārzina Tailwind

Tailwind CSS tiek izmantots desmitiem tūkstošu atvērtā pirmkoda repozitoriju. Ar to veidotas Claude.ai, Vercel, Shopify, Cursor un paša OpenAI produktu saskarnes. Šī plašā izplatība apmācības datos ļauj LLM ļoti precīzi ģenerēt Tailwind klases un reti izdomāt neesošas utilītas.

Klases vārdu krājums ir ierobežots un skaidri definēts. Aģents nevar izdomāt neesošu CSS īpašību, tādējādi ievērojami samazinot stila kļūdu skaitu, salīdzinot ar brīvi rakstītu CSS, kur aģents varētu ģenerēt nederīgus selektorus vai nepareizi izprast kaskādes darbību.

Stili atrodas marķējumā

Izmantojot Tailwind, visa informācija par stiliem atrodas HTML veidnē. Aģents vienuviet redz pilnu elementa vizuālo aprakstu. Nav jāmeklē saistītā informācija atsevišķos .css failos, jāizprot kaskādes secība vai jāseko specifiskuma konfliktiem.

Tas ir īpaši noderīgi Blockstudio blokiem, kuru veidne jau ir vienā failā. Aģents vienā piegājienā var ģenerēt pilnīgu, stilizētu komponentu:

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>

Vairāki aģenti paralēli bez konfliktiem

Tā kā Tailwind stili ir ierobežoti katrai veidnei, vairāki aģenti (vai izstrādātāji) var vienlaikus strādāt ar dažādiem blokiem, neradot CSS sapludināšanas konfliktus. Nav kopīgas stilu lapas, kur izmaiņas vienā komponentā nejauši sabojātu citu. Katrs bloks ir pašpietiekams.

Tas labi darbojas arī ar parasto CSS, izmantojot Blockstudio tvērumā ierobežotos stilus (style.scoped.css), taču Tailwind pilnībā novērš nepieciešamību pēc CSS faila, kas nozīmē, ka aģentam katram blokam jāpārvalda par vienu failu mazāk.

Arī parastais CSS darbojas

Tailwind nav obligāts. Blockstudio līdzekļu apstrādes cauruļvads automātiski apstrādā .css un .scss failus, tostarp tvērumā ierobežotus stilus, kas piesaistīti blokam. Ja jūsu projektā tiek izmantota cita CSS metodika, arī ar to aģenti var strādāt. Tailwind priekšrocība ir tā, ka LLM to labāk pārzina apmācības datu pārklājuma un stilu izvietojuma līdzās marķējumam dēļ.

MI koda aģenti

Visi tālāk minētie CLI rīki uzreiz var darboties ar Blockstudio projektiem. Tie lasa un raksta failus, palaiž čaulas komandas un izprot projekta struktūru, izmantojot konteksta failus.

Termināļa aģenti (CLI)

Rīks Nodrošinātājs Piezīmes
Claude Code Anthropic Terminālim paredzēts aģents. Nolasa CLAUDE.md, lai iegūtu projekta kontekstu.
Codex CLI OpenAI Atvērtā pirmkoda CLI, kas veidots ar Rust. Pieejams arī kā darbvirsmas lietotne.
Gemini CLI Google Atvērtais pirmkods un 1M tokenu konteksta logs. Nolasa GEMINI.md.
GitHub Copilot CLI GitHub Specializēti paralēli aģenti izpētei, uzdevumiem, plānošanai un pārskatīšanai.
Aider Atvērtais pirmkods Atbalsta 100+ LLM nodrošinātājus, tostarp lokālos modeļus.
OpenCode Atvērtais pirmkods Termināļa TUI ar LSP integrāciju. Atbalsta vairāk nekā 75 nodrošinātājus.
Amazon Q Developer CLI AWS Pieejams bezmaksas plāns. Piemērots projektiem ar AWS integrāciju.

IDE aģenti

Rīks Nodrošinātājs Piezīmes
Cursor Cursor VS Code atzars ar iebūvētu MI. Ir arī CLI (beta versija).
Windsurf Cognition AI VS Code atzars ar Cascade aģentisko asistentu.
Cline Atvērtais pirmkods VS Code paplašinājums ar pakāpenisku apstiprināšanu. Ir arī CLI.
Kilo Code Atvērtais pirmkods Orķestrētāja režīms ar koordinētiem apakšaģentiem.
Continue Atvērtais pirmkods VS Code/JetBrains paplašinājums ar asinhroniem CI/CD aģentiem.
Augment Code Augment Uzņēmumiem paredzēts rīks ar padziļinātu koda bāzes indeksēšanu.

Visi šie rīki var izveidot un rediģēt failus Blockstudio projekta direktorijā. Termināļa aģenti ir īpaši piemēroti, jo Blockstudio izstrādei nav nepieciešamas IDE specifiskas funkcijas: tā pilnībā balstās failos.

Projekta sagatavošana MI aģentiem

LLM konteksta fails

Blockstudio komplektā ir sagatavots konteksta fails, kurā indeksēta visa ietvara dokumentācija. Tas nav kopsavilkums vai īsa rokasgrāmata: katrs dokuments ir norādīts vienreiz kopā ar tā maršrutu, mērķi un tam piederošajiem identifikatoriem, lai aģents varētu atrast vajadzīgo lapu un atvērt tikai to. Otrā failā pieejams visu dokumentu un shēmu pilns teksts rīkiem, kuriem uzreiz nepieciešams viss korpuss.

Iespējojiet to savā blockstudio.json:

JSON
{
  "ai": {
    "enableContextGeneration": true
  }
}

Indekss tagad pieejams vietnē your-site.com/blockstudio-llm.txt, bet pilns teksts — vietnē your-site.com/blockstudio-llm-full.txt. Norādiet MI rīkam indeksu, un tas varēs piekļūt visam Blockstudio API bez papildu norādījumiem. Skatiet MI integrācijas dokumentāciju, lai uzzinātu, kā iestatīt konkrētus rīkus.

Tādējādi vairs nav pašam jāraksta ietvaram pielāgoti norādījumi. Aģents ar piekļuvi blockstudio-llm.txt var atrast informāciju par bloku izveidi, lauku definēšanu, veidņu rakstīšanu, Tailwind konfigurēšanu, lapu iestatīšanu un visu Blockstudio nodrošināto āķu izmantošanu.

Projektam pielāgoti konteksta faili

Vairums MI koda aģentu nolasa arī projekta līmeņa konteksta failu ar jūsu koda bāzei paredzētiem norādījumiem. Katram rīkam ir sava failu nosaukumu konvencija:

Fails Rīks
CLAUDE.md Claude Code
AGENTS.md Codex CLI, Gemini CLI, Copilot CLI un citi
.cursor/rules/*.mdc Cursor
.github/copilot-instructions.md GitHub Copilot

Tā kā blockstudio-llm.txt jau apraksta ietvaru, projekta konteksta failā jānorāda tikai tas, kas raksturīgs tieši jūsu projektam: direktoriju struktūra, nosaukumu konvencijas, komandas un ierobežojumi.

Ja instalēsiet blockstudio/phpstan, šis apraksts nebūs jāraksta pašam. vendor/bin/blockstudio-agents no blockstudio.json un jūsu failiem ģenerē AGENTS.md, kurā norādīts, ko projekts izstrādā, kuras funkcijas ir iespējotas, ko analīze noraidīs un kādas komandas jāizmanto. Šis rīks atsakās pārrakstīt failu, ko nav izveidojis, un, to ģenerējot atkārtoti, saglabā jūsu piezīmes.

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

Izstrādātāju rīki MI darba procesiem

Blockstudio piedāvā divus izstrādātāju rīkus, kas īpaši paredzēti MI atbalstītai izstrādei.

Canvas

Canvas ir Figma līdzīgs visu jūsu Blockstudio lapu pārskats, kurā tie attēloti kā dzīvas iframe laukumi vienā skatā. Panoramējiet ar skārienpaliktni un tuviniet vai tāliniet, savelkot pirkstus vai ritinot ar Ctrl.

Tas noder darbā ar MI aģentiem, jo sniedz visu lapu vizuālu pārskatu, nepārslēdzot cilnes vai nepārlūkojot WordPress administrācijas paneli. Kad aģents maina lapas veidni, rezultātu var uzreiz redzēt. Iespējojiet tiešsaistes režīmu, un Canvas automātiski atsvaidzinās, kad mainīsies faili.

Iespējojiet to vietnē blockstudio.json:

JSON
{
  "dev": {
    "canvas": {
      "enabled": true,
      "adminBar": false
    }
  }
}

Pēc tam dodieties uz /wp-admin/admin.php?page=blockstudio-canvas. Pārslēdzieties starp lapu skatu (pilna platuma laukumi) un bloku skatu (reģistrēto bloku režģis ar noklusējuma vērtībām).

Element Grabber

elementu atlasītājs atrisina bieži sastopamu problēmu MI darba procesos: kā aģentam norādīt, kurš fails attēlo konkrētu elementu lapā.

Pievienojiet ?blockstudio-devtools jebkuram priekšgala URL, pēc tam turiet nospiestu Cmd+C (Mac) vai Ctrl+C (Windows) 100ms. Tiks aktivizēts krustiņa atlasītājs, kas, virzot kursoru, izcels Blockstudio blokus. Noklikšķiniet uz elementa, lai kopētu tā kontekstu starpliktuvē:

Kods
@<div>

<div class="my-block">
  Hello world
</div>
  in theme-name/blockstudio/blocks/my-block/index.php

Ielīmējiet to savā MI koda rīkā, un aģents uzreiz uzzinās faila ceļu, HTML struktūru un elementu, uz kuru norādāt. Vairs nebūs manuāli jāmeklē veidņu failu ceļi.

Iespējojiet to vietnē blockstudio.json:

JSON
{
  "dev": {
    "grab": {
      "enabled": true
    }
  }
}

Praktiski paņēmieni

Viena bloka izveide

Vienkāršākais darba process: aprakstiet, ko vēlaties, un ļaujiet aģentam to izveidot.

Uzvedne:

Izveidojiet atsauksmes bloku ar laukiem citātam (textarea), autora vārdam (text), autora amatam (text) un autora fotoattēlam (files). Stilu veidošanai izmantojiet Tailwind. Citātam jābūt lielā, slīprakstā rakstītā fontā ar dekoratīvu pēdiņu.

Aģents izveidos:

Kods
blockstudio/testimonial/
├── block.json
└── index.php

Pilnas lapas izveide

Blockstudio’s lapas, kuru pamatā ir faili, ļauj aģentam izveidot visas WordPress lapas sākotnējo struktūru kā veidni. Te atklājas patiesais ieguvums: tā vietā, lai veidotu blokus pa vienam, aģents vienā piegājienā izveido pilnu lapas struktūru ar visiem blokiem.

Uzvedne:

Izveidojiet lapu “Par mums” ar ievada sadaļu, komandas režģi un vietturi kontaktu veidlapai. Kur iespējams, izmantojiet esošos blokus, bet vajadzības gadījumā izveidojiet jaunus. Piesaistiet to ziņas ID 2. Bloķējiet veidni, bet ļaujiet rediģēt virsrakstus un rindkopas.

Aģents izveido:

Kods
pages/about/
├── page.json     # postId: 2, templateLock: "all"
└── index.php     # Full block structure with core + custom blocks

Kā arī visus tajā norādītos pielāgotos blokus (e.g., blockstudio/team-member/). Palaidiet wp bs pages sync, lai izveidotu WordPress ziņu ar veidnes bloķēšanu un rediģēšanas vadīklām. Visa lapa tiek versiju kontrolēta un ir reproducējama.

Pilnas vietnes izveide

Šeit patiesi izpaužas Blockstudio arhitektūras priekšrocības. Ar vienu uzvedni var ģenerēt visu vietni, jo katrs elements ir fails:

Uzvedne:

Izveidojiet portfolio vietni ar šādām lapām: Sākums, Darbi, Par mums, Kontakti. Izveidojiet pielāgotus blokus ievada sadaļai, projektu režģim, projekta kartei, komandas dalībniekam, kontaktinformācijai un kājenei. Izmantojiet tumšu tēmu ar Tailwind. Konfigurējiet Tailwind vietnē blockstudio.json, izmantojot pielāgotu krāsu paleti.

Aģents izveido bloku direktorijus, lapu veidnes, blockstudio.json ar Tailwind konfigurāciju un, ja nepieciešams, atkārtoti izmantojamu sadaļu rakstus. Viss tiek iesniegts git kā viena izmaiņu kopa.

Paralēlu aģentu darba procesi

Daži rīki (Codex darbvirsmas lietotne, GitHub Copilot CLI, Kilo Code) atbalsta vairāku aģentu paralēlu darbību. Blockstudio arhitektūra, kurā katram blokam ir savs fails, padara to drošu:

  • 1. aģents: izveido ievada bloku un sākumlapu
  • 2. aģents: izveido projekta kartes bloku un darbu lapu
  • 3. aģents: izveido kontaktformas bloku un kontaktu lapu

Tā kā katram blokam ir savs direktorijs un Tailwind stili atrodas veidnēs līdzās marķējumam, šie aģenti neradīs konfliktus. Vienīgais koplietotais fails ir blockstudio.json, kas parasti jāiestata tikai vienreiz, darba sākumā.

Ieteikumi labākiem rezultātiem

  1. Norādiet uz LLM konteksta failu. Aģenti izveido ievērojami labāku Blockstudio kodu, ja tiem ir pieejama ietvara dokumentācija. Vienmēr norādiet uz blockstudio-llm.txt un izveidojiet arī projekta AGENTS.md.

  2. Precizējiet lauku tipus. Tā vietā, lai teiktu “pievienojiet attēla lauku”, sakiet “pievienojiet files lauku ar allowedTypes: ['image'] un returnFormat: 'object'”. Jo precīzāk definēsiet laukus, jo mazāk reižu būs jāveic labojumi.

  3. Sāciet ar vienu bloku, pēc tam paplašiniet darbu. Ļaujiet aģentam pareizi izveidot vienu bloku, pārskatiet tā paraugus un pēc tam lūdziet izveidot pārējos, ievērojot tās pašas konvencijas. Tādējādi rodas paraugs, kas uzlabo turpmākos rezultātus.

  4. Pārskatiet rezultātu. Vibe coding nenozīmē akli pieņemt kodu. Pārbaudiet, vai lauku tipi atbilst jūsu iecerei, veidnes tiek attēlotas pareizi un Tailwind klases rada vajadzīgo vizuālo rezultātu. Pirms publicēšanas ir jāpārskata MI ģenerētais kods.

  5. Izmantojiet block.json shēmas. Blockstudio piedāvā JSON shēmu vietnē https://blockstudio.dev/schema/block. Pievienojot "$schema" savam block.json, aģenti saņems validācijas atsauksmes un izvairīsies no kļūdainām konfigurācijām.

  6. Veidojiet mazus un mērķtiecīgus blokus. Katram vizuālajam komponentam paredziet vienu bloku. Tādējādi aģentam būs vieglāk izprast katru bloku un veidnes būs pietiekami īsas, lai tās ietilptu vienā konteksta loga piegājienā.