Чаму ланцужкі навыкаў агента ламаюцца і трохузроўневае выпраўленне, якое трымаецца
Глыбокія ланцужкі навыкаў перагружаюць кантэкст агента. Будуйце з атамаў, малекул і злучэнняў — з прыкладамі для Claude Code, LangGraph, CrewAI і Agno.
Крыніцы: Why AI Agent Skills Break When We Chain Them and the Three-Layer Fix
Чым большае колькасць слоёў у ланцузе навыкаў агента, тым больш агент забывае. Шаблон складання з трохо слоёў дапамагае падтрымваць надзеянную надзею навыкаў на будзь-якай глыбіні, і ён праіснавае ў Claude Code, LangGraph, CrewAI і Agno.
Чаму плоскія графы навыкаў не працуюць
На паперы граф навыкаў здаецца прыемным: спаўнююцца звязкі між навыкамі, агент можа пераходзіць па графе і ствараць неабходныя можлівасці. Навык маркетынгу вызывае навык даследжэння, які у свою чаргу вызывае навык агрэгавання даных, і так ствараецца аўтаматызаваны працэс.
У практыцы ён не працуе ў Claude Code, Codex, Cursor і ўсіх іншых агентах, у якіх вікна кантэксту ёсць скончанымі.
Гэта ўсё механізм. Спачатку агент завантажае толькі апісанні навыкаў, што вялікая частка інформацыі пра тое, што існуе. Полны тэкст навыку завантажаецца, калі ён выклікаецца, і пасля таго застаецца ў сесіі, выкарыстоўваючы прыгоднае прастора. Claude Code ачэнна адзначае сваія меры: калі сесія скорачваецца, адзін навык можа мець не болейш 5 000 токенав, а ўсе навыкі разам — 25 000. Ужо пяць повных навыкаў падходзяць да гэтага ліміту. Калі завантажыць дзесяць, частка інфармацыі выкарыстоўваецца без паведамлення. Іншыя агенты сталкнуцца з падобнымі проблемамі, але з іншымі цыфрамі.
Распрацоўшчыкі ў розных фрэймворках опісваюць аднаковую схему. Выкліканне проста B працюе надзеямо. Выкліканне праз B і C дае розныя рэзультаты. Выкліканне праз B, C і D — больш спадзяванне, чым рэальная тэхніка. У агента востаннім часам з’яўляецца занадта многа інструкцыяў, якія конкуруюць за увагу, і занадта мало прастора, каб іх зберагчы.
Навыкі складання — гэта не паслабленая ідэя. Але іх адражэнне у вачынцы плоскага графа — так. У прыкладах тут выкарыстоўваецца фармат SKILL.md ад Claude Code, таму што яго дакументацыя ўсё ясней, але прынцып атомаў, малекул і спалучэнняў прыменяецца да будзь-каго агента, які мае навыкі, інструменты чы расшырэнні.
Тры рэвэлі, якія адпавядаюць рэальнаму складанню
Большасць фрэймворкаў агентаў вялікі час яшчэ іерархізуюць элементы: прымітныя інструменты, ланцоўкі рабочых практык і дэлегаванне падагентам. Claude Code чыніць гэта явным за дапамой іерархіі команд, навыкаў і задач. Тры рэвэлі, паказаныя ніжэй, адпавядаюць Codex (навыкі і команды), Cursor (правілы і інструменты) і ўсему, што падтрымляе вызыв інструментаў і падпроцесы.
Атамы: адзін навык, адна задача
Атам — гэта SKILL.md для аднай вузкай задачы з майжэ дэтэрміністычным паведаннем. Ён не вызывае іншых навыкаў і не прымяўляе рашэнняў. У ён ёсць чысты вхід і чысты выхід.
---
name: verify-email
description: Verify an email address using Hunter.io API.
Use when validating email deliverability before outreach.
allowed-tools: Bash
---
## Verify Email
1. Read the Hunter API key from $HUNTER_API_KEY
2. Call the Hunter email-verifier endpoint
3. Return: status (deliverable/risky/undeliverable), score, smtp_check
4. If the API errors, report the error. Do not guess.
Просты тэст: калі вы можэце апісаць усю навык у аднам рэчэнцы без вжывання слова „і“, то гэта атам. Іншыя прыклады – пераклад URL у фармат markdown, запуск набора тэстаў, перагляд файла, запрашэнне разліку патрэбнаў pull-request або вышукванне запісей DNS.
Малекулы: запісаныя ланцюгі атамаў
Малекула рашае большую проблему, запускаючы два-дзесяць атамаў у пэўнай парадку. Тое, што адлічвае яе ад графа навыкаў, – гэта тое, што оркестрацыя запісана. Малекула не залежыць ад таго, чыя модэлі будуць выкананыя для выявлення наяўных атамаў і ўзначэння парадку пад час выканання.
---
name: qualify-lead
description: Research a company, find the right contact, verify
their email, output a qualified lead card.
allowed-tools: Bash Read Write
---
## Qualify Lead
Execute these steps IN ORDER.
### Step 1: Company Research
Use /research-company. Capture: size, industry, funding, tech stack.
### Step 2: Find Contact
Use /find-contact. Target: VP Eng, CTO, Head of Platform.
### Step 3: Find & Verify Email
Use /find-email, then /verify-email.
If undeliverable, return to Step 2 (max 3 attempts).
### Step 4: Output Lead Card
Write structured markdown to leads/{company-slug}.md
Зверніце ўвагу на тое, чаго не підкрэслюе файл. У ям ніколі не працюе паведамлення абы агент сам выбраў неабходныя навыкі. У ям пераказана парада дзеянняў: даследзіць компанію, знайсці кантакт, знайсці электронную пашту, а потым яе параболіць, самэй такой парады.
Самэй такой чыстайсці і выходзіць надзеянасць. Нечыстыя інструкцыі, такія як «даследзіць компанію і знайсці найкрашчы спосаб прыкантактавання з ямі», змушаюць мадэль выбіраць дзеяння ў момент выканання, і інодзе яна прыпускае якісь крок або стварае свой шлях выканання, які зовсім ігнаруе вашы патрэбныя дзеяння.
Компаунты: кераванне падагентамі
Компаунты выкорыстоўваюцца тады, калі адна вікна кантэксту не можа разам размясціць усё. У ямі выкорыстоўваецца інструмент Task з Claude Code для запуску падагентоў, кожны з якіх мае свае вікна кантэксту і своія загадзя завантажаныя навыкі.
---
name: outbound-playbook
description: Run the full outbound playbook for a target segment.
Spawns parallel agents to qualify leads and draft emails.
disable-model-invocation: true
allowed-tools: Bash Read Write Task Teammate
---
## Outbound Playbook
### Phase 1: Build Lead List
Ask the user for: target segment, company size range, geography.
Use /scrape-directory to pull matching companies.
### Phase 2: Parallel Lead Qualification (Task tool)
For each company (batch of 5):
- Spawn a subagent with qualify-lead preloaded
- Each subagent qualifies one company independently
### Phase 3: Draft Emails (Task tool)
For each qualified lead:
- Spawn a subagent with draft-email preloaded
### Phase 4: Human Review Checkpoint
STOP. Present sample drafts. Ask: "Review these. Adjust or proceed?"
Do NOT proceed without explicit user approval.
### Phase 5: Campaign Summary
Compile results to outbound/{segment}/campaign-summary.md
Два аспекты выдэляюць компаунды. Першы — падаэнты маюць адзінаковыя вікна кантэксту, таму праца з адзычэннем кліента не конкуруець за прастора з падготовкай электранаў. Самэй гэтага компаунды можаць функцыонаваць за межамі, якія спяшаюць глыбокія ланцюгі.
Другі аспект — disable-model-invocation: true означае, што толькі чалавек можа запускаць план дзеяння. Мадэль не можа сама адлучыцца да запуску кампаніі. Компаунды запускаюць рэальныя дзеянні, таму керуванне янымі павінна застацца у руках чалавека.
Структура папак
.claude/skills/
# ATOMS — single purpose, near-deterministic
verify-email/SKILL.md
find-email/SKILL.md
find-contact/SKILL.md
research-company/SKILL.md
scrape-url/SKILL.md
# MOLECULES - explicit chains of atoms
qualify-lead/SKILL.md
review-and-test/SKILL.md
draft-blog-post/SKILL.md
# COMPOUNDS - subagent orchestration, human-driven
outbound-playbook/SKILL.md
feature-build-ship/SKILL.md
Назвы можаць быць разнымі. Галоўнае — гэта спосаб іх раздзелення.
Тая ж ідэя ў іншых месцах
Нічога тут не ўзначае толькі SKILL.md. Кожная вядомая парадка агента мае свае аналогіі, а сінтаксіс можа змініцца, пры тым як логіка складання застаецца той самым.
LangGraph: інструменты, ланцюгі, падграфы
У LangGraph атамы — гэта функцыі, адзначаныя @tool, молекулы — гэта последовальныя графы з чысткім порадкам вузлаў, а спалучанні — гэта падграфы з аддзельным станом.
from langgraph.graph import StateGraph
from langchain_core.tools import tool
# ATOM: a single tool
@tool
def verify_email(email: str) -> dict:
"""Verify email deliverability via Hunter.io."""
response = requests.get(f"https://api.hunter.io/v2/email-verifier?email={email}")
return response.json()
# MOLECULE: explicit sequential graph
workflow = StateGraph(LeadState)
workflow.add_node("research", research_company)
workflow.add_node("find_contact", find_contact)
workflow.add_node("verify", verify_email)
workflow.add_edge("research", "find_contact")
workflow.add_edge("find_contact", "verify")
graph = workflow.compile()
# COMPOUND: subgraph composition
parent = StateGraph(CampaignState)
parent.add_node("qualify", qualify_subgraph) # each is a compiled graph
parent.add_node("draft", email_subgraph) # with its own state
parent.add_node("review", human_review_node)
Разлік з Claude Code заключаецца ў тым, што молекула LangGraph — гэта граф з явнымі рэбрамі, а не спіс інструкцый, таму оркестрацыя ў такім разе ёсць структурной, а не тэкстовай. Умовныя оператары, ціклы і паралельныя гілкі працююць болей ефектывна такім спосабам, хоча налаштаванне вімагае больш коду.
CrewAI: інструменты, задачы, групы ў рамках прайсупутнаў
CrewAI дозволяе чыстае каратэгураванне. Атамы — гэта інструменты, молекулы — гэта задачы, з’ѐднаны за дапамогою залежнасцяў context, а спалучанні — гэта групы, якія запускаюцца прайсупутнамі.
from crewai import Agent, Task, Crew, Flow
from crewai.tools import tool
# ATOM: a tool
@tool
def verify_email(email: str) -> str:
"""Verify email deliverability."""
return requests.get(f"https://api.hunter.io/v2/email-verifier?email={email}").text
# MOLECULE: tasks chained via context
researcher = Agent(role="Researcher", goal="Find company info", tools=[search_tool])
verifier = Agent(role="Verifier", goal="Verify contacts", tools=[verify_email])
research_task = Task(description="Research {company}", agent=researcher)
verify_task = Task(description="Verify the contact", agent=verifier, context=[research_task])
crew = Crew(agents=[researcher, verifier], tasks=[research_task, verify_task])
# COMPOUND: Crews inside a Flow
class OutboundFlow(Flow):
@start()
def qualify_leads(self):
return qualify_crew.kickoff(inputs={"segment": self.state.segment})
@listen(qualify_leads)
def draft_emails(self, qualified):
return email_crew.kickoff(inputs={"leads": qualified})
@listen(draft_emails)
def human_review(self, drafts):
return drafts # pause for human approval
Параметр context=[research_task] являецца явным звязам. эты параметр прыказвае задачы па перакантраванні чакаць, пакуль не завершыцца задача даследжэння, і чытаць тое, што яна створыла. Калі яго не выкорыстоўваць, кожная задача выконваецца сама, тады ланцоўка знікае.
Agno: інструменты, агенты, каманды
У Agno самая простая структура карэлівання. Атамы — гэта функцыі @tool, молекула — агент, які мае калькі інструментаў плюс апісанне, якое вялічы тэрмін выканання, а спалучанні выкорыстоўваюць структуру каманды.
from agno.agent import Agent
from agno.models.anthropic import Claude
from agno.tools import tool
# ATOM
@tool
def verify_email(email: str) -> str:
"""Verify email deliverability via Hunter.io."""
return requests.get(f"https://api.hunter.io/v2/email-verifier?email={email}").text
# MOLECULE: agent with ordered tools
qualify_agent = Agent(
model=Claude(id="claude-sonnet-4-6"),
description="Qualify a lead: research company, find contact, verify email. Execute in that order.",
tools=[research_company, find_contact, find_email, verify_email],
)
# COMPOUND: team of agents
from agno.team import Team
outbound_team = Team(
agents=[qualify_agent, email_drafter, campaign_reporter],
description="Run the full outbound playbook for a target segment.",
)
Пакалькі, што спакаванне знаходзіцца ў апісацыі, молекула Agno больш прымае фармат SKILL.md, чым структурныя канцэры LangGraph. Яе лёгкае напісаць, і парадак у яй не такі строгі.
Адна архітэктура, многа сынтаксісы
Дэталі рэалізацыі разныя, але форма застаецца той самым. Будзь-якая платформа, якая вырастае за межы простых дэманстрацый, у канцэ настае з тымі ж трыма шарамі, таму што абмежэнні ўсюды ідэнтычныя: скончаны кантэкст, ненадзеяныя автаматычныя зв’язкі і патрэба ў людскім наглядзе пад час важлівай працы.
Дзе яна ўсё ўсё ж ламаецца
- Слабыя атомы паспрабоўваюць зіпсаваць усё, што знаходзіцца над імі. Калі атом verify-email адзвярнёцца, што усё працюе, хоча API на самай праце зазнае абякання, кожная молекула чы сульфат, якія на яму спалагаюцца, ствараюць некарэктныя даны. Тэстуйце атомы по аднаму перад тым, як іх склеіваць.
- Молекулы, які складаюцца з дзесяці атомаў і больш, становяць прычыну ненадзеянага падходу. У Claude Code сумарны бюджэт пасля складання ёсць жорсткім лімітам, а іншые агенты маюць сваія власныя обмежэнні. Старацца, каб молекулы складаліся з двух-дзесяці атомаў, і ставіць крытычныя крокі на пачатку.
- Спалучанні, які складаюцца з восьмі-дзесяці молекул, таксама сталквуюцца з власным лімітам. Оркестратор павінен сочыць за тым, якія падагенты завершылі сваю працу, што яны створылі і што будзе далей, а працаваючы з большымі об’ёмамі, ён тырае надзор за працэсамі. Раздзеліце большое спалучанне на два часткі, а між ямі размясціце пункт контролю, які будзе кераваць працэю.
- Автаматычны запуск ёсць менш надзеяным, чым явны запуск. У аналізах агентаў, опублікованых Vercel, было зафіксавана, што ў вялікай частцы тэстававанняя навыкі не запускаліся, і гэта явішча, верагатна, характэрна і для іншых праграм, кроме Claude Code. Гэта ўзяць пад контроль можна для атомаў. Для молекул і спалучанняў выключыце автаматычны запуск і самі запускайце іх.
Вы — водач, а агент — двахарука.
Чаму гэта важна
Бяскончаны рэсурс — гэта не вычысленнія і токены. Гэта ваша увага. Напісанне фразы «пераканацься ў гэты электронны ліст» і фразы «запусціць аперацыю для сегмента фінтэху» выклікае прыблізна аднаковыя зусіллі для пачатку і стараннага стэрагу, пры тым як рэзультаты разлічаюцца у кілька разоў.
Корача кажучы, атамы даюць агенту прыемлівыя елементы працы, молекулы складаюць гэтыя елементы ў последовасці, якія дазволяюць досягнуць певных цэлей, а спалучанні запускаюць кальколькі такіх последовасцей паралельна ў аднальных вікнах кантэксту. Кожны рэвень даўае новы рэзультат, тады як ваша увага застаецца практычна незменным.
Гэтая архітэктура вялікай меры падтрымваная — явна ў Claude Code і за дапамогою адпоўнай прыемлівай структуры ў іншых месцах. Але шаблон складання — гэта тое, чаго большасць распрацоўшчыкаў яшчэ не створылі.
Дакументацыя навыкаў Claude Code знаходзіцца на адрэсе code.claude.com/docs/en/skills, а фармат SKILL.md адпавядае стандарту open Agent Skills, які працуе з калькама AI-інструментаў. Атамы, молекулы і спалучанні ўжо ўзятыя як прыклады, а паказаны код ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ўжо ў