Hopp over til hovedinnhold

Ferdigheter og verktøy

Delte ferdigheter ligger i .agents/skills/. Rediger disse kildene, og kjør deretter yarn ai-workflow:sync for å generere .claude/skills/ for Claude Code. Codex finner ferdigheter direkte i .agents/skills/.

Delte rolleprompter ligger i .agents/roles/*.md. Dette er et repospesifikt kildeformat, ikke en native sti der agenter oppdages. scripts/ai-workflow-files.mjs konverterer disse kildene til de appspesifikke filene nedenfor; yarn ai-workflow:sync skriver dem. Sjekk inn de genererte filene sammen med kildene deres, slik at en fersk utsjekk har den native konfigurasjonen uten å kjøre en generator først. Når du fjerner en kilde, fjern de foreldede genererte filene eksplisitt; validatoren rapporterer dem i stedet for å slette filer i stillhet.

Native oppdagelsesstier​

Verifisert mot offisiell dokumentasjon 2026-09-12:

AppProsjektinstruksjonerFerdigheter dette repoet brukerEgendefinerte agenter dette repoet bruker
CodexAGENTS.md.agents/skills/<name>/SKILL.mdGenerert .codex/agents/<name>.toml
Claude CodeCLAUDE.md importerer @AGENTS.mdGenerert .claude/skills/<name>/SKILL.mdGenerert .claude/agents/<name>.md

Kilder: Codex-ferdigheter, Codex-underagenter, Claude-minne, Claude-ferdigheter, Claude-underagenter.

Ikke erstatt de native agentmappene med .agents/roles, og ikke anta at Claude oppdager .agents/skills. Claude kan fortsatt lese en fil det henvises til der, som vanlig prosjektkontekst.

AI-mappene bruker LF-linjeskift gjennom .gitattributes, slik at generert tekst forblir identisk på tvers av plattformer. Støttefiler for ferdigheter kopieres byte for byte.

Ferdigheter​

FerdighetFormål
commitLage autoriserte, avgrensede lokale commits
commit-format, issue-formatFormatere forslag når det blir bedt om det
make-closed-issueOpprette en autorisert issue, en avgrenset commit og en PR
review-and-merge-prSortere tilbakemeldinger på PR-er; rette/publisere/merge bare innenfor det forespurte omfanget
fix-merge-conflictsLøse konflikter og verifisere det sammenslåtte resultatet
releaseForberede utgivelsestekst og utføre autoriserte utgivelsessteg
code-quality-reviewGjennomgå ikke-trivielle differ eller et eksplisitt forespurt kvalitetsproblem
retroGjøre påviste feil om til målrettede sjekker eller veiledning som hindrer gjentakelse
refactor-pass, deslopForespurt opprydding i eksisterende endringer
debug-agentBevisbasert feilsøking, med instrumentering ved behov
you-might-not-need-an-effectMålrettet gjennomgang av effekter/memo
vercel-react-best-practicesGjeldende React-ytelsesveiledning; hopp over regler for Next.js eller bare server for denne Vite-klienten
translateGenerere oversettelser og deretter ta i bruk map-filer gjennom én enkelt skriver
playwright-cli, inspect-elementsNettleserverifisering og kobling fra DOM til kildekode
profile-browsingAvgrenset nettleser- og React-profilering
test-apkVerifisere en levert Android-wrapper for følgeappen
impeccable, improve-threejsAvgrenset grensesnittdesign og gjennomgang av Three.js-rendering
implement-planGjennomføre en plan med valgfri, avgrenset delegering
readmeVedlikeholde verifisert prosjektdokumentasjon
context7Hente biblioteksdokumentasjon som passer til versjonen
find-skillsFinne flere ferdigheter når det eksplisitt blir bedt om det

Roller og modeller​

Behold egendefinerte roller for browser-check, profiler, test-apk, translator og reviewer. Bruk harnessens innebygde worker-/general-purpose- eller explorer-rolle til vanlig implementering og kodeutforsking. Foreldreagenten tildeler akseptansekriterier og eierskap; én eier kjører tunge sjekker.

Codex-agentfiler inneholder name, description og developer_instructions. .codex/config.toml begrenser antall samtidige underagenter til fire med max_concurrent_threads_per_session. Delte rollemetadata inneholder navn, beskrivelse og valgfri sandkassemodus; de har bevisst ingen modellfelt.

Utelat modell- og resonneringsfelt fra innsjekkede ferdigheter og egendefinerte agenter. Det gir rom for valg ved kjøring, brukerens standardinnstillinger og arv fra foreldreagenten i tråd med hver apps dokumenterte forrangsregler. Familiealiaser for Claude reduserer versjonsvedlikehold, men velger fortsatt en familie. Hold slike valg i bruker-/øktinnstillinger ved behov. Arv lover ikke at den beste gjeldende modellen velges automatisk. Ikke finn på et latest-alias, og ikke legg til research i modellkataloger i rutineoppgaver. Se modellvalg i Codex og modellvalg i Claude.

sandbox-mode: read-only tilsvarer sandkassen i Codex. For Claude begrenser verktøylisten og rolleinstruksjonene gjennomgangsarbeidsflyten, men Bash-tilgang er ikke en sandkasse på OS-nivå.

Delt frontmatter for ferdigheter bruker disable-model-invocation: true for arbeidsflyter som brukeren starter selv, der det er relevant. Den tilsvarende innstillingen i Codex ligger i agents/openai.yaml som policy.allow_implicit_invocation: false; validatoren krever begge. Metadata for kall supplerer eksplisitte autorisasjonsregler; en forespørsel om gjennomgang gir aldri tillatelse til publisering bare fordi en ferdighet inneholder publiseringssteg.

Sjekker og oppdagelse​

  • yarn ai-workflow:sync genererer kompatibilitetsfilene på nytt med installert js-yaml og smol-toml.
  • yarn ai-workflow:check parser kilder/frontmatter/konfigurasjoner og sjekker genererte filer, kallmetadata, plasseringen av modellfelt og koblingen av hooken som bare formaterer. Den slår ikke opp modellidentifikatorer i en leverandørs katalog.
  • yarn ai-workflow:test kjører isolerte Node-fixtures for hook-nyttelaster og generering/validering av arbeidsflyten.
  • Etter at du har oppgradert en agentapplikasjon, verifiser at ferdigheter/roller oppdages i den applikasjonen. Syntaks-/paritetssjekker erstatter ikke en sjekk av innlastingen. Last inn applikasjonen på nytt hvis en eksisterende økt holder på en gammel katalog.
  • Hooks krever harnessens prosjekttillit og hook-gjennomgang; ikke omgå tilliten for å få en sjekk til å bestå. Se hooks-setup.md.

Vedlikehold av nyttige instruksjoner​

Følg OpenAIs veiledning om ferdigheter og prompter (gjennomgått 2026-09-12): hold beskrivelsene presise, last inn detaljer bare når de er relevante, og hold deg innenfor omfanget brukeren ba om. Delte ferdigheter betjener ulike modeller; behold prosjektspesifikke invarianter og gi rom for rutinemessige implementeringsvalg.

Hold en ferdighets formål, beslutningsgrenser og vesentlige begrensninger i SKILL.md. Lenk til omfattende modusspesifikke kommandoer eller eksempler som valgfrie referanser. Plasser utløserbetingelser tidlig i korte beskrivelser; et samsvarende nøkkelord alene skal ikke utvide oppgaven. Behold eksisterende kallmetadata med mindre atferden bevisst endres.

Etter en betydelig endring i instruksjonene, prøv ut noen representative små og store forespørsler. Sjekk hvilke ferdigheter/referanser som ble valgt, om handlingene holdt seg innenfor omfanget, om verifiseringen passet til endringen, og om det autoriserte arbeidet ble fullført. Skjema- og fixture-tester fastslår at verktøyene er korrekte, ikke kvaliteten på agentens beslutninger.

Verktøy og eierskap til nettleseren​

Foretrekk den eksisterende ferdighets-/verktøykatalogen og prosjektets installerte CLI-er. Bruk gh for GitHub, playwright-cli for nettleserverifisering og offisiell/versjonsspesifikk dokumentasjon når bibliotekets atferd betyr noe. Unngå å installere dupliserte ferdigheter eller hente en ulåst pakke bare for å kjøre en eksisterende formaterer.

MCP-overhead avhenger av harnessen: utsatt innlasting av verktøy kan unngå at hvert skjema lastes inn på forhånd. Hold integrasjonene relevante i stedet for å behandle MCP i seg selv som foreldet. Eksisterende CLI-valg er fortsatt nyttige for reproduserbarhet og ressurskontroll.

Alle nettleserøkter bruker ./scripts/pw-session.sh, som håndhever én aktiv nettleser på hele maskinen. Bruk som standard en fersk, isolert økt. Tilgang til den nåværende personlige nettleseren krever eksplisitt autorisasjon; gjenbruk den autorisasjonen i påfølgende steg. Velg nettlesere/visningsporter ut fra den berørte atferden, kjør utvalgte motorer etter hverandre, lukk nøyaktig den navngitte økten under opprydding, og bruk aldri close-all/kill-all. Se ferdigheten playwright-cli og verification.md.