Blogi

Skills-taidot, aliagentit, MCP ja liitännäiset Claude Codessa: mitä valita

Markdown

Skills-taidot, aliagentit, MCP ja liitännäiset ovat Claude Coden laajennusten neljä kerrosta. Selitän, milloin kutakin kannattaa käyttää, ja annan valmiin päätösmatriisin sekä esimerkkejä projekteista.

Lue koko artikkeli

Claude Codessa on viisi tapaa tehdä sama koodikatselmointi: kauttakomento, taito, aliagentti, liitännäinen tai yksinkertaisesti kehote keskustelussa. Mikään näistä tavoista ei ole oletusarvoisesti toista parempi — valinta riippuu tehtävästä, token-budjetista ja siitä, kuka muu käyttää sitä.

Tämä opas on se, jonka olisin halunnut itselleni vuosi sitten. Neljän kysymyksen päätöspuu, valmis ”tehtävä → kerros” -matriisi ja 5 yleistä virhettä, jotka kuluttavat tokeneita jokaiselta vibe coderilta, jonka kanssa työskentelen.

Tietoa palvelun käytöstä on Ailoot-dokumentaatiossa.

Mitä skills-taidot, aliagentit, MCP ja liitännäiset tarkoittavat yhdellä lauseella?

Keskeinen huomio

Skill on paketoitu menetelmä, jonka Claude lataa, kun se käynnistetään. Aliagentti on eristetty ”kollega”, jolla on oma konteksti pitkää tehtävää varten. MCP on silta ulkoiseen järjestelmään (tietokantaan, GitHubiin, Notioniin). Liitännäinen on jaeltava kokonaisuus, joka voi sisältää kaikkea edellä mainittua ja asennetaan yhdellä rivillä. Sen voi tehdä itse tai saada toiselta tekijältä.

Ennen valintaa erotellaan käsitteet. Kaikilla neljällä kerroksella on sama tavoite: laajentaa sitä, mitä Claude osaa tehdä sellaisenaan. Jokaisella kerroksella on kuitenkin oma luonteensa.

Skill on hakemisto, jossa on SKILL.md-tiedosto. Tiedosto kuvaa, milloin ja miten tiettyä menetelmää käytetään. Anthropic vertaa skill-taitoa uuden työntekijän ohjeisiin: hänelle ei sanella joka päivä jokaista vaihetta, vaan annetaan toimintatapa.

Aliagentti on erillinen Claude-istunto, jolla on oma kontekstinsa ja joka käynnistetään pääkeskustelusta. Sillä on yksi tärkeä ominaisuus: eristäminen. Aliagentti voi lukea 30 tiedostoa, tehdä yhteenvedon ja palauttaa pääkeskusteluun vain sen. Pääkeskustelun konteksti pysyy siistinä.

MCP (Model Context Protocol) on Anthropicin avoin standardi Clauden yhdistämiseen ulkoisiin järjestelmiin. Blogikirjoituksessa 13. marraskuuta 2025 Anthropic selitti eron mahdollisimman selkeästi:

MCP yhdistää Clauden dataan; Skills opettaa Claudelle, mitä sillä datalla tehdään. Jos selität, miten työkalua käytetään tai miten noudatetaan menettelytapoja — esimerkiksi ”tietokantakyselyissä suodata aina ensin päivämäärävälin perusteella” — kyseessä on Skill. Jos Claudella pitää alun perinkin olla pääsy tietokantaan tai Excel-tiedostoihin, kyseessä on MCP.

— Anthropic Engineering, https://claude.com/blog/skills-explained

Liitännäinen on jonkun muun valmis paketti, joka sisältää skills-taitoja, aliagentteja, hookeja ja komentoja ja joka jaetaan markkinapaikalla. Asenna se yhdellä rivillä komennolla /plugin install, niin saat kaiken kerralla. Jos skill on oma toimintatapasi, liitännäinen on toiselta yritykseltä ostettu toimintatapa.

Lyhyesti: skills-taidot ovat reseptejä, aliagentit ovat erikoistuneita kollegoita ja MCP tarjoaa ulkoisia työkaluja, joiden kautta Claude pääsee palveluihin ja dataan. Token-kustannukset vaihtelevat: skill on edullisin (se latautuu käynnistettäessä), kun taas MCP on huomattavasti kalliimpi (jokainen yhdistetty palvelin vie jatkuvasti tilaa konteksti-ikkunasta).

Miksi on 4 kerrosta, jos käytössä voi olla yksi CLAUDE.md?

Keskeinen huomio

CLAUDE.md on pyyntö: Claude lukee sen istunnon alussa ja voi sivuuttaa sen 20 viestin jälkeen. Skills-taidot, aliagentit, MCP ja liitännäiset ratkaisevat asioita, joihin CLAUDE.md ei pysty: skaalautuvuutta, kontekstin eristämistä, pääsyä ulkomaailmaan ja menetelmien jakamista tiimin kanssa.

Kuvatussa projektissa CLAUDE.md on laaja sääntökartta: minne asiat sijoitetaan, miten julkaistaan ja mistä on sovittu. Ilman tätä tiedostoa Claude aloittaisi jokaisen uuden istunnon tyhjästä.

CLAUDE.md:llä on kuitenkin rajansa. Selitän kolmella tilanteella, joissa se lakkaa toimimasta.

Tilanne 1: sääntö toimii vain joskus. CLAUDE.md sanoo: ”suorita aina npm run build ennen git push -komentoa”. Claude lukee sen istunnon alussa, nyökkää, alkaa kirjoittaa koodia 25 viestin jälkeen ja unohtaa asian. Olen jo kolmesti huomannut työntäneeni muutokset ilman buildia; nämä pushit epäonnistuivat tuotannossa. Oikein määritetty ja testattu hook voi suorittaa deterministisen koontitarkistuksen ja hylätä kattamansa operaation. Kattavuus riippuu tapahtumasta ja työkalureitistä. Claude Code -hook ei itsessään sieppaa jokaista toisesta terminaalista tai sovelluksesta tehtyä pushia. Varmista, että tarkoituksella epäonnistuva koonti estää juuri käyttämäsi reitin.

Tilanne 2: toistuva 15-vaiheinen prosessi. Kuvatussa esimerkissä jokainen opas käy läpi 14 vaihetta: tutkimus → rakenne → MDX → 7 rinnakkaista QA-tarkistusta → julkaisu tuotantoon → IndexNow. Jos kirjoitan joka kerta kehotteen ”suorita ensin vaihe 1, sitten 2 ja sitten 3”, kulutan tokeneita ennen kuin pääsen edes alkuun. Siksi koko työnkulku on paketoitu build-masterskaya-guide-skilliksi — 34 KB:n ohjeiksi, jotka käynnistetään lauseella ”tehdään projektille uusi opas”.

Tilanne 3: tehtävä ahmii kontekstia. Jo julkaistun oppaan ajantasaisuuden tarkistamiseksi Clauden pitää lukea 30 KB:n suoratoistolähetyksen transkriptio, 20 retrospektiiviä, joista kukin on 5 KB, ja verrata niitä nykyiseen sivustoon. Jos teen tämän pääkeskustelussa, arvostelun loppuun mennessä kontekstissani on 200K tokenia turhaa sisältöä. Aliagentti tekee saman työn, palauttaa pääkeskusteluun vain 300 sanan yhteenvedon ja sulkeutuu.

Tilanne 4: haluan tiimin saavan samat mallit kuin minulla. Valmis sääntökokonaisuus frontend-suunnitteluun, hookit Coolifyn kautta julkaisemiseen ja MCP Playwright-tarkistuksiin. Se on liitännäinen: paketoin kokoonpanoni, julkaisen sen markkinapaikalla ja kollega asentaa sen yhdellä rivillä.

CLAUDE.md kattaa perusteet: ”näin meillä toimitaan”. Sen päälle tulevat 4 kerrosta kattavat sen, mihin CLAUDE.md ei fyysisesti pysty: toiston käynnistimien kautta, kontekstin eristämisen, pääsyn ulkomaailmaan ja jakamisen.

Milloin tarvitset skillin CLAUDE.md:n sijaan?

Keskeinen huomio

Skill on oikea valinta, kun prosessi on toistettava, sillä on selkeä käynnistin ja teet sen useammin kuin kerran päivässä. Toisin kuin CLAUDE.md, skill latautuu vain tarvittaessa eikä kuluta perustason kontekstia jokaisessa istunnossa.

Skillin tarve on helppo tunnistaa: huomaat kopioivasi saman pitkän kehotteen muistiinpanoistasi keskusteluun. Kolmas kerta on jo merkki.

Minulla on nyt 7 hakemistoa polussa ~/.claude/skills/: build-masterskaya-guide, build-vc-spoke, build-reel-script, build-practicum-instruction, update-config, simplify ja keybindings-help. Eniten käytän build-masterskaya-guide-skill-taitoa (tämä opas kirjoitettiin sitä käyttäen). Siinä on 34 KB menetelmiä: mitä vaiheita käydään läpi, mitä moniagenttisia QA-tarkistuksia suoritetaan, mitkä porttiehdot pysäyttävät prosessin ja mitä tuotoksia tallennetaan polkuun /tmp/.

Milloin skill-taitoa ei kannata tehdä.

  • Sääntö kuten ”vastaa käyttäjän haluamalla kielellä” kuuluu CLAUDE.md:hen, ei skill-taitoon. Skill latautuu käynnistettäessä, mutta tämän säännön pitäisi olla aina voimassa.
  • Kertaluonteinen ohje kuten ”suorita uudelleenjärjestely nyt” kuuluu keskusteluun, ei skill-taitoon.
  • Erillisen kontekstin tarvitseva tehtävä voi käyttää aliagenttia. Jos se myös noudattaa toistuvaa menettelyä, säilytä menetelmä skillissä.

Tärkein anti-pattern. Yleisin vibe coderien tekemä virhe on pakata menettely aliagenttiin, vaikka sen pitäisi olla skill. Aliagentti kuluttaa enemmän tokeneita (sillä on oma konteksti), käynnistyy hitaammin ja on usein ylimitoitettu ratkaisu. Jos tehtävä mahtuu 1 500–2 000 sanan menetelmäkuvaukseen eikä ulkoisia tiedostoja tarvitse lukea, se on skill.

Ohje skillin rakenteesta, frontmatter-sisällöstä ja toimivista käynnistyslauseista löytyy oppaasta Claude Code Skills in 2026: How to Build a Personal Skills Library.

Milloin tarvitset aliagentin skillin sijaan?

Keskeinen huomio

Aliagentti siirtää raskaan työn omaan kontekstiinsa ja palauttaa pääkeskusteluun vain yhteenvedon. Käytä sitä, kun tehtävä vaatii monien tiedostojen lukemista, pitkää analyysia tai 5 samanlaisen tarkistuksen suorittamista rinnakkain — etkä halua kaikkea välivaiheiden sälää pääkeskusteluun.

Skill tallentaa menetelmän; aliagentti tekee työn. Ne ovat eri kerroksia, ja ne sekoitetaan usein, koska molemmat käynnistetään ”keskustelusta”.

Aliagentista voi olla hyötyä kontekstin eristämiseen tai rajatun roolin delegointiin. Clauden pääistunnon budjetti on 200 000 tokenia (tai betassa 1 miljoona). Jos pyydät sitä pääkeskustelussa lukemaan 30 tiedostoa ja analysoimaan jokaisen, kulutat puolet ikkunasta välivaiheiden lukemiseen. Aliagentti tekee saman työn erillisessä istunnossa ja palauttaa pääkeskusteluun vain tuloksen.

Konkreettinen esimerkki projektista. Jokaiselle oppaalle tehdään useita rinnakkaisia QA-tarkistuksia: tyyli, sitaatit ja faktat ensisijaisia lähteitä vasten, rakenne hakukoneita varten sekä sisäisten ja ulkoisten linkkien eheys. Kukin tarkistus käyttää omaa kontekstiaan: sääntöjen sanastoa, WebFetchiä kymmenille URL-osoitteille ja tekstin läpikäyntiä grep-hauilla.

Jos suorittaisin kaikki nämä tarkistukset yhdessä keskustelussa, konteksti ahmaisisi minut ennen kuin ensimmäinenkään olisi valmis. Aliagenttien suorittaminen rinnakkain asetuksella run_in_background: true ratkaisee tämän: ne työskentelevät taustalla, pääkeskustelu jatkuu, ja 4–6 minuutin kuluttua saan tiiviit raportit ja teen muutokset.

Toinen esimerkki — raskas tutkimus. Kun valitsen aihetta uutta opasta varten, 4 aliagenttia kerää signaaleja rinnakkain:

  • V1 - foorumit ja yhteisöt viimeisten 14 päivän ajalta
  • V2 - sosiaaliset verkostot
  • V3 - videopalvelut + Anthropic-blogi
  • V4 - SEO-aukot

Kukin palauttaa 30–40 kohdetta viraalisuuspisteineen. Kokoan ne joukkoon, painotan 9 ulottuvuuden perusteella ja valitsen parhaan. Ilman aliagentteja tähän vaiheeseen kuluisi 2–3 tuntia ja se polttaisi pääkontekstia.

Milloin aliagenttia ei kannata tehdä.

  • Tehtävä, joka ei vaadi tiedostojen lukemista eikä WebFetchin käyttöä, kuuluu pääkeskusteluun.
  • Toistuva menettely kuuluu skilliin, mutta voi toimia aliagentissa eristyksen ollessa hyödyllinen.
  • Ulkoinen pääsy tarvitsee valtuutetun työkalun, kuten MCP:n tai CLI:n. Aliagentti voi käyttää työkalua, kun tehtävä delegoidaan sille.

Tärkein anti-pattern. Aliagentin luominen nimellä backend-engineer tai qa siinä toivossa, että Claude selvittää, milloin sitä käytetään. Tarkkarajaiset aliagentit (kuten migration-test-writer tai api-route-reviewer) tuottavat paljon paremman laadun kuin yleisagentit. Mitä täsmällisemmät aliagentin nimi ja ohjeet ovat, sitä tarkemmin Claude valitsee sen.

Ohjeita tiettyihin tehtäviin tarkoitettujen aliagenttien luomiseen, frontmatter-syntaksi ja 5 valmista esimerkkiä löytyvät oppaasta Claude Code Subagents in 2026: A Step-by-Step Guide.

Milloin tarvitset MCP:tä skillin tai aliagentin sijaan?

Keskeinen huomio

MCP tarjoaa työkaluja ja pääsyn dataan esimerkiksi tietokantoihin, GitHubiin, Sentryyn tai selaimeen. Käytä sitä työnkulun tarvitessa tätä pääsyä. Skill voi antaa menetelmän samojen työkalujen käyttämiseen. Kerrokset täydentävät toisiaan.

Anthropic esitti eron lyhimmän kaavan blogikirjoituksessa: MCP yhdistää Clauden dataan; skills-taidot opettavat Claudelle, mitä sillä datalla tehdään.

Esimerkiksi GitHub-ongelman katselmointiskill tarvitsee ongelman sisällön. Tarjoa se valtuutetun MCP-työkalun, CLI:n tai annetun tekstin kautta. Skill määrittää sitten katselmoinnin ja havaintojen jäsentämisen. Pelkkä MCP-pääsy ei määritä menettelyä.

Oma MCP-kokoonpanoni.

  • Playwright MCP - visuaalinen QA jokaiselle oppaalle. Avaa sivu tietokoneella ja mobiilissa, tarkista säilön leveys ja se, ovatko lohkot renderöityneet.
  • Stitch MCP - pääsy suunnittelujärjestelmään, komponenttien generointi brändin tyylillä.
  • vidIQ MCP - trendianalyysi ja ideoiden viraalisuuden tarkistaminen.
  • Railway MCP - käyttöönottoinfrastruktuurin hallinta.

Jokainen näistä neljästä on silta ulkoiseen järjestelmään. Ilman MCP:tä kirjoittaisin oman käärekoodin tai vaihtaisin selaimeen. MCP:n kanssa kaikki tapahtuu Claude-istunnon sisällä.

Token-kustannukset. MCP on kallein kerros. Jokainen yhdistetty palvelin vie jatkuvasti tilaa konteksti-ikkunasta: työkalujen määrittelyt, argumenttien skeemat ja kuvaukset. Minulla on 4 MCP-palvelinta — noin 8–12K tokenia jokaisessa uudessa istunnossa ennen kuin olen kysynyt mitään.

Tämä tarkoittaa, että yhdistämme MCP:n vain, jos sitä todella tarvitaan useimmissa istunnoissa. Jos käytät Sentry MCP:tä kerran viikossa, se kannattaa ottaa käyttöön tarpeen mukaan lipulla --mcp sentry sen sijaan, että pitäisit sen pysyvästi käytössä.

Milloin MCP:tä ei kannata käyttää.

  • Datan käsittelymenetelmä kuuluu skilliin, joka voi käyttää MCP:n tarjoamia työkaluja.
  • Pitkä lukutehtävä voi hyötyä aliagentista. Jos osa tiedostoista tai tietueista on ulkoisia, sama aliagentti voi tarvita myös MCP-pääsyn.
  • Julkaiseminen yhdellä komennolla vaatii hookin tai liitännäisen, ei MCP:tä.

Tärkein anti-pattern. MCP-palvelimen rakentaminen asialle, joka hoituu paremmin skillillä. Näin esimerkin HN-keskustelussa (siinä samassa ketjussa, jolla oli 422 pistettä 27. toukokuuta): kirjoittaja teki MCP-palvelimen, joka tarjosi ”koodikatselmoinnin ohjeita”. Kyseessä ei kuitenkaan ole pääsy ulkomaailmaan, vaan menettely. Skill tekee saman työn 10 kertaa pienemmällä token-kulutuksella.

Resurssien kilpailutilanne. Kerran Playwright MCP jumittui virheeseen ”Browser is already in use” — minulla oli samaan aikaan Chrome-ikkuna auki, eikä MCP pystynyt ottamaan selainta hallintaansa. Tästä oppii, että MCP-palvelin käyttää jaettuja järjestelmäresursseja. Jos resurssista kilpaillaan (selain, portti tai tiedosto), mieti eristämistä jo alusta asti.

Valmis opas 7 toimivan MCP:n yhdistämiseen löytyy oppaasta Claude Code MCP Servers in 2026: 7 Ready-to-Use Setups.

Milloin tarvitset liitännäisen skillin tai aliagentin sijaan?

Keskeinen huomio

Liitännäinen on jonkun muun paketoima kokonaisuus, joka sisältää skills-taitoja, aliagentteja, hookeja ja komentoja ja asennetaan yhdellä rivillä markkinapaikan kautta. Käytä sitä, kun et halua rakentaa kaikkea alusta asti ja luotat paketin tekijään — esimerkiksi frontend-suunnitteluun, Playwright-testaukseen tai Telegram-integraatioon.

Skills-taidot, aliagentit ja MCP koskevat omaa menetelmääsi. Liitännäinen on jonkun muun valmis menetelmä, jonka tuot omaan kokoonpanoosi.

Lokakuussa 2025 Anthropic julkaisi Claude Code Pluginsin, virallisen jakelumekanismin. Liitännäinen on hakemisto, joka voi sisältää:

  • omat kauttakomennot
  • omat skills-taidot
  • omat aliagentit
  • omat hookit
  • omat MCP-asetukset
  • omat tulostustyylit

Kaikki tämä paketoidaan yhdeksi nipuksi plugin.json-tiedoston kanssa. Asennus tapahtuu yhdellä rivillä tiedostossa ~/.claude/settings.json tai komennolla /plugin install <name>.

Oma liitännäiskokoonpanoni.

  • frontend-design virallisesta claude-plugins-official-markkinapaikasta — 67 tyyliä, 96 palettia, 57 fonttiparia ja 13 viitekehystä. Kun teen uuden lohkon sivustolle tai sähköpostimallin, lataan tämän liitännäisen ja saan koko kirjaston kerralla.
  • playwright samalta viralliselta markkinapaikalta — kokoelma skills-taitoja sekä MCP-asetuksia selaintestaukseen.
  • telegram — valmis kokonaisuus Telegram-tilin hallintaan Claude Codesta (käytäntö, sallittujen luettelo, pariliitos).
  • trailofbits/skills — Trail of Bitsin tietoturvataitojen kokoelma. Luotan yrityksen tietoturvaosaamiseen.

Kaikki 4 ovat kolme riviä tiedostossa settings.json. Ilman liitännäisiä käyttäisin tunteja saman kirjaston rakentamiseen käsin.

Milloin liitännäistä ei kannata käyttää.

  • Jos menetelmä on kokonaan omasi eikä sitä jaeta muille, pidä se skillinä.
  • Jos et vielä tiedä, kuka sitä käyttää, kokeile sitä ensin itse skillinä.
  • Jos sinun pitää nopeasti siirtää kolme tiedostoa uudelle koneelle, komento cp ~/.claude/skills/X /new/machine/.claude/skills/ riittää.

Tärkein anti-pattern. Liitännäisen käyttäminen CLAUDE.md:n korvikkeena — esimerkiksi liitännäinen, joka sisältää sääntöjä siitä, ”miten tässä projektissa toimitaan”. Liitännäinen on tarkoitettu jakeluun ja uudelleenkäyttöön. Jos säännöt koskevat vain yhtä repositoriota, ne kuuluvat CLAUDE.md:hen, eivät liitännäiseen.

Vuoteen 2026 katsottaessa Anthropic näyttää selvästi suuntaavan tiimien liitännäismarkkinapaikkaan. Yritykset voivat siis julkaista sisäisiä menetelmiään liitännäisinä, versioida ne ja päivittää ne kaikille työntekijöille yhdellä komennolla. Yksinyrittäjälle tämä tarkoittaa: asenna valmiit ratkaisut äläkä keksi niitä uudelleen.

Päätöspuu: 4 kysymystä ennen jokaista tehtävää

Keskeinen huomio

Vastaa kaikkiin neljään kysymykseen toisistaan riippumatta. Jokainen ”kyllä” tunnistaa tarpeen. Jatka muiden kysymysten läpikäyntiä, koska sama työnkulku voi yhdistää useita kerroksia. Jos kaikki vastaukset ovat ”ei”, tavallinen kehote ja projektiohjeet voivat riittää.

Kysymys 1: onko toistettava menettely säilyttämisen arvoinen?

Jos on, paketoi menetelmä skilliksi SKILL.md-tiedostoon selkeällä käyttökuvauksella. Tämä antaa menettelyn, ei itsessään ulkoista pääsyä tai erillistä kontekstia.

Kysymys 2: tarvitseeko työ erillisen kontekstin tai rajatun delegoidun roolin?

Jos tarvitsee, käytä aliagenttia. Anna sille täsmällinen tehtävä ja työkalut. Sama tehtävä voi noudattaa skillin menetelmää eristetyssä kontekstissa.

Kysymys 3: tarvitseeko tehtävä työkalua tai pääsyä ulkoiseen dataan?

Jos tarvitsee, tarjoa valtuutettu pääsy MCP:n tai muun sopivan työkalun, kuten jo määritetyn CLI:n, kautta. Skill kuvaa pääsyn käyttömenettelyn, ja aliagentti voi olla sitä käyttävä toimija.

Kysymys 4: pitääkö tämä kokoonpano jakaa ja ylläpitää pakettina?

Jos pitää, käytä liitännäistä tarvittavien skillien, agenttimääritysten, hookien tai MCP-asetusten jakeluun. Paketti voi olla omasi tai toisen tekijän toimittama.

Yhdistetty esimerkki: toistuva GitHub-ongelman katselmointi. Skill määrittää katselmointimenettelyn ja tulosmuodon. Määritetty GitHub MCP tai CLI antaa valtuutetun pääsyn ongelmaan. Aliagentti voi lukea pitkän ketjun omassa kontekstissaan ja palauttaa havainnot. Liitännäinen voi jakaa yhdistelmän tiimille. Kaikki neljä vastausta voivat olla ”kyllä”; mikään ei kumoa toista.

5 kerrosvalinnan virhettä, joita vibe coderit tekevät

Keskeinen huomio

Kalleimmat virheet ovat aliagentin käyttäminen skillin sijaan, MCP:n käyttäminen skillin sijaan, liitännäisen käyttäminen CLAUDE.md:n sijaan ja skillin käyttäminen hookin kautta. Jokainen kuluttaa tokeneita tai rikkoo toimintaa. Näytän konkreettisilla esimerkeillä, mitä tapahtui ja mitä olisi pitänyt tapahtua.

Näen nämä 5 mallia kerran viikossa niiden vibe coderien keskuudessa, joiden kanssa työskentelen. Joka toinen tekee vähintään yhden niistä ensimmäisellä viikollaan.

Virhe 1: aliagentti skillin sijaan.

Oire: kirjoittaja teki aliagentin ”uuden blogikirjoituksen kirjoittamista” varten. Joka kerta, kun aliagentti käynnistetään, se latautuu, lukee 2 KB menetelmää, luo kirjoituksen ja sulkeutuu. Viikon kuluttua kirjoittaja huomaa, että jokainen ajokerta kuluttaa ylimääräiset 5K tokenia aliagentin lataamiseen.

Mitä pitäisi tehdä: ”miten kirjoitus tehdään” on menetelmä — siis skill. Käynnistimenä on lause ”uusi blogikirjoitus”. Skill latautuu pääkeskusteluun eikä avaa erillistä istuntoa. Se on 3–5 kertaa edullisempi.

Virhe 2: MCP-palvelin skillin sijaan.

Oire: kirjoittaja teki MCP-palvelimen, joka tarjoaa ohjeita siitä, ”miten koodikatselmointi tehdään”. Työkalujen määrittelyt, argumenttien skeemojen kuvaukset ja dokumentaatio vievät jatkuvasti tilaa kontekstista. Jokainen pyyntö tuhlaa 2–3K tokenia turhaan.

Mitä pitäisi tehdä: ”miten koodikatselmointi tehdään” on menettely, ei pääsy ulkoiseen järjestelmään. Käytä skill-taitoa. MCP on perusteltu vain, jos tarvitset reaaliaikaisen pääsyn esimerkiksi Sentryyn uusimpien virheiden hakemiseksi.

Virhe 3: liitännäinen CLAUDE.md:n sijaan.

Oire: kirjoittaja paketoi projektin säännöt (”käytä aina TypeScriptin strict-tilaa”, ”älä käytä ajatusviivoja”, ”käytä vain pnpm:ää, älä npm:ää”) liitännäiseen ja asensi sen. Jokaisessa uudessa istunnossa ladataan nyt liitännäinen, joka kopioi CLAUDE.md:hen kuuluvat asiat.

Mitä pitäisi tehdä: yhden projektin säännöt kuuluvat kyseisen projektin CLAUDE.md-tiedostoon. Liitännäinen on menetelmää varten, joka sopii useille ihmisille tai repositorioille.

Virhe 4: yritetään tehdä skill hookin kautta.

Oire: kirjoittaja huomasi, että hook käynnistyy automaattisesti tapahtuman yhteydessä (esimerkiksi ennen tiedoston tallentamista). Hän päätti tehdä ”skillin hookin kautta”, jotta Claude soveltaisi menetelmää automaattisesti jokaisen muokkauksen yhteydessä. Tuloksena oli loputon käynnistyssilmukka, kontekstin kuluminen ja arvaamaton toiminta.

Mitä pitäisi tehdä: hook on determinististä koodia, joka suorittaa komennon, muotoilee tuloksen tai estää toiminnon. Hook ei lataa skill-taitoa eikä käynnistä Claudea. Jos haluat, että ”menetelmää X sovelletaan aina”, käytä joko käynnistimellä varustettua skill-taitoa tai CLAUDE.md:n merkintää.

Virhe 5: ylimääräinen kerros, vaikka mitään ei tarvita.

Oire: kirjoittaja kuulee skills-taidoista, lukee oppaita, päättää ”minun pitää paketoida tämä menetelmä” ja käyttää illan sellaisen skillin luomiseen tehtävää varten, joka tulee vastaan kerran kuussa.

Mitä pitäisi tehdä: kertaluonteinen tehtävä kuuluu keskusteluun, tilapäisesti. Skill on perusteltu vain, jos teet asian useammin kuin kerran päivässä. Muussa tapauksessa se on yliteknistämistä, jota pitää myöhemmin ylläpitää.

Tarkista näissä esimerkeissä tarpeet itsenäisesti: menettely, kontekstin tai roolin eristys, työkalupääsy ja jakelu. Lisää kerros, jolla on konkreettinen tarkoitus, ja yhdistä kerroksia tehtävän tarvitessa useampaa.

Mitä Anthropic sanoo pirstaloitumisesta: mihin Claude Code suuntaa vuonna 2026

Keskeinen huomio

Claude Code on yhdistämässä koodikatselmoinnin kerroksia: viisi tapaa (komento, taito, aliagentti, liitännäinen tai keskustelu) ovat lähentymässä yhtä sisäänrakennettua /code-review-taitoa. Älä siis huolestu ”liian monista kerroksista” — vuonna 2026 rajat hämärtyvät ja ratkaisut yksinkertaistuvat.

Mitä tämä tarkoittaa seuraavien kuuden kuukauden tai vuoden aikana?

Ensinnäkin skills-taidoista on tulossa proseduraalisten tehtävien pääkerros. Anthropic panostaa selvästi tähän kerrokseen, koska se on edullisin ja ennustettavin. Jos et ymmärrä, miksi vuonna 2026 tarvitaan skill-taitoa, perehdy ensin siihen. Kaikki muut kerrokset kiertyvät sen ympärille.

Toiseksi aliagenteista tulee erikoistuneita. Aliagenttien pääasiallinen tarkoitus on eristää raskaan tehtävän konteksti. Yleiset aliagentit, kuten qa-engineer, katoavat; tarkkarajaiset aliagentit, kuten migration-test-writer ja api-route-reviewer, säilyvät.

Kolmanneksi Anthropicin uudet ilmoitukset 14 päivän aikana — /workflows-komento (28. toukokuuta 2026) kymmenien aliagenttien orkestrointiin sekä Agent SDK:n laskutuksen erottaminen 15. kesäkuuta alkaen — tarkoittavat, että ohjelmallinen käyttö siirtyy erilliseen kiintiöön. Tämä on merkki siitä, että Anthropic rakentaa infrastruktuuria 10+ agentin automaattisille järjestelmille yksittäisten istuntojen sijaan.

Vuoden 2026 vibe coderille tämä tarkoittaa yhtä yksinkertaista asiaa: neljä kerrosta säilyvät käytössä ainakin vielä kuusi kuukautta, minkä jälkeen osa niistä yhdistyy. Neljän kysymyksen päätöspuu toimii silti yhdistämisen jälkeenkin — se koskee tehtävän luonnetta, ei kerroksen täsmällistä nimeä.

Valmis matriisi: 10 tyypillistä tehtävää → oikea kerros

Keskeinen huomio

Taulukko tunnistaa kunkin tilanteen ensisijaisen tarpeen. Rivit täydentävät toisiaan: tehtävä voi sopia useaan riviin ja yhdistää niissä luetellut kerrokset.

#KäynnistystilanneOikea kerrosMiksi tämä kerros
1Claude unohtaa saman säännön istunnon aikana 2–3 kertaaCLAUDE.mdReagoi tarpeeseen, on aina kontekstissa eikä vaadi käynnistintä
2Kirjoitan saman pitkän kehotteen useammin kuin kerran päivässäSkillLatautuu tarvittaessa eikä kuluta perustason kontekstia
3Liitän 1 500 sanan toimintaohjeen keskusteluun kolmannen kerranSkillMenetelmä, joka ladataan käynnistyslauseella
4Tehtävä ahmii pääkeskustelun luettavaksi 20+ tiedoston vuoksiAliagenttiKonteksti eristetään; vain yhteenveto palautuu pääkeskusteluun
5Tarvitsen 5 samanlaista tarkistusta rinnakkain (QA, katselmointi, lint)AliagentitKäynnistetään asetuksella run_in_background; kokonaiskesto lyhenee viisinkertaisesti
6Haluan lukea GitHub-ongelmia tai Sentryn uusimmat virheetMCPSuora pääsy ulkoiseen järjestelmään standardoidun protokollan kautta
7Haluan tarkistaa kattamani push-operaation automaattisestiTestattu hookDeterministinen tarkistus; varmista todellinen käynnistin ja estokäytös
8Haluan siirtää kokoonpanoni toiseen repositorioon tai uudelle koneelleLiitännäinenJakelu markkinapaikan ja nimiavaruuden kautta
910 hengen tiimin täytyy noudattaa samoja sääntöjäTiimin markkinapaikan liitännäinenVersioidaan, asennetaan kerran ja päivitetään keskitetysti
10Pitää vastata ulkoisen palvelun webhookiin (Telegram, GitHub Actions)MCP-kanava tai Agent SDKTyöntää viestit istuntoon ulkomaailmasta

Taulukon käytön pääsääntö on, ettei yritä ”tehdä kaikkia 10 asiaa kerralla”. Useimmat yksin työskentelevät vibe coderit pärjäävät CLAUDE.md:llä, 5–7 skill-taidolla ja 2–4 MCP-palvelimella. Aliagentit ja liitännäiset otetaan käyttöön projektin kasvaessa.

Mitä seuraavaksi: näin rakennat työtilan Claude Codeen

Keskeinen huomio

CLAUDE.md sisältää projektin perussäännöt, skills-taidot paketoivat menetelmät, aliagentit jakavat raskaan kontekstin, MCP yhdistää ulkomaailmaan ja liitännäiset jakavat jonkun muun valmiit kokonaisuudet. Nämä ovat Claude Code -kokoonpanosi viisi rakennuspalikkaa vuonna 2026.

Nämä viisi kerrosta eivät ole peräkkäin, vaan ne sopivat sisäkkäin. CLAUDE.md on projektin perusta, ja muut neljä yhdistetään tehtävien kasvaessa.

Tutustu Ailootiin.

Lisätietoja

Kysymyksiä tästä oppaasta: Skills-taidot, aliagentit, MCP ja liitännäiset Claude Codessa: mitä valita

Voiko yksi GitHub-katselmointi tarvita skillin, aliagentin ja MCP:n yhdessä?

Kyllä. Skill määrittää menettelyn, MCP tai valtuutettu CLI antaa ongelman tiedot, ja aliagentti voi tehdä pitkän katselmoinnin omassa kontekstissaan. Liitännäinen voi jakaa yhdistelmän.

Miten käytän neljän kysymyksen tarkistuslistaa?

Vastaa jokaiseen itsenäisesti: tarvitsenko menettelyn, kontekstieristyksen, työkalupääsyn tai jakelun? Jokainen kyllä lisää konkreettisen vaatimuksen. Ensimmäinen kyllä ei päätä valintaa.

Kaikki artikkelit