Preskoči na vsebino

Vibecoding z Blockstudio

Andrej Karpathy je februarja 2025 skoval izraz »vibe coding« za potek dela, pri katerem umetni inteligenci opišete, kaj želite, ta pa napiše kodo. Leto pozneje je praksa dozorela v to, čemur zdaj pravi »agentic engineering«: razvijalci usmerjajo agente umetne inteligence, namesto da bi pisali kodo vrstico za vrstico.

Blockstudio je bil ustvarjen prav za to. Njegova arhitektura, ki temelji na datotekah, odsotnost orodij za gradnjo in predvidljiva struktura projekta ga uvrščajo med najboljša okolja za razvoj WordPress s pomočjo umetne inteligence.

Ta vodnik predstavlja praktične vzorce za uporabo agentov umetne inteligence za programiranje z Blockstudio, od nastavitve projekta do izdelave celotnega spletnega mesta.

Zakaj Blockstudio dobro deluje z agenti umetne inteligence

Datoteke, ne podatkovne zbirke

Agenti umetne inteligence za programiranje berejo in pišejo datoteke. To je njihov glavni način dela. Blockstudio vse hrani v datotečnem sistemu: po en block.json in predlogovno datoteko za vsak blok, po en page.json za vsako stran in po en pattern.json za vsak vzorec. Ni treba upravljati vnosov v podatkovni zbirki, klikati po skrbniškem UI ali zagnati postopka gradnje.

To je pomembno, ker sta datotečni sistem in ukazna lupina med največjimi viri podatkov za predhodno učenje LLM-jev. Vsak model je videl milijone primerov branja, pisanja in razvrščanja datotek. Kadar se vaš razvojni potek dela z WordPress ujema s tem načinom dela, lahko agenti delujejo z minimalnimi navodili.

Predvidljiva struktura

Vsak blok Blockstudio sledi enakemu vzorcu:

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

Ta doslednost pomeni, da lahko agent, ki je izdelal en blok, izdela tudi sto blokov. Ni presenečenj, posebnih primerov ali skritih nastavitev. Enak vzorec velja za strani (page.json + predloga), vzorce (pattern.json + predloga) in razširitve (extend.json).

Celotne strani kot datoteke

Za izdelavo strani v tradicionalnem WordPress potrebujete urejevalnik blokov: vlečenje blokov, nastavitev možnosti in shranjevanje prek skrbniškega vmesnika. Agenti umetne inteligence tega ne zmorejo. Potrebujejo datoteke.

Funkcija Blockstudio strani na podlagi datotek to v celoti rešuje. Datoteka page.json določa metapodatke strani, predloga index.php pa strukturo blokov z uporabo HTML:

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

Agent lahko pripravi celotno stran WordPress z osnovnimi in prilagojenimi bloki, zaklepanjem predloge ter kontrolniki za urejanje, in sicer tako, da zapiše le dve datoteki. Za uporabo izvorne vsebine v WordPress zaženite wp bs pages sync; odprtje skrbniškega vmesnika te sinhronizacije ne izvede samodejno.

To je ena najzmogljivejših funkcij za razvoj s pomočjo umetne inteligence. Namesto da opišete postavitev strani in jo ročno sestavite v urejevalniku, jo opišete agentu, ki napiše predlogo. Rezultat je pod nadzorom različic, ponovljiv in ga je mogoče v nekaj sekundah izboljšati.

Brez postopka gradnje

Ničesar ni treba prevesti, združiti ali pretvoriti. Agent ustvari datoteko in ta takoj deluje. SCSS se prevede na strežniku. Moduli ES se razrešijo med izvajanjem. Tailwind CSS se prevede ob vsaki zahtevi odjemalca. Povratna zanka med tem, ko agent napiše kodo, in njenim izvajanjem v brskalniku je tako kratka, kot je le mogoče.

Zakaj je Tailwind CSS prava izbira

Blockstudio podpira običajni CSS in Tailwind CSS, vendar ima Tailwind pomembno prednost pri delu z agenti umetne inteligence.

LLM-ji zelo dobro poznajo Tailwind

Tailwind CSS se uporablja v več deset tisoč odprtokodnih repozitorijih. Poganja vmesnike izdelkov, kot so Claude.ai, Vercel, Shopify, Cursor in izdelki podjetja OpenAI. Zaradi razširjenosti v podatkih za učenje LLM-ji zelo natančno ustvarjajo razrede Tailwind in le redko izmišljajo neobstoječe pripomočke.

Nabor razredov je končen in jasno določen. Agent si ne more izmisliti lastnosti CSS, ki ne obstaja, zato je napak pri oblikovanju bistveno manj kot pri pisanju poljubne kode CSS, kjer lahko agent ustvari neveljavne izbirnike ali napačno razume delovanje kaskade.

Slogi so zapisani v označevalni kodi

Pri Tailwind so vsi podatki o slogu shranjeni skupaj v predlogi HTML. Agent na enem mestu vidi celoten vizualni opis elementa. Ni mu treba iskati po ločenih datotekah .css, razumeti vrstnega reda kaskade ali spremljati sporov glede specifičnosti.

To je še posebej uporabno pri blokih Blockstudio, katerih predloga je že ena sama datoteka. Agent lahko v enem koraku ustvari popolno oblikovano komponento:

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>

Vzporedni agenti brez sporov

Ker so slogi Tailwind omejeni na posamezne predloge, lahko več agentov (ali razvijalcev) hkrati dela na različnih blokih brez sporov pri združevanju CSS. Skupna datoteka s slogi ne obstaja, zato spremembe ene komponente ne morejo po nesreči pokvariti druge. Vsak blok je samostojen.

To dobro deluje tudi pri običajnem CSS, če uporabite sloge Blockstudio, omejene na komponento (style.scoped.css), vendar Tailwind v celoti odpravi datoteko CSS, kar pomeni, da mora agent za vsak blok upravljati eno datoteko manj.

Običajni CSS je še vedno uporaben

Tailwind ni obvezen. Zbirka orodij za vire v Blockstudio samodejno obravnava datoteke .css in .scss, vključno s slogi, omejenimi na komponento, ki dobijo imenski prostor bloka. Če vaš projekt uporablja drugo metodologijo CSS, lahko agenti delajo tudi z njo. Prednost uporabe Tailwind je zgolj v tem, da so LLM-ji zaradi obsega podatkov za učenje in bližine slogov označevalni kodi pri tem uspešnejši.

Agenti umetne inteligence za programiranje

Vsa naslednja orodja CLI lahko takoj uporabljate s projekti Blockstudio. Berejo in zapisujejo datoteke, izvajajo ukaze lupine ter razumejo strukturo projekta na podlagi kontekstnih datotek.

Agenti za terminal (CLI)

Orodje Ponudnik Opombe
Claude Code Anthropic Agent, zasnovan predvsem za terminal. Za kontekst projekta bere CLAUDE.md.
Codex CLI OpenAI Odprtokodni CLI, izdelan z Rust. Na voljo je tudi kot namizna aplikacija.
Gemini CLI Google Odprtokodno orodje z 1M žetoni v kontekstnem oknu. Bere GEMINI.md.
GitHub Copilot CLI GitHub Specializirani vzporedni agenti za raziskovanje, naloge, načrtovanje in pregled.
Aider Odprtokodno Podpira 100+ ponudnikov LLM-jev, vključno z lokalnimi modeli.
OpenCode Odprtokodno Terminalski TUI z integracijo LSP. Podpira več kot 75 ponudnikov.
Amazon Q Developer CLI AWS Na voljo je brezplačna različica. Odlično deluje s projekti, integriranimi z AWS.

Agenti za IDE

Orodje Ponudnik Opombe
Cursor Cursor VS Code različica z vgrajeno umetno inteligenco. Na voljo je tudi CLI (beta).
Windsurf Cognition AI Različica VS Code z vgrajenim agentom Cascade.
Cline Odprtokodno Razširitev VS Code s potrjevanjem po korakih. Na voljo je tudi CLI.
Kilo Code Odprtokodno Način orkestratorja z usklajenimi podrejenimi agenti.
Continue Odprtokodno Razširitev VS Code/JetBrains z asinhronimi agenti CI/CD.
Augment Code Augment Namenjeno podjetjem z naprednim indeksiranjem kodne zbirke.

Vsa ta orodja lahko ustvarjajo in urejajo datoteke v projektnem imeniku Blockstudio. Agenti za terminal so še posebej primerni, ker razvoj z Blockstudio ne zahteva posebnih funkcij IDE-ja in temelji izključno na datotekah.

Priprava projekta za agente umetne inteligence

Kontekstna datoteka za LLM

Blockstudio vključuje vnaprej pripravljeno kontekstno datoteko, ki indeksira celotno dokumentacijo ogrodja. To ni povzetek ali priročnik: vsak dokument je naveden enkrat skupaj s svojo potjo, namenom in identifikatorji, za katere je pristojen, zato lahko agent poišče stran z odgovorom na vprašanje in odpre samo njo. Celotno besedilo vseh dokumentov in shem je na voljo v drugi datoteki za orodja, ki želijo hkrati pregledati celotno zbirko.

Omogočite jo v svojem blockstudio.json:

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

Kazalo je zdaj na voljo na your-site.com/blockstudio-llm.txt, celotno besedilo pa na your-site.com/blockstudio-llm-full.txt. Usmerite svoje orodje AI na kazalo in dostopa lahko do celotne Blockstudio API brez dodatnih navodil. Za nastavitev posameznih orodij si oglejte dokumentacijo o integraciji z umetno inteligenco.

S tem vam ni treba več sami pisati navodil, prilagojenih ogrodju. Agent z dostopom do blockstudio-llm.txt lahko poišče navodila za ustvarjanje blokov, določanje polj, pisanje predlog, nastavitev Tailwind, pripravo strani in uporabo vseh kavljev, ki jih ponuja Blockstudio.

Kontekstne datoteke za posamezen projekt

Večina agentov umetne inteligence za programiranje bere tudi kontekstno datoteko na ravni projekta, ki vsebuje navodila, prilagojena vaši kodni zbirki. Uporabljena datoteka je odvisna od orodja:

Datoteka Orodje
CLAUDE.md Claude Code
AGENTS.md Codex CLI, Gemini CLI, Copilot CLI in druga orodja
.cursor/rules/*.mdc Cursor
.github/copilot-instructions.md GitHub Copilot

Ker blockstudio-llm.txt že pokriva ogrodje, mora vaša kontekstna datoteka za projekt opisovati le posebnosti projekta: razporeditev imenikov, pravila poimenovanja, ukaze in omejitve.

Če namestite blockstudio/phpstan, vam tega opisa ni treba pisati ročno. vendor/bin/blockstudio-agents iz blockstudio.json in vaših datotek ustvari AGENTS.md, v katerem navede, kaj projekt ustvarja, katere funkcije so omogočene, kaj bo analiza zavrnila in kateri ukazi so na voljo. Datoteke, ki je ni ustvaril sam, ne prepiše; ob ponovni izdelavi pa ohrani vaše opombe.

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

Orodja za razvijalce pri delu z umetno inteligenco

Blockstudio vključuje dve orodji za razvijalce, zasnovani posebej za razvoj s pomočjo umetne inteligence.

Platno

platno ponuja pregled vseh vaših strani Blockstudio v slogu Figma, prikazanih kot delovne površine v živih okvirih iframe v enem pogledu. Pomikajte se s sledilno ploščico, povečujte pa s potezo za približevanje ali Ctrl+pomikom.

To je uporabno pri delu z agenti umetne inteligence, saj omogoča vizualni pregled vseh strani brez preklapljanja med zavihki ali brskanja po skrbniškem vmesniku WordPress. Ko agent spremeni predlogo strani, lahko rezultat vidite takoj. Vklopite način v živo in platno se bo samodejno osvežilo ob spremembi datotek.

Omogočite jo v blockstudio.json:

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

Nato odprite /wp-admin/admin.php?page=blockstudio-canvas. Preklapljate lahko med pogledom strani (delovne površine čez celotno širino) in pogledom blokov (mreža vseh registriranih blokov s privzetimi vrednostmi).

Izbirnik elementov

izbirnik elementov rešuje pogost zaplet pri delu z agenti umetne inteligence: ugotavljanje, katera datoteka izriše določen element na strani.

Frontendu URL dodajte ?blockstudio-devtools, nato za 100 ms pridržite Cmd+C (Mac) ali Ctrl+C (Windows). Aktivira se izbirnik z nitnim križem, ki med premikanjem kazalca označuje bloke Blockstudio. Kliknite element, da kopirate njegov kontekst v odložišče:

Koda
@<div>

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

Prilepite to v orodje umetne inteligence za programiranje in agent bo takoj poznal pot do datoteke, strukturo HTML in element, na katerega kažete. Iskanje poti do datotek predlog ni več potrebno.

Omogočite jo v blockstudio.json:

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

Praktični vzorci

Izdelava posameznega bloka

Najpreprostejši potek dela: opišite, kaj želite, in pustite agentu, da to ustvari.

Poziv:

Ustvari blok s pričevanjem, ki vsebuje polja za citat (večvrstično besedilo), ime avtorja (besedilo), vlogo avtorja (besedilo) in fotografijo avtorja (datoteke). Za oblikovanje uporabi Tailwind. Citat naj bo v veliki ležeči pisavi z okrasnim narekovajem.

Agent bo ustvaril:

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

Izdelava celotne strani

Funkcija Blockstudio strani na podlagi datotek agentu omogoča, da celotno stran WordPress pripravi kot predlogo. Tu se pokaže vsa prednost: namesto postopne izdelave blokov agent v enem koraku ustvari celotno strukturo strani z vsemi bloki.

Poziv:

Ustvari stran »O nas« z uvodnim razdelkom, mrežo ekipe in nadomestnim obrazcem za stik. Kjer je mogoče, uporabi obstoječe bloke, po potrebi pa ustvari nove. Poveži jo z ID-jem objave 2. Predlogo zakleni, naslove in odstavke pa omogoči urejati kot vsebino.

Agent ustvari:

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

Poleg tega ustvari vse uporabljene prilagojene bloke (e.g., blockstudio/team-member/). Za ustvarjanje objave WordPress z zaklenjeno predlogo in kontrolniki za urejanje zaženi wp bs pages sync. Celotna stran je pod nadzorom različic in jo je mogoče znova ustvariti.

Izdelava celotnega spletnega mesta

Tu resnično pride do izraza arhitektura Blockstudio. Z enim samim pozivom lahko ustvarite celotno spletno mesto, saj je vsak element datoteka:

Poziv:

Izdelaj portfeljsko spletno mesto s temi stranmi: Domov, Delo, O nas, Stik. Ustvari prilagojene bloke za: uvodni razdelek, mrežo projektov, kartico projekta, člana ekipe, podatke za stik in nogo. Uporabi temno temo z Tailwind. V blockstudio.json nastavi Tailwind s prilagojeno barvno paleto.

Agent ustvari imenike blokov, predloge strani, blockstudio.json s konfiguracijo Tailwind in po želji vzorce za znova uporabne razdelke. Vse je vključeno v git kot en sam nabor sprememb.

Poteki dela z vzporednimi agenti

Nekatera orodja (namizna aplikacija Codex, GitHub Copilot CLI, Kilo Code) podpirajo vzporedno izvajanje več agentov. Arhitektura Blockstudio, ki za vsak blok uporablja svojo datoteko, to omogoča brez težav:

  • Agent 1: izdela uvodni blok in domačo stran
  • Agent 2: izdela blok s kartico projekta in stran z deli
  • Agent 3: izdela blok z obrazcem za stik in stran s stiki

Ker je vsak blok v svojem imeniku, slogi Tailwind pa so shranjeni skupaj s predlogami, se ti agenti med seboj ne bodo ovirali. Edina skupna datoteka je blockstudio.json, ki jo je običajno treba nastaviti le enkrat na začetku.

Nasveti za boljše rezultate

  1. Navedite kontekstno datoteko za LLM. Agenti ustvarijo bistveno boljšo kodo Blockstudio, če lahko dostopajo do dokumentacije ogrodja. Vedno jih usmerite na blockstudio-llm.txt in jim za sam projekt zagotovite ustvarjeni AGENTS.md.

  2. Natančno določite vrste polj. Namesto »dodaj slikovno polje« recite »dodaj polje vrste files z allowedTypes: ['image'] in returnFormat: 'object'«. Natančnejša kot je opredelitev polj, manj ponovitev bo potrebnih.

  3. Začnite z enim blokom, nato razširite obseg. Agent naj pravilno izdela en blok. Preglejte njegove vzorce, nato mu naročite, naj preostale izdela po enakih pravilih. Tako vzpostavite zgled, ki izboljša naslednje rezultate.

  4. Preglejte rezultat. Vibe coding ne pomeni, da kodo sprejmete brez premisleka. Preverite, ali vrste polj ustrezajo vašim namenom, ali se predloge pravilno izrisujejo in ali razredi Tailwind ustvarijo ustrezen vizualni rezultat. Kodo, ustvarjeno z umetno inteligenco, je treba pregledati pred objavo.

  5. Uporabite sheme block.json. Blockstudio ponuja shemo JSON na naslovu https://blockstudio.dev/schema/block. Če v block.json dodate "$schema", agenti dobijo povratne informacije o preverjanju in se izognejo nepravilnim konfiguracijam.

  6. Bloki naj bodo majhni in osredotočeni. Za vsako vizualno komponento uporabite en blok. Tako agent lažje razume vsak blok, predloge pa ostanejo dovolj kratke, da jih lahko obdela v enem prehodu kontekstnega okna.