Lumaktaw patungo sa pangunahing content

Mga Skill at Kasangkapan

Nasa .agents/skills/ ang mga nakabahaging skill. I-edit ang mga source na ito, at saka patakbuhin ang yarn ai-workflow:sync upang buuin ang .claude/skills/ para sa Claude Code. Direktang hinahanap ng Codex ang mga skill sa .agents/skills/.

Nasa .agents/roles/*.md ang mga nakabahaging role prompt. Isa itong format ng source na tiyak sa repository na ito, hindi native na discovery path ng ahente. Kino-convert ng scripts/ai-workflow-files.mjs ang mga source na ito sa mga file na tiyak sa bawat app na nasa ibaba; isinusulat ang mga ito ng yarn ai-workflow:sync. I-commit ang mga nabuong file kasama ng kanilang mga source para magkaroon ang isang bagong checkout ng native na configuration nang hindi muna nagpapatakbo ng generator. Pagkatapos mag-alis ng source, tahasang alisin ang mga lipas na output na nabuo mula rito; iniuulat ng validator ang mga ito sa halip na tahimik na magbura ng mga file.

Mga native na discovery path​

Na-verify laban sa opisyal na dokumentasyon noong 2026-09-12:

AppMga tagubilin ng proyektoMga skill na ginagamit ng repository na itoMga custom agent na ginagamit ng repository na ito
CodexAGENTS.md.agents/skills/<name>/SKILL.mdNabuong .codex/agents/<name>.toml
Claude CodeIni-import ng CLAUDE.md ang @AGENTS.mdNabuong .claude/skills/<name>/SKILL.mdNabuong .claude/agents/<name>.md

Mga sanggunian: Mga skill ng Codex, Mga subagent ng Codex, Memory ng Claude, Mga skill ng Claude, Mga subagent ng Claude.

Huwag palitan ng .agents/roles ang mga native na direktoryo ng ahente, at huwag ipagpalagay na tinutuklas ng Claude ang .agents/skills. Maaari pa ring basahin ng Claude ang isang file doon na tinutukoy, bilang ordinaryong konteksto ng proyekto.

Gumagamit ang mga AI directory ng LF line ending sa pamamagitan ng .gitattributes para manatiling magkapareho ang nabuong teksto sa iba't ibang platform. Kinokopya bilang mga byte ang mga sumusuportang asset ng skill.

Mga skill​

SkillLayunin
commitGumawa ng awtorisado at may-saklaw na mga lokal na commit
commit-format, issue-formatMga mungkahi sa format kapag hiniling
make-closed-issueGumawa ng awtorisadong isyu, may-saklaw na commit at PR
review-and-merge-prI-triage ang feedback sa PR; mag-ayos/mag-publish/mag-merge lamang sa loob ng hiniling na saklaw
fix-merge-conflictsLutasin ang mga conflict at i-verify ang na-merge na resulta
releaseIhanda ang pananalita ng release at isagawa ang mga awtorisadong hakbang sa release
code-quality-reviewSuriin ang mga hindi simpleng diff o ang isang tahasang hiniling na alalahanin sa kalidad
retroGawing mga nakatutok na pagsusuri o gabay ang mga napatunayang pagkakamali upang hindi na maulit ang mga ito
refactor-pass, deslopHiniling na paglilinis ng mga umiiral na pagbabago
debug-agentPag-debug na nakabatay sa ebidensiya, may instrumentation kapag kailangan
you-might-not-need-an-effectNakatutok na review ng effect/memo
vercel-react-best-practicesNaaangkop na gabay sa performance ng React; laktawan ang mga panuntunang para lamang sa Next.js/server para sa Vite client na ito
translateBumuo ng mga salin, at saka ilapat ang mga mapa sa pamamagitan ng iisang writer
playwright-cli, inspect-elementsPag-verify sa browser at pagmamapa mula DOM patungong source
profile-browsingMay-saklaw na profiling ng browser at React
test-apkI-verify ang isang ibinigay na kasamang Android wrapper
impeccable, improve-threejsMay-saklaw na disenyo ng interface at review ng Three.js rendering
implement-planIsagawa ang isang plano na may opsyonal at limitadong delegasyon
readmePanatilihin ang beripikadong dokumentasyon ng proyekto
context7Kunin ang dokumentasyon ng library na angkop sa bersyon
find-skillsMaghanap ng karagdagang skill kapag tahasang hiniling

Mga role at modelo​

Panatilihin ang mga custom role para sa browser-check, profiler, test-apk, translator, at reviewer. Gamitin ang built-in na worker/general-purpose o explorer role ng harness para sa ordinaryong implementasyon at pagtuklas ng code. Itinatalaga ng magulang na ahente ang mga pamantayan sa pagtanggap at ang pagmamay-ari; iisang may-ari ang nagpapatakbo ng mabibigat na pagsusuri.

Kasama sa mga agent file ng Codex ang name, description, at developer_instructions. Nililimitahan ng .codex/config.toml sa apat ang sabay-sabay na anak na ahente gamit ang max_concurrent_threads_per_session. Naglalaman ang nakabahaging metadata ng role ng pangalan, paglalarawan, at opsyonal na sandbox mode; sadyang wala itong mga field ng modelo.

Huwag isama ang mga field ng modelo at reasoning sa mga naka-commit na skill at custom agent. Pinapayagan nito ang mga pagpili sa oras ng pagtawag, ang mga default ng user, at ang pagmamana mula sa magulang na ahente ayon sa nakadokumentong precedence ng bawat app. Binabawasan ng mga family alias ng Claude ang pagpapanatili ng bersyon ngunit pumipili pa rin ang mga ito ng isang family. Itago ang ganitong mga pagpili sa mga setting ng user/session kapag kailangan. Hindi nangangako ang pagmamana ng awtomatikong pagpili ng pinakamahusay na kasalukuyang modelo. Huwag mag-imbento ng alias na latest o magdagdag ng pananaliksik sa model catalog sa mga karaniwang gawain. Tingnan ang pagpili sa Codex at pagpili sa Claude.

Nagmamapa ang sandbox-mode: read-only sa sandbox ng Codex. Nililimitahan ng listahan ng tool ng Claude at ng mga tagubilin ng role ang review workflow nito, ngunit hindi OS-level na sandbox ang access sa Bash.

Gumagamit ang frontmatter ng nakabahaging skill ng disable-model-invocation: true para sa mga workflow na tinatawag ng user kung saan naaangkop. Nasa agents/openai.yaml ang katumbas na setting ng Codex bilang policy.allow_implicit_invocation: false; hinihingi ng validator ang dalawa. Dinadagdagan ng invocation metadata ang mga tahasang panuntunan sa awtorisasyon; hindi kailanman nagbibigay ng awtorisasyon sa paglalathala ang isang kahilingan sa review dahil lamang may mga hakbang sa paglalathala ang isang skill.

Mga pagsusuri at pagtuklas​

  • Muling binubuo ng yarn ai-workflow:sync ang mga compatibility output gamit ang naka-install na js-yaml at smol-toml.
  • Pina-parse ng yarn ai-workflow:check ang source/frontmatter/mga config, at sinusuri nito ang mga nabuong output, ang invocation metadata, ang paglalagay ng mga field ng modelo, at ang wiring ng hook na para lamang sa formatter. Hindi nito nireresolba ang mga identifier ng modelo laban sa catalog ng provider.
  • Pinapatakbo ng yarn ai-workflow:test ang mga hiwalay na Node fixture para sa mga payload ng hook at sa pagbuo/pag-validate ng workflow.
  • Pagkatapos i-upgrade ang isang agent application, i-verify ang pagtuklas ng skill/role sa application na iyon. Hindi napapalitan ng mga pagsusuri sa syntax/parity ang pagsusuri sa loader. I-reload ang application kung may lumang catalog pa rin ang isang umiiral na session.
  • Nangangailangan ang mga hook ng project trust at hook review ng harness; huwag lampasan ang trust para lang pumasa ang isang pagsusuri. Tingnan ang hooks-setup.md.

Pagpapanatili ng kapaki-pakinabang na mga tagubilin​

Sundin ang gabay ng OpenAI sa mga skill at prompt (sinuri noong 2026-09-12): panatilihing tumpak ang mga paglalarawan, i-load lamang ang mga detalye kapag kaugnay, at panatilihin ang saklaw na hiniling ng user. Naglilingkod ang mga nakabahaging skill sa iba't ibang modelo; panatilihin ang mga invariant na tiyak sa proyekto habang pinapayagan ang mga karaniwang pagpili sa implementasyon.

Panatilihin sa SKILL.md ang layunin ng isang skill, ang mga hangganan ng desisyon nito, at ang mahahalagang limitasyon. I-link bilang opsyonal na reference ang malalaking command o halimbawa na tiyak sa isang mode. Ilagay nang maaga sa maiikling paglalarawan ang mga kondisyon ng pag-trigger; hindi dapat palawakin ng isang tumutugmang keyword lamang ang gawain. Panatilihin ang umiiral na invocation metadata maliban kung sinasadyang baguhin ang gawi nito.

Pagkatapos ng malaking pagbabago sa tagubilin, subukan ang ilang kinatawang maliit at malaking kahilingan. Suriin kung aling mga skill/reference ang napili, kung nanatili sa saklaw ang mga aksyon, kung tumugma ang pag-verify sa pagbabago, at kung natapos ang awtorisadong gawain. Pinatutunayan ng mga schema at fixture test ang kawastuhan ng tooling, hindi ang kalidad ng desisyon ng ahente.

Mga kasangkapan at pagmamay-ari ng browser​

Mas piliin ang umiiral na skill/tool catalog at ang mga naka-install na CLI ng proyekto. Gamitin ang gh para sa GitHub, ang playwright-cli para sa pag-verify sa browser, at ang opisyal na dokumentasyong tiyak sa bersyon kapag mahalaga ang gawi ng library. Iwasang mag-install ng mga dobleng skill o kumuha ng package na hindi naka-pin para lang magpatakbo ng umiiral na formatter.

Nakadepende sa harness ang overhead ng MCP: maaaring maiwasan ng deferred tool loading ang paglo-load ng bawat schema sa simula pa lamang. Panatilihing kaugnay ang mga integration sa halip na ituring na lipas na ang MCP mismo. Nananatiling kapaki-pakinabang ang mga umiiral na pagpili ng CLI para sa reproducibility at kontrol sa resource.

Gumagamit ang lahat ng browser session ng ./scripts/pw-session.sh, na nagpapatupad ng iisang aktibong browser sa buong makina. Bilang default, gumamit ng bago at hiwalay na session. Nangangailangan ng tahasang awtorisasyon ang kasalukuyang access sa personal na browser; muling gamitin ang awtorisasyong iyon sa mga susunod na hakbang. Pumili ng mga browser/viewport para sa apektadong gawi, patakbuhin nang sunod-sunod ang mga napiling engine, isara ang eksaktong pinangalanang session sa paglilinis, at huwag kailanman gumamit ng close-all/kill-all. Tingnan ang playwright-cli skill at ang verification.md.