Vibekodavimas su Blockstudio
Andrej Karpathy 2025 m. vasarį 2025 sugalvojo terminą „vibe coding“ – taip apibūdino darbo eigą, kai nurodote DI, ko norite, o jis parašo kodą. Po metų ši praktika ištobulėjo į tai, ką jis dabar vadina „agentine inžinerija“: kūrėjai koordinuoja DI agentus, užuot rašę kodą eilutė po eilutės.
Blockstudio tam ir sukurta. Failais pagrįsta architektūra, jokių kūrimo įrankių ir nuspėjama projekto struktūra paverčia ją viena geriausių aplinkų DI padedamai WordPress plėtrai.
Šiame vadove aptariami praktiniai AI programavimo agentų naudojimo su Blockstudio būdai – nuo projekto parengimo iki visos svetainės generavimo.
Kodėl Blockstudio puikiai tinka AI agentams
Failai, ne duomenų bazės
AI programavimo agentai skaito ir rašo failus. Tai pagrindinė jų sąsaja. Blockstudio viską laiko failų sistemoje: po block.json ir šablono failą kiekvienam blokui, po page.json kiekvienam puslapiui, po pattern.json kiekvienam šablonui. Nereikia tvarkyti duomenų bazės įrašų, naršyti administravimo UI ar vykdyti kūrimo etapo.
Tai svarbu, nes failų sistemos ir apvalkalo komandos yra vieni didžiausių LLM išankstinio mokymo duomenų šaltinių. Kiekvienas modelis matė milijonus failų skaitymo, rašymo ir tvarkymo pavyzdžių. Kai jūsų WordPress kūrimo darbo eiga atitinka šią sąsają, agentams pakanka minimalių nurodymų.
Nuspėjama struktūra
Kiekvienas Blockstudio blokas kuriamas pagal tą patį šabloną:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
Dėl tokio nuoseklumo agentas, sukūręs vieną bloką, gali sukurti ir šimtą. Jokių netikėtumų, išimčių ar paslėptos konfigūracijos. Tas pats principas taikomas puslapiams (page.json + šablonas), šablonams (pattern.json + šablonas) ir plėtiniams (extend.json).
Visi puslapiai – failuose
Tradiciniam WordPress puslapių kūrimui reikia blokų redaktoriaus: vilkti blokus, konfigūruoti nustatymus, išsaugoti per administravimo aplinką. AI agentai to padaryti negali. Jiems reikia failų.
Blockstudio failais pagrįsti puslapiai visiškai išsprendžia šią problemą. page.json aprašo puslapio metaduomenis, o index.php šablonas blokų struktūrą aprašo naudodamas 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>
Agentas gali sukurti visą WordPress puslapio karkasą su pagrindiniais ir pasirinktiniais blokais, šablono užrakinimu bei redagavimo valdikliais – užtenka parašyti du failus. Paleiskite wp bs pages sync, kad pritaikytumėte šaltinį WordPress; atidarius administravimo aplinką šis sinchronizavimas nevyksta automatiškai.
Tai viena galingiausių DI padedamos plėtros funkcijų. Užuot aprašę puslapio išdėstymą ir rankomis surinkę jį redaktoriuje, aprašote jį agentui, o šis parašo šabloną. Rezultatas yra versijuojamas, atkuriamas ir gali būti per kelias sekundes pakartotinai tobulinamas.
Nereikia kūrimo etapo
Nėra ko kompiliuoti, pakuoti ar transpiliuoti. Agentas sukuria failą, ir jis iškart veikia. SCSS kompiliuojama serverio pusėje. ES moduliai išsprendžiami vykdymo metu. Tailwind CSS kompiliuojama su kiekviena užklausa iš priekinės dalies. Ciklas nuo „agentas parašo kodą“ iki „kodas veikia naršyklėje“ yra kuo trumpesnis.
Kodėl verta rinktis Tailwind CSS
Blockstudio palaiko ir įprastą CSS, ir Tailwind CSS, tačiau dirbant su AI agentais Tailwind turi reikšmingą pranašumą.
LLM puikiai išmano Tailwind
Tailwind CSS naudojama dešimtyse tūkstančių atvirojo kodo saugyklų. Ji veikia Claude.ai, Vercel, Shopify, Cursor ir pačios OpenAI produktų sąsajose. Kadangi jos daug mokymo duomenyse, LLM labai tiksliai generuoja Tailwind klases ir retai prigalvoja neegzistuojančių paslaugų.
Klasių žodynas yra baigtinis ir aiškiai apibrėžtas. Agentas negali sugalvoti neegzistuojančios CSS savybės, todėl stiliaus klaidų pasitaiko gerokai mažiau nei naudojant laisvos formos CSS, kai agentas gali sugeneruoti netinkamus selektorius arba klaidingai suprasti kaskados veikimą.
Stiliai apraše
Naudojant Tailwind, visa stiliaus informacija pateikiama kartu su HTML šablonu. Agentas vienoje vietoje mato visą elemento vizualinį aprašą. Nereikia ieškoti informacijos atskiruose .css failuose, suprasti kaskados tvarkos ar sekti specifiškumo konfliktų.
Tai ypač naudinga Blockstudio blokams, kurių šablonas jau yra viename faile. Agentas vienu kartu gali sugeneruoti visą suformatuotą komponentą:
<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>
Agentai gali dirbti lygiagrečiai be konfliktų
Kadangi Tailwind stiliai apriboti kiekvienu šablonu, keli agentai (ar kūrėjai) gali vienu metu dirbti su skirtingais blokais be CSS sujungimo konfliktų. Nėra bendro stilių lapo, kuriame vieno komponento pakeitimai netyčia sugadintų kitą. Kiekvienas blokas yra savarankiškas.
Tai tinka ir įprastam CSS, kai naudojami Blockstudio apriboti stiliai (style.scoped.css), tačiau Tailwind visiškai pašalina CSS failą, todėl agentui reikia tvarkyti vienu failu mažiau kiekvienam blokui.
Įprastas CSS taip pat tinka
Tailwind nėra būtina. Blockstudio išteklių apdorojimo sistema automatiškai tvarko .css ir .scss failus, įskaitant stilius, apribotus bloko vardų erdve. Jei projekte taikoma kita CSS metodika, agentai gali dirbti ir su ja. Tailwind pranašumas tik tas, kad LLM ją geriau išmano dėl mokymo duomenų aprėpties ir kartu su aprašu pateikiamų stilių.
AI programavimo agentai
Visi šie CLI įrankiai gali iškart veikti su Blockstudio projektais. Jie skaito ir rašo failus, vykdo apvalkalo komandas ir pagal konteksto failus supranta projekto struktūrą.
Terminalo agentai (CLI)
| Įrankis | Tiekėjas | Pastabos |
|---|---|---|
| Claude Code | Anthropic | Agentas, pirmiausia skirtas terminalui. Projekto kontekstą skaito iš CLAUDE.md. |
| Codex CLI | OpenAI | Atvirojo kodo CLI, sukurta naudojant Rust. Taip pat yra darbalaukio programa. |
| Gemini CLI | Atvirojo kodo įrankis su 1M žetonų konteksto langu. Skaito GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | Specializuoti lygiagretūs agentai tyrinėjimui, užduotims, planavimui ir peržiūrai. |
| Aider | Atvirojo kodo | Palaiko 100+ LLM tiekėjų, įskaitant vietinius modelius. |
| OpenCode | Atvirojo kodo | Terminalo TUI su LSP integracija. Palaiko 75+ tiekėjus. |
| Amazon Q Developer CLI | AWS | Yra nemokamas planas. Puikiai tinka projektams, integruotiems su AWS. |
IDE agentai
| Įrankis | Tiekėjas | Pastabos |
|---|---|---|
| Cursor | Cursor | VS Code atšaka su integruotu DI. Taip pat turi CLI (beta). |
| Windsurf | Cognition AI | VS Code atšaka su Cascade agentiniu asistentu. |
| Cline | Atvirojo kodo | VS Code plėtinys su nuosekliu patvirtinimu. Taip pat turi CLI. |
| Kilo Code | Atvirojo kodo | Koordinuotų antrinių agentų orkestravimo režimas. |
| Tęsti | Atvirojo kodo | VS Code/JetBrains plėtinys su asinchroniniais CI/CD agentais. |
| Augment Code | Augment | Skirtas įmonėms, turi išsamų kodo bazės indeksavimą. |
Visi šie įrankiai gali kurti ir redaguoti failus Blockstudio projekto kataloge. Terminalo agentai ypač tinka, nes Blockstudio kūrimui nereikia konkrečių IDE funkcijų – viskas paremta failais.
Projekto parengimas AI agentams
LLM konteksto failas
Blockstudio pateikiamas iš anksto paruoštas konteksto failas, kuriame suindeksuota visa karkaso dokumentacija. Tai ne santrauka ar trumpa atmintinė: kiekvienas dokumentas išvardytas po vieną kartą, nurodant jo maršrutą, paskirtį ir jam priklausančius identifikatorius, kad agentas galėtų rasti atsakymą pateikiantį puslapį ir atverti tik jį. Visas kiekvieno dokumento ir schemos tekstas pateikiamas antrame faile, kurį gali naudoti įrankiai, norintys iškart gauti visą turinį.
Įjunkite tai savo blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
Indeksas dabar pasiekiamas adresu your-site.com/blockstudio-llm.txt, o visas tekstas – your-site.com/blockstudio-llm-full.txt. Nurodykite AI įrankiui indeksą, ir jis galės pasiekti visą Blockstudio API be papildomų nurodymų. Konkretaus įrankio parengimą rasite DI integravimo dokumentacijoje.
Taip nebereikia patiems rašyti konkrečiam karkasui skirtų nurodymų. Agentas, turintis prieigą prie blockstudio-llm.txt, gali sužinoti, kaip kurti blokus, apibrėžti laukus, rašyti šablonus, konfigūruoti Tailwind, nustatyti puslapius ir naudoti visas Blockstudio teikiamas funkcijas.
Konkretaus projekto konteksto failai
Dauguma AI programavimo agentų taip pat skaito projekto lygmens konteksto failą, kuriame pateikiami jūsų kodo bazei skirti nurodymai. Įprastas failas priklauso nuo įrankio:
| Failas | Įrankis |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI, Gemini CLI, Copilot CLI ir kiti |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
Kadangi blockstudio-llm.txt jau aprašo karkasą, jūsų projekto konteksto faile tereikia nurodyti, kas būdinga būtent jūsų projektui: katalogų išdėstymą, pavadinimų taisykles, komandas ir apribojimus.
Įdiegus blockstudio/phpstan, šio aprašo nereikės rašyti rankomis. vendor/bin/blockstudio-agents pagal jūsų blockstudio.json ir failus sukuria AGENTS.md, kuriame išvardija, ką projektas kuria, kurios funkcijos įjungtos, ką atmes analizė ir kokios komandos taikomos. Įrankis neperrašo failo, kurio pats nesukūrė, o generuodamas iš naujo išsaugo jūsų pastabas.
# 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
Kūrėjų įrankiai AI darbo eigoms
Blockstudio apima du specialiai DI padedamai plėtrai sukurtus kūrėjų įrankius.
Canvas
canvas – tai Figma tipo visų jūsų Blockstudio puslapių apžvalga, kurioje viename rodinyje pateikiamos tiesioginės iframe darbo sritys. Slinkite jutikliniu kilimėliu, mastelį keiskite suėmę pirštais arba naudodami Ctrl+scroll.
Tai naudinga dirbant su AI agentais, nes leidžia vizualiai peržiūrėti kiekvieną puslapį nekeičiant kortelių ar nenaršant WordPress administravimo aplinkoje. Kai agentas pakeičia puslapio šabloną, rezultatą matote iškart. Įjunkite tiesioginį režimą, ir Canvas bus automatiškai atnaujinama pasikeitus failams.
Įjunkite tai blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
Tada eikite į /wp-admin/admin.php?page=blockstudio-canvas. Perjunkite puslapių rodinį (viso pločio darbo sritys) arba blokų rodinį (visų registruotų blokų tinklelis su numatytosiomis reikšmėmis).
Elementų žymeklis
elementų žymeklis išsprendžia dažną AI darbo eigų problemą: kaip nurodyti agentui, kuris failas atvaizduoja konkretų puslapio elementą.
Pridėkite ?blockstudio-devtools prie bet kurio priekinės dalies URL, tada laikykite nuspaudę Cmd+C (Mac) arba Ctrl+C (Windows) 100ms. Įsijungs kryžiuko formos žymeklis, kuris užvedus paryškins Blockstudio blokus. Spustelėkite elementą, kad nukopijuotumėte jo kontekstą į iškarpinę:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
Įklijuokite tai į savo AI programavimo įrankį, ir agentas iškart sužinos failo kelią, HTML struktūrą bei elementą, į kurį nurodote. Nebereikės rankomis ieškoti šablonų failų kelių.
Įjunkite tai blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
Praktiniai šablonai
Vieno bloko kūrimas
Paprasčiausia darbo eiga: aprašykite, ko norite, ir leiskite agentui tai sukurti.
Užklausa:
Sukurk atsiliepimo bloką su laukais citatai (teksto sritis), autoriaus vardui (tekstas), autoriaus pareigoms (tekstas) ir autoriaus nuotraukai (failai). Stiliui naudok Tailwind. Citata turi būti dideliu pasviruoju šriftu, su dekoratyvine kabute.
Agentas sukurs:
blockstudio/testimonial/
├── block.json
└── index.php
Viso puslapio kūrimas
Blockstudio failais pagrįsti puslapiai leidžia agentui sukurti viso WordPress puslapio karkasą kaip šabloną. Čia atsiskleidžia didžiausias pranašumas: užuot kūręs blokus po vieną, agentas vienu kartu sukuria visą puslapio struktūrą su visais blokais.
Užklausa:
Sukurk „Apie mus“ puslapį su pagrindine dalimi, komandos tinkleliu ir kontaktų formos vietaženklu. Kur įmanoma, naudok esamus blokus, o kur reikia, sukurk naujus. Priskirk jį įrašo ID 2. Užrakink šabloną, bet leisk redaguoti antraščių ir pastraipų turinį.
Agentas sukuria:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
Taip pat sukuria visus nurodytus tinkintus blokus (e.g., blockstudio/team-member/). Paleiskite
wp bs pages sync, kad sukurtumėte WordPress įrašą su užrakintu šablonu
ir redagavimo valdikliais. Visas puslapis yra versijuojamas ir atkuriamas.
Visos svetainės kūrimas
Čia atsiskleidžia tikrasis Blockstudio architektūros pranašumas. Viena užklausa gali sugeneruoti visą svetainę, nes kiekvienas išteklius yra failas:
Užklausa:
Sukurk portfolio svetainę su šiais puslapiais: Home, Work, About, Contact. Sukurk tinkintus blokus: pagrindinei daliai, projektų tinkleliui, projekto kortelei, komandos nariui, kontaktinei informacijai ir poraštei. Naudok tamsią temą su Tailwind. Konfigūruok Tailwind blockstudio.json su tinkinta spalvų palete.
Agentas sukuria bloko katalogus, puslapių šablonus, blockstudio.json su Tailwind konfigūracija ir, pasirinktinai, pakartotinai naudojamų sekcijų šablonus. Viskas įrašoma į git kaip vienas pakeitimų rinkinys.
Lygiagretaus agentų darbo eigos
Kai kurie įrankiai (Codex darbalaukio programa, GitHub Copilot CLI, Kilo Code) palaiko kelių agentų veikimą lygiagrečiai. Dėl Blockstudio architektūros, kur kiekvienas blokas laikomas atskirame faile, tai saugu:
- 1 agentas: kuria pagrindinės dalies bloką ir pagrindinį puslapį
- 2 agentas: kuria projekto kortelės bloką ir darbų puslapį
- 3 agentas: kuria kontaktų formos bloką ir kontaktų puslapį
Kadangi kiekvienas blokas yra atskirame kataloge, o Tailwind stiliai pateikiami kartu su šablonais, agentai nekonfliktuos. Vienintelis bendras failas yra blockstudio.json, kurį paprastai tereikia nustatyti vieną kartą pradžioje.
Patarimai geresniems rezultatams
-
Nurodykite LLM konteksto failą. Agentai sukuria gerokai geresnį Blockstudio kodą, kai gali pasiekti karkaso dokumentaciją. Visada nurodykite jiems
blockstudio-llm.txtir paruoškite sugeneruotąAGENTS.mdpačiam projektui. -
Tiksliai nurodykite laukų tipus. Užuot sakę „pridėk vaizdo lauką“, sakykite „pridėk failų lauką su
allowedTypes: ['image']irreturnFormat: 'object'“. Kuo tiksliau apibrėšite laukus, tuo mažiau kartų reikės taisyti. -
Pradėkite nuo vieno bloko, tada plėskite. Leiskite agentui tinkamai sukurti vieną bloką, peržiūrėkite jo šablonus, o tada paprašykite likusius kurti pagal tas pačias taisykles. Taip sukursite pavyzdį, pagerinsiantį vėlesnius rezultatus.
-
Peržiūrėkite rezultatą. „Vibe coding“ nereiškia, kad kodą reikia priimti aklai. Patikrinkite, ar laukų tipai atitinka jūsų poreikius, šablonai atvaizduojami teisingai, o Tailwind klasės sukuria norimą vaizdą. Prieš išleidžiant DI sugeneruotą kodą, jį reikia peržiūrėti.
-
Naudokite
block.jsonschemas. Blockstudio pateikia JSON schemą adresuhttps://blockstudio.dev/schema/block. Įtraukę"$schema"į block.json, agentams pateiksite validavimo grįžtamąjį ryšį ir išvengsite netaisyklingų konfigūracijų. -
Blokus kurkite mažus ir konkrečius. Po vieną bloką kiekvienam vizualiniam komponentui. Taip agentui lengviau apdoroti kiekvieną bloką, o šablonai lieka pakankamai trumpi, kad tilptų į vieną konteksto lango apdorojimo etapą.