Блог

Codex дағдылары: қайталанатын тапсырмаларға арналған дағдыны жасау

Markdown

SKILL.md құрылымы, жүктелетін жолдар, қолмен және автоматты іске қосу, нәтиже критерийлері және дағдыны Claude Code-қа көшіру.

Мақаланы толық оқу

Егер Codex-ке аптасына бес рет бір нәрсені — есепті қалай пішімдеу, электрондық хаттарды қалай сұрыптау немесе мәтінді өз стиліңізде қалай дайындау керегін — түсіндірсеңіз, сол нұсқауларды дағдыға бір рет жазып қоюға болады. Одан кейін агент тапсырма сипаттамасына сәйкес келгенде, дағдыны сипаттамасы бойынша табады немесе оны өзіңіз қолмен іске қоса аласыз. Дағды — SKILL.md деп аталатын мәтіндік файлы бар кәдімгі бума; қарапайым жағдайда оны пайдалану үшін бағдарламалау қажет емес.

Төменде дағдының құрылымын, Codex оны қайдан іздейтінін, оны қадамдап қалай жасау керегін және құнына қарай модельді қалай таңдау керегін қарастырамыз. Пәрмендер мен бағалар 2026 жылғы 20 қыркүйектегі OpenAI ресми құжаттамасына негізделген. Codex орнату нұсқауларын бұл жерде қайталамаймыз; олар OpenAI Codex: бұл не, оны қалай орнатып, іске қосуға болады нұсқаулығында берілген.

Ailoot қызметін пайдалану туралы практикалық ақпарат құжаттамада берілген.

Codex-тегі дағды деген не?

Негізгі түйін

Codex дағдысы — процесті сипаттайтын SKILL.md файлы бар бума: не істеу керек, нені негізге алу керек және жақсы нәтиже қандай болатыны көрсетіледі. Codex бастапқыда контексте дағдылардың атаулары мен сипаттамаларын ғана сақтап, дағдыны пайдалануды ұйғарғанда толық нұсқауларды жүктейді.

Бұл пішім Agent Skills деп аталады. Оны бастапқыда Anthropic әзірлеп, agentskills.io сайтында ашық стандарт ретінде жариялаған. Оны Codex, Claude Code және басқа үйлесімді клиенттерді қоса алғанда, әртүрлі агент қолдайды. Тек мәтіндік нұсқаулардан тұратын қарапайым дағдыны бумасын көшіру арқылы олардың арасында тасымалдауға болады. Егер онда скрипттер, тәуелділіктер немесе agents/openai.yaml файлы болса, көшіргеннен кейін дағдыны тексеріңіз: кейбір параметрлер белгілі бір клиентке ғана тән.

Бұл жүктеу тәсілі прогрессивті ашу деп аталады. Агент дағдының атауы мен сипаттамасын оның қай кезде қажет екенін анықтау үшін пайдаланады. Тапсырма сипаттамаға сәйкес келсе, агент толық SKILL.md файлын оқып, ондағы нұсқауларды орындайды. Осылайша, барлық нұсқауларды контекске жүктемей-ақ, Codex-те ондаған дағдыны сақтауға болады: бастапқы тізім контекст терезесінің 2%-ынан аспайды (терезе өлшемі белгісіз болса, 8 000 таңбадан аспайды). Дағдылар көп болса, Codex әуелі олардың сипаттамаларын қысқартады; ал жиыны өте үлкен болса, тізімнен кейбірін алып тастап, сізге хабарлауы мүмкін.

Дағдыны AGENTS.md файлымен шатастыру оңай. Codex бұл файлды әр жоба сессиясында оқиды. Онда технологиялар жиыны, келісімдер және кодтау стилі сияқты тұрақты ережелер жазылады. Ал дағды тапсырма сәйкес келгенде қажетіне қарай жүктеледі. Сондықтан тұрақты ережелерді AGENTS.md файлына, ал қадамдары бар қайталанатын процесті дағдыға жазыңыз.

Hermes Agent дағдылары да осыған ұқсас жұмыс істейді, бірақ басқа бумаларда сақталып, басқаша орнатылады. Олар бөлек нұсқаулықта қарастырылған: Hermes Agent дағдылары: орнату және жасау. Бұл мақала тек Codex туралы.

Дағды неден тұрады?

Негізгі түйін

Дағды ең кемі екі міндетті өрісі — name және description — бар бір SKILL.md файлынан тұрады. Қосымша ретінде scripts/, references/ және assets/ бумаларын, сондай-ақ параметрлері бар agents/openai.yaml файлын қосуға болады.

Дағды бумасының құрылымы:

my-skill/
  SKILL.md        - required: metadata and instructions
  scripts/        - optional: executable code
  references/     - optional: documents to load as needed
  assets/         - optional: templates and resources
  agents/
    openai.yaml   - optional: appearance and dependencies

SKILL.md файлының өзі үш дефистің арасына жазылған метадеректер блогынан, одан кейін Markdown пішіміндегі нұсқаулар мәтінінен басталады:

---
name: weekly-sales-report
description: Compile a weekly sales report from a CSV export. Use when asked for a weekly sales report or a summary by manager.
---

1. Read the export file at the path provided by the user.
2. Group the rows by manager and calculate the total and number of deals.
3. Compare with the previous week if the file for the previous week is nearby. If it is not there, say so directly in the report.
4. Save the result to report.md: a table by manager, the total, and up to three key changes with figures, as many as the data supports.

OpenAI ресми ұсынымдарынан үш ереже:

  • Бір дағды — бір тапсырма. «Маркетингімнің бәрімен айналыс» деудің орнына нақты тапсырманы таңдаңыз: «осы экспорттан сату есебін құрастыр». Үлкен процесті ретімен іске қосылатын бөлек дағдыларға бөліңіз.
  • Қадамдарды тікелей, кіріс пен шығысты нақты көрсетіп жазыңыз: нені пайдалану, не істеу және нәтижені қайда сақтау керек.
  • Мәтіндік нұсқаулардан бастаңыз. Қадам әр жолы бірдей орындалуы қажет болса, мысалы, файлды түрлендіру немесе сыртқы жүйеге қоңырау шалу үшін scripts/ бумасына скрипт қосыңыз.

Codex тапсырмаға арналған дағдыны description өрісі бойынша таңдайды, сондықтан сипаттаманы тапсырмадан және оны әдетте қалай атайтыныңыздан бастаңыз.

Codex дағдыларды қайдан іздейді?

Негізгі түйін

Codex дағдыларды төрт жерден іздейді: жобаның .agents/skills бумасынан (ағымдағы бума мен оның ата-аналарын репозиторий түбіріне дейін тексереді), жеке $HOME/.agents/skills бумасынан, жүйелік /etc/codex/skills бумасынан және OpenAI кіріктірілген дағдыларының арасынан.

ДеңгейЖолМақсаты
ЖобаАғымдағы бумадағы және оның ата-аналарындағы .agents/skills бумасы, репозиторий түбіріне дейінКодпен бірге Git ішінде сақтауға болатын нақты жобаға арналған дағдылар
Пайдаланушы$HOME/.agents/skillsКомпьютердегі барлық жобада қолжетімді жеке дағдыларыңыз
Жүйе/etc/codex/skillsКомпьютердің немесе контейнердің барлық пайдаланушысына ортақ дағдылар
КіріктірілгенCodex құрамындаДағды жасаушы сияқты OpenAI ұсынған негізгі дағдылар

Жобаға арналған дағдыларды кодпен бірге Git ішінде сақтаған ыңғайлы, сонда бүкіл команда бірдей жиынтығын қолданады. Жеке дағдылар электрондық хат жазу мәнері сияқты өз процестеріңізге жарайды. Әртүрлі деңгейлердегі екі дағдының атауы бірдей болса, Codex оларды біріктірмейді: екеуі де тізімде көрініп, таңдау қиындайды. Атауларын қайталамаңыз.

Салыстыру үшін: Claude Code дағдылары .claude/skills бумасында сақталады, әрқайсысының жеке SKILL.md файлы бар және сол ашық стандартты қолданады. Қарапайым дағдыны бумасын көшіру арқылы сонда тасымалдауға болады; содан кейін оны іске қосып, қолданысқа шақырылатынын тексеріңіз. Claude Code кеңейтімдерін салыстыру үшін Skills, Subagents, MCP немесе Plugins мақаласын қараңыз.

Codex дағдыны іске қосуды қалай шешеді?

Негізгі түйін

Дағдыны қолмен іске қосуға болады: Codex CLI немесе IDE кеңейтіміндегі сұрауыңызға $skill-name деп енгізіңіз немесе /skills арқылы таңдаңыз. Қолмен іске қосылмаса, Codex тапсырма сипаттамаға сәйкес келгенде дағдыны автоматты түрде таңдайды. Дағды қолжетімді және автоматты іске қосуға рұқсат етілген болуы керек.

Әуелде қолмен іске қосу сенімдірек: Codex CLI ішінде нақты процесті таңдау үшін $weekly-sales-report деп енгізіңіз. Қолмен іске қоспау күнделікті жұмысқа ыңғайлырақ. Дағды жазғаннан кейін оны әдеттегі сөздермен сынап көріңіз: Codex-тен тапсырманы $ таңбасынсыз, өз сөзіңізбен орындауды сұрап, дағдыны таңдайтынын қараңыз. Егер таңдамаса, алдымен Codex дағдыны /skills тізімінен көре алатынын, дағды жүктелетін бумалардың бірінде орналасқанын және дағдының өзіне немесе оның автоматты іске қосылуына тыйым салынбағанын тексеріңіз. Дағды қолжетімді әрі параметрлер дұрыс болса, description өрісін нақтылаңыз: тапсырманы және сұраудың әдеттегі тұжырымдарын жазыңыз.

Дағдыны тек нақты пәрмен арқылы қолжетімді еткіңіз келсе, оны да баптауға болады: agents/openai.yaml файлындағы allow_implicit_invocation: false параметрі автоматты іске қосуды өшіреді, ал $name пәрмені жұмыс істей береді. Дағдыны жоймай-ақ, ~/.codex/config.toml арқылы толығымен өшіруге болады:

[[skills.config]]
path = "/full/path/to/the/skill/SKILL.md"
enabled = false

config.toml файлын өңдегеннен кейін Codex-ті қайта іске қосыңыз. Codex дағды бумаларындағы өзгерістерді автоматты түрде байқайды, бірақ жаңа дағды көрінбесе, Codex-ті қайта іске қосыңыз.

Өз дағдыңызды қалай жасауға болады: қадамдық нұсқаулық

Негізгі түйін

Бір қайталанатын тапсырманы таңдап, кіріктірілген $skill-creator көмекшісімен немесе қолмен дағды жасаңыз, нақты нәтижесі көрсетілген нұсқаулар жазыңыз, оны әдеттегі сөздермен іске қосуды сынап, әр іске қосқаннан кейін дағдыны жетілдіріңіз.

  1. Бір тапсырманы таңдаңыз

    Нәтижесі нақты — есеп, кесте, хат немесе талдау болатын, үнемі қайталайтын процесті таңдаңыз. Бұған дейін мұндай нәтиже алмаған болсаңыз, тапсырманы әуелі агентпен қолмен орындаңыз. Алған нәтижеңізді нұсқауларға үлгі ретінде пайдаланыңыз.

  2. Дағды жасаңыз

    Кіріктірілген көмекшімен дағды жасау үшін Codex сессиясында $skill-creator деп енгізіңіз. Ол дағдының не істейтінін, қай кезде іске қосылуы керегін және скрипттер қажет пе екенін сұрап, құрылымын өзі дайындайды. Қолмен жасау үшін жобада .agents/skills бумасын ашып, оның ішіне дағдының ішкі бумасын, мысалы, .agents/skills/weekly-sales-report бумасын жасаңыз. Оған жоғарыдағы үлгіні пайдаланып SKILL.md файлын салыңыз.

  3. Нұсқауларды жазыңыз

    Қадамдарды кіріс пен шығысы нақты көрсетілген нөмірленген тізім түрінде жазыңыз. Процеске дәлдік қажет болса (дерек тасымалдау, атауын өзгерту, есептеу), әр қадамды егжей-тегжейлі сипаттаңыз. Шығармашылық тапсырмаларға (мәтін жазу, дәлелдерді таңдау) шектеулер мен жақсы нәтиженің өлшемдерін белгілеңіз, бірақ модельдің жұмыс істеуіне мүмкіндік қалдырыңыз.

  4. Іске қосуды сынаңыз

    Codex-тен дағдының атын атамай, тапсырманы өз сөзіңізбен орындауды сұраңыз. Егер дұрыс дағдыны таңдаса, сипаттамаңыз сол тұжырымға сай болғаны. Одан кейін $name арқылы қолмен іске қосуды сынаңыз. Дағды іске қосылмаса, буманы, оның /skills тізімінде бар-жоғын және жоғарыда сипатталған өшіру параметрлерін тексеріңіз. Жаңа дағды тізімде көрінбесе, Codex-ті қайта іске қосыңыз. Қолмен іске қосу жұмыс істеп, автоматты іске қосуға рұқсат етілгенімен, Codex сұрауды өз сөзіңізбен бергенде жауап бермесе, description өрісінің басын нақтылаңыз: алдымен тапсырманы, содан кейін оны әдетте қалай тұжырымдайтыныңызды жазыңыз. Қайта сынап көріңіз.

  5. Іске қосқаннан кейін жетілдіріңіз

    Әр іске қосқаннан кейін нәтижені қарап, дағдыда нені өзгерту керегін агентке айтыңыз: «Келесі жолы жиынтық кестесіне үлес көрсетілген баған қос». Бірінші нұсқа қажетті нәтиже бермесе, шығармашылық жұмысқа арналған дағдыны кері байланысқа сүйеніп жетілдіріңіз.

OpenAI мен қауымдастықтың дайын дағдылары $skill-installer пәрмені және дағдының атауы арқылы орнатылады. Өз дағдыларыңызды басқалармен бөлісу үшін оларды плагин ретінде таратыңыз — бұл жеке пайдалануға қажет емес басқа қаптау тәсілі.

Агенттің нәтижесін қалай тексеруге болады?

Негізгі түйін

Қабылдау критерийлерін тікелей дағдыға жазыңыз: нәтиже нені қамтуы тиіс және агент оны сізге тапсырмас бұрын жұмысын қалай тексеруі керек. Бұл дұрыстыққа кепілдік бермейді; нәтижені өзіңіз де тексеруіңіз керек.

Тексерулер объективті немесе субъективті болуы мүмкін. Объективті тексерулер өлшенеді: «есепте экспорттағы 12 менеджердің бәрі бар» немесе «кестедегі сома CSV файлының жалпы сомасына тең». Бұларды қатаң талап ретінде жазыңыз. Субъективті тексерулер сапаға қатысты: «мәтін менікіндей оқылады» немесе «қорытындылар қысқа». Бұларды да нақтылауға болады: дағдыға жақсы үзіндінің үлгісін қосып, агенттен нәтижесін үлгімен салыстыруды сұраңыз.

Пайдалы тәсілдің бірі — тексеру циклі: нәтижені дайындағаннан кейін агент критерийлер тізімін қарап шығып, тапқан кемшіліктерін түзетеді де, содан кейін ғана оны сізге көрсетеді. Anthropic-та ұқсас тәсілді evaluator-optimizer деп атайды: бір агент жұмысты орындайды, бөлек бағалаушы оны қарап, кері байланыс береді, ал қабылданғанша процесс қайталанады. Бір дағдының ішінде бұл әдетте ықшамдалған нұсқа — тізім бойынша соңғы өзіндік тексеру. Оның шектеуін ескеріңіз: жұмысты орындаған агент өз қатесін байқамауы мүмкін болғандықтан, бұл тәуелсіз бағалаушыдан әлсіз.

Есепке арналған тексеру блогының үлгісі:

## Before submitting, check
- Every manager from the export is present in the table; no one was left out.
- The total matches the CSV sum down to the last cent.
- Every key change is supported by a figure; if there is no data for comparison, the report says so directly.
- The file is saved at report.md, and the path has been shared with the user.

Дағды үшін қай модельді таңдаған жөн?

Негізгі түйін

Алдымен дағды сәтті жұмыс істеген модельден бастаңыз, содан кейін арзанырақ модельдерді сынап көріңіз: сапасы сақталса, арзанырақ модельді қалдырыңыз. Төменде бастапқы іске қосуларға арналған API тарифтері мен ұсыныстар берілген — 2026 жылғы 20 қыркүйектегі жағдай бойынша.

МодельКіріс, $/миллион токенШығыс, $/миллион токенАлдымен қандай тапсырмаларда сынап көру керек
GPT-6 Astra1050Терең пайымдауды, кескіндерді және браузерді қолданатын дағдылар
GPT-5.6 Sol420Орташа күрделіліктегі мәтіндік дағдылар
GPT-5.6 Terra2.5015Нәтижесі нақты қарапайым процестер
GPT-5.6 Luna0.201.20Пішімін өзгерту, есептеу, тізім құрастыру сияқты механикалық тапсырмалар

Оң жақтағы бағанда бастапқы тексеруге арналған тапсырмалар ұсынылған. Бұл рейтинг те, салыстыру нәтижесі де емес: дағдыңызға қай модель сәйкес келетінін оны іске қосып, үлгі нәтижемен салыстырғаннан кейін ғана анықтай аласыз.

Кестедегі бағалар — модель беттеріндегі 2026 жылғы 20 қыркүйектегі API тарифтері; ChatGPT жазылымының бағасы емес. Жазылымды пайдаланғанда, қолданыс оның лимиттері бойынша есептеледі. Осы күнгі жағдай бойынша Sol моделі үшін 2026 жылғы 21 қарашаға дейін кемінде $4/$20 жарнамалық тарифі бар; стандартты бағасы — $5/$30. Үлкен қайталанатын іске қосудың алдында баға бетін тексеріңіз: OpenAI жарнамалық ұсыныстары өзгеріп отырады.

Дағдыны келесі арзанырақ модельде іске қосып, нәтижесін үлгімен салыстырыңыз. Сапасы сақталса, одан кейінгі, одан да арзанырақ модельді сынап көріңіз. Сапасы төмендесе, алдыңғы модельге қайтыңыз. Модельдердің жұмыс қарқынының деңгейлері де бар: Astra үшін low деңгейінен max деңгейіне дейін, ал 5.6 тобы үшін none деңгейінен max деңгейіне дейін. Оларды да сол үлгі нәтижемен салыстырып сынаңыз: алдымен модельді, содан кейін жұмыс қарқынының деңгейін таңдаңыз.

Дағдыны үнемі іске қосу қайталанатын шығынға әкеледі. Astra моделінің кіріс бағасы Luna бағасынан 50 есе жоғары, сондықтан бір қайталанатын дағдыға әртүрлі модель қолдану шығынды едәуір өзгертуі мүмкін. Скриншоттар мен құжаттарды талдайтын дағдыда әлсіздеу модель қайта жұмыс істеу қажеттілігінен көбірек шығынға ұшыратуы мүмкін.

Дағдыны жасау және пайдалану кезіндегі жиі кездесетін қателер

  • «Бәріне арналған» дағды. Бір процесс — бір дағды: OpenAI да осылай ұсынады. Бәрін қамтитын, он беттік дағдыны нақты сипаттау қиын, ал Codex тапсырмаға дағдыны оның сипаттамасына сүйеніп таңдайды.
  • Бұлыңғыр сипаттама. «Есептерге көмектеседі» деген сипаттама дағдының қандай есептерге арналғанын ашпайды. description өрісінің басына тапсырманы және оны әдетте қалай тұжырымдайтыныңызды жазыңыз.
  • Нәтижесі анықталмаған нұсқаулар. Не жасау және нәтижені қайда сақтау керегі көрсетілмесе, іске қосқан сайын әртүрлі нәтиже алынуы мүмкін.
  • Мүлде тексермеу. Критерийлері бар соңғы қадам болмаса, толықтай өзіңіз тексеруге тура келетін аяқталмаған нобай шығуы мүмкін.
  • Әдепкіде ең қабілетті модельді таңдау. Алдымен тапсырманы арзанырақ модель орындай ала ма, соны тексеріңіз: дағдыны сол модельде іске қосып, нәтижесін үлгімен салыстырыңыз. Сапасы сақталса ғана ауыстырыңыз.
  • Әртүрлі бумаларда бірдей атауларды қолдану. Codex атаулары бірдей дағдыларды біріктірмейді, бұл керегін таңдауды қиындатады.

Қалай бастап, дағдыны Claude Code-қа көшіруге болады?

Негізгі түйін

Бір қайталанатын процесті таңдап, $skill-creator көмегімен дағды жасаңыз, оны өз сөзіңізбен іске қосуды сынап, қабылдау критерийлері бар соңғы қадам қосыңыз. Бірнеше рет іске қосқаннан кейін, анықталған қателерге сүйеніп сипаттамасы мен нұсқауларын жетілдіріңіз.

Бірнеше агентпен жұмыс істесеңіз, тек мәтіндік нұсқаулар мен SKILL.md файлынан тұратын буманы Claude Code-қа көшіруге болады. Онда дағдылар .claude/skills бумасында сақталып, /name пәрменімен іске қосылады. Егер дағдыда скрипттер, тәуелділіктер немесе agents/openai.yaml файлы болса, көшіргеннен кейін тексеріңіз. Claude Code дағдыларының жинағы туралы нұсқаулықты Claude Code дағдылары: өз жинағыңызды қалай жасауға болады мақаласынан қараңыз; Codex пен Claude Code салыстыруы үшін Codex пен Claude Code мақаласын қараңыз.

Ailoot-ты ашыңыз.

Толығырақ

Жиі қойылатын сұрақтар

Дағдыны тікелей шақыру жұмыс істеп, автоматты таңдау неге істемеуі мүмкін?

Дағды /skills ішінде көрінетінін және жанама шақыру қосулы екенін тексеріңіз. Екеуі де дұрыс болса, сипаттаманы тапсырмадан басталып, әдетте қолданатын сөздеріңізді қамтитындай нақтылаңыз да, сол қарапайым сұрауды қайта сынаңыз.

Сату есебі дағдысының нәтижесінде нені тексеру керек?

Кіріс экспорттағы әр менеджер қамтылғанын, жалпы сома дереккөзге сәйкес екенін, әр өзгеріс туралы тұжырым санмен расталғанын және сұралған есеп файлы сақталғанын тексеріңіз. Алдыңғы кезең болмаса, есеп мұны айтуы керек.

Барлық мақалалар