Siirry sisältöön

Tekoälyn ehdoilla tehty lohkojen kehitys

Tiedostot ja ei koontivaihetta – juuri sitä, missä agentit ovat hyviä.

Äänetön näyttötallenne: koodausagentti rakentaa yhden kehotteen pohjalta kokonaisen WordPress-sivuston, jossa on 10 mukautettua lohkoa ja 6 sivua.

Kuvaile lohko, luo lohko

Tekoälykoodausagentit voivat luoda lohkojen, sivujen ja mallien pohjat yhdellä kehotteella. Ei graafista käyttöliittymää eikä tietokantaa, vain tiedostoja.

~/starter-theme

❯ Luo hinnoittelulohko, jossa on kolme tasoa, kuukausi-/vuosivalitsin ja toimintakehote jokaiselle tasolle.

✓ Luotu pricing/block.json

✓ Luotu pricing/index.php

✓ Luotu pricing/style.css

❯ Luo nyt hinnoittelusivu, jossa on pääosio ja UKK-osio.

✓ Luotu pages/pricing/page.json

✓ Luotu pages/pricing/index.php

Tiedostot

blockstudio/

├── pricing/ Uusi

├── block.json

├── index.php

└── style.css

pages/

├── pricing/ Uusi

├── page.json

└── index.php

Kaikki tiedostopohjaista

Lohkot, sivut, kuviot ja laajennukset ovat hakemistoja, joissa on JSON-määritystiedosto ja malleja. Agentit lukevat ja muokkaavat niitä suoraan.

Ei tietokantamäärityksiä

Ei hallintapaneeleissa napsuttelua. Jokainen asetus on JSON-avain, joten agentti voi luoda kirjaston selainta käyttämättä.

Ennakoitava rakenne

Jokainen lohko noudattaa samaa käytäntöä: block.json, malli ja valinnaiset tyylit. Opettele käytäntö kerran.

Kontekstia, ei arvailua

Tiivis dokumentaation hakemisto sekä koko teksti työkaluja varten, jotka tarvitsevat kaiken.

Hakemisto, jonka agentti lukee ensin

blockstudio-llm.txt luettelee jokaisen dokumentin kerran sekä sen reitin, lähdetiedoston, tarkoituksen ja sen omistamat asetukset, koukut, PHP-funktiot ja CLI-komennot. Noin 11k tokenin kokoisena agentti lukee sen kokonaan ja avaa sitten vain tarvitsemansa sivun.

blockstudio-llm-full.txt sisältää kaikki dokumentit ja JSON-skeemat yhdessä tiedostossa, noin 169k tokenia, työkaluja varten, jotka tarvitsevat koko aineiston. Ota ai.enableContextGeneration käyttöön, niin sivustosi tarjoaa molemmat.

blockstudio-llm.txt
# Blockstudio documentation index

This is the primary context file for coding assistants. It is an index, not
the documentation itself. Each entry names one document, what it is for, and
the identifiers that document owns. Read this index, then open only the
document you need.

Every document is addressable two ways: as a URL on https://blockstudio.dev,
and as a Markdown file in the Blockstudio repository. The full text of every
document and schema is also available in one file at /blockstudio-llm-full.txt
for tools that want everything at once.

Sopimus projektillesi

Dokumentaatio kuvaa Blockstudio. AGENTS.md kuvaa projektia, jota agentti on muuttamassa.

Yksi komento luo tiedoston AGENTS.md

vendor/bin/blockstudio-agents kuvaa projektia, jossa se toimii: mitä se sisältää, mitkä ominaisuudet blockstudio.json ottaa käyttöön, mitä analyysi hylkää ja mitkä komennot pätevät.

Jokainen rivi perustuu tiedostoihisi, asetuksiisi tai valittuun analyysiasetukseen. Uudelleenluonti säilyttää itse kirjoittamasi muistiinpanot, ja --check epäonnistuu, jos sopimus on vanhentunut.

AGENTS.md
# Blockstudio contract for Acme

## Project

- Kind: WordPress theme `Acme`.
- Configuration: `blockstudio.json`.
- Analysis preset: `extreme-theme`.

## What this project contains

- Blocks: 1 in `blockstudio`.
- Pages: 1 in `pages`.
- Block namespaces: `acme`.
- Block templates are written in PHP.

Virheet havaitaan ennen committia

Neljä analyysin esiasetusta, joista kukin sisältää edellisen ominaisuudet, sekä koukku, joka suorittaa analyysit jokaisessa commitissa.

block.json tuntevaa analyysiä

blockstudio/phpstan-asetukset lukevat lohkosi, sivusi ja asetuksesi. Analyysi epäonnistuu, jos malli lukee kentän, jota sen block.json ei määritä, tai tulostaa sen escapettomana.

Mallit lukevat $a-tyypin, joka määritellään niiden vieressä olevassa block.json-tiedostossa, ja jokaisella kenttätyypillä on konkreettinen PHP-tyyppi; Db::get() palauttaa tietueita, joiden rakenne määräytyy db.php mukaan. Väärin kirjoitettu asetuspolku tai koukun nimi aiheuttaa virheen, jossa ehdotetaan lähintä oikeaa nimeä.

Aseta githooks.commit ja suorita vendor/bin/blockstudio-githooks sync: hallittu esikäsittelykoukku suorittaa saman analyysin, joten rikkinäinen lohko ei päädy commit-tapahtumaan.

blockstudio.json
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "phpstan": { "preset": "extreme-theme" },
  "githooks": { "commit": true }
}

Inventaario ja renderöinti PHP-ratkaisusta

Muutamalla kutsulla agentti näkee, mitä projektiin on rekisteröity, renderöi minkä tahansa osan ja tarkistaa tallennetut tiedot.

Kysy projektilta, tulosta vastaus

Canvas::inventory() palauttaa kaikki projektin rekisteröimät sivut, lohkot, kuviot, Site Editor -mallit, malliosat ja UI-esimerkit tulostamatta mitään.

Render::document() tulostaa minkä tahansa niistä täydellisenä HTML-dokumenttina, joka sisältää täsmälleen käytetyt resurssit, jotta agentti voi tarkistaa työnsä editorin ulkopuolella.

Canvas::documents() renderöi täsmälleen valitsemasi tietueet. Render::composition() ja Render::content() palauttavat sisäkkäiset määritykset tai serialisoidun lohkosisällön muodossa HTML, ja Ui::inventory() sekä Ui::examples() luettelevat mukana toimitettavat komponenttiperheet, joissa kussakin on yksi renderöitävä määritys.

Yhden lohkon tapauksessa bs_block_fields(), bs_block_extension_fields(), bs_block_values() ja bs_block_assets() palauttavat sen kentät, arvot ja resurssit renderöimättä lohkoa, ja bs_validate_block() tarkistaa tallennetut attribuutit ennen niiden tallentamista.

inspect.php
use Blockstudio\Canvas;
use Blockstudio\Render;

$project = Canvas::inventory(['blocks' => true]);

foreach ($project['inventory']['blocks'] as $block) {
  echo $block['name'] . "\n";
}

$doc = Render::document(
  ['name' => 'acme/hero', 'data' => ['heading' => 'Hello']],
  ['title' => 'Hero preview']
);

file_put_contents('hero.html', $doc['html']);

Alle puolet tokeneista sivua kohti

Agentit kirjoittavat tavallista HTML-sisältöä. Blockstudio muuntaa sen synkronoinnin yhteydessä sarjallistetuksi WordPress-lohkomerkinnäksi: vähemmän tuotettavaa ja vähemmän virheitä.

Blockstudio

Mitä agentit kirjoittavat

Noin 135 merkkiä
index.php
<h1>Build Websites That Convert</h1>
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>

<block name="core/columns">
  <block name="core/column">
    <h3>Lightning Fast</h3>
    <p>Pages load in under one second.</p>
  </block>
  <block name="core/column">
    <h3>Easy to Use</h3>
    <p>No technical skills required.</p>
  </block>
  <block name="core/column">
    <h3>SEO Optimized</h3>
    <p>Built-in best practices from day one.</p>
  </block>
</block>

<img src="/dashboard.jpg" alt="Dashboard" />

WordPress

Mitä jäsennin kirjoittaa sitä varten

Noin 310 merkkiä
post_content
<!-- wp:heading {"level":1} -->
<h1 class="wp-block-heading">Build Websites That Convert</h1>
<!-- /wp:heading -->
<!-- wp:paragraph -->
<p>The all-in-one platform for creating
beautiful, high-performance landing pages.</p>
<!-- /wp:paragraph -->
<!-- wp:columns -->
<div class="wp-block-columns">
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Lightning Fast</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Pages load in under one second.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">Easy to Use</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>No technical skills required.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
  <!-- wp:column -->
  <div class="wp-block-column">
    <!-- wp:heading {"level":3} -->
    <h3 class="wp-block-heading">SEO Optimized</h3>
    <!-- /wp:heading -->
    <!-- wp:paragraph -->
    <p>Built-in best practices from day one.</p>
    <!-- /wp:paragraph -->
  </div>
  <!-- /wp:column -->
</div>
<!-- /wp:columns -->
<!-- wp:image {"alt":"Dashboard","url":"/dashboard.jpg"} -->
<figure class="wp-block-image"><img src="/dashboard.jpg" alt="Dashboard"/></figure>
<!-- /wp:image -->

Mitattu yllä olevista kahdesta paneelista: HTML sisältää 540 merkkiä, kun taas lohkon merkintäkieli, jonka vakiomuotoinen jäsennin kirjoittaa sitä varten, sisältää 1,233 merkkiä. Tämä jaetaan neljällä, joka on tavallinen arvio merkkien määrästä tokenia kohti. Merkintäkieli näytetään rivinvaihdoilla luettavuuden parantamiseksi.

Vähemmän tuotettavaa tulostetta

Agentit kirjoittavat HTML-sisältöä ilman lohkoerottimia, luotuja luokkia tai kääremerkintöjä.

Vähemmän virheitä

Jäsennin takaa kelvollisen lohkotulosteen yksinkertaisemmasta syötteestä.

Nopeampi ja edullisempi

Vähemmän tulostetokeneita tarkoittaa nopeampia vastauksia ja pienempiä mallikustannuksia.

Toimii kaikilla tekoälykoodaustyökaluilla

Mikä tahansa tiedostoja lukeva ja kirjoittava agentti toimii Blockstudio-ratkaisun kanssa suoraan.

Claude Code
Codex CLI
Gemini CLI
Cursor
Windsurf
Amp

Tehty tekoälyn työnkulkua varten

Lohkot, sivut, kuviot ja asetukset. Kaikki on tiedostoja, joita agentti voi lukea, kirjoittaa ja muokata.

Kaksi tiedostoa lohkoa kohti

JSON-määritystiedosto ja malli muodostavat koko lohkon. Pieni pinta-ala tekee ensimmäisestä generoinnista luotettavan.

27 kenttätyyppiä

Tekstit, tiedostot, toistimet, värit, päivämäärät ja paljon muuta määritetään JSON-tiedostossa. Valintalistat täyttyvät julkaisuista, termeistä ja käyttäjistä.

JSON skeeman tarkistus

Jokaisella määrityksellä on skeema, joka antaa agenteille täsmälliset säännöt ja havaitsee virheet heti.

Automaattinen rekisteröinti

Pudota tiedostot hakemistoon, niin lohkot rekisteröityvät automaattisesti ilman erillistä määritysluetteloa.

Kanvaksen yleiskuva

Kaikki hallitut sivut tai kaikkien lohkojen oletusarvot yhdessä zoomattavassa näkymässä.

Live-kanvaasi

Live-tila päivittää muutoksen kohteena olevat piirtoalueet Server-Sent Events -tekniikalla noin sekunti tallennuksen jälkeen. Napsauta selitettä kohdistaaksesi näkymän yhteen piirtoalueeseen.

Tailwind sisäänrakennettuna

TailwindPHP kääntää kunkin sivun käyttämät luokat ilman Node-määrityksiä.

Element Grabber

Kopioi elementin mallipolku ja merkkaus agentin välittömäksi kontekstiksi.

HTML lohkoiksi

Sivut ja kuviot ovat tavallisia tiedostoja, joista syntyy natiiveja WordPress-lohkoja.

Renderöinnin savutesti

wp bs blocks render renderöi jokaisen lohkon kuten sivu ja poistuu koodilla 1, jos malli antaa ilmoituksen, varoituksen tai virheen.

Tallennetun sisällön tarkistukset

wp bs blocks validate tarkistaa viestien tallennetut kentät, ja pages sync varoittaa attribuuteista, jotka lohko tallentaa mutta joita se ei koskaan renderöi.

Tarkastele komentoriviltä

Luettele asetukset, mukautetut kentät ja resurssit komennolla wp bs ja käännä koodikatkelma tai tiedosto komennoilla wp bs tailwind compile tai wp bs scss compile.

Plus

Virallinen laajennuspaketti

Premium-sivupohjia, tekoälyn järjestelmäohjeita ja yksityinen Discord-yhteisö. Kertamaksu, elinikäiset päivitykset.

  • 500+ sivustomallia
  • Tekoälyn järjestelmäohjeet
  • Elinikäiset päivitykset
  • Yksityinen Discord-yhteisö