AI-ийн "Хуучин код санал болгодог" өвчнийг эмчлэх нь: Нээлттэй SKILL.md стандарт ба TanStack Intent танилцуулагдлаа

Хөгжүүлэгч бүрт тохиолддог нэгэн нийтлэг бухимдал бий: Cursor, Claude Code эсвэл GitHub Copilot ашиглан код бичих үед AI модель хамгийн сүүлийн хувилбарын шинэ API-ийг биш, харин 2 жилийн өмнөх хуучин, дэмжигдэхээ больсон (deprecated) функцийг санал болгодог.

Моделийн сургалтын өгөгдөл (training cutoff) хэчнээн шинэчлэгдсэн ч интернет дэх кодын 80-90% нь хуучин хувилбараар бичигдсэн байдаг тул AI магадлалын хувьд хуучин синтаксийг илүүд үздэг. Энэхүү "мөнхийн хуваагдмал тархи" (permanent split-brain) асуудлыг шийдэхээр нээлттэй эхийн экосистемд хувьсгал гарч байна: Хөгжүүлэлтийн сангууд (libraries) өөрийн заавар, зөв арга барилыг (skills) npm багц дотроо SKILL.md файл хэлбэрээр хамт нийлүүлж эхэллээ.

Тэргүүлэх frontend сангуудыг хөгжүүлэгч TanStack баг энэ чиглэлд анхдагч болж @tanstack/intent хэрэгслийг танилцуулсан бол Vercel, Vue ecosystem ч энэхүү нээлттэй стандартыг дэмжиж нэгдээд байна.

Үндсэн асуудал: Typescript Types болон Readme хангалтгүй байна

Орчин үеийн кодинг агентууд санг зөв ашиглахад хоёр саад тулгардаг:

TypeScript тодорхойлолт (Types): AI функцийн төрлийг мэдэх боловч хэзээ, ямар дэс дарааллаар, ямар architectural pattern ашиглах ёстойг мэдэхгүй.
CLAUDE.md / .cursorrules файлууд: Хөгжүүлэгч өөрийн төсөлдөө дүрэм гараар бичиж өгөх боломжтой ч сан бүрийн 100 хуудас баримт бичгийг гараар хуулж тавих нь боломжгүй бөгөөд контекст цонхыг (context window) дэмий дүүргэдэг.

Үүний үр дүнд жишээлбэл, хөгжүүлэгч төсөлдөө TanStack Table v9 ашиглаж байхад AI агент v8-ийн хуучин hook, хуучирсан архитектурыг зөрүүдлэн бичсээр байдаг.

SKILL.md стандарт гэж юу вэ?

SKILL.md нь AI агентуудад зориулсан бүтэцлэгдсэн, хөнгөн жинтэй зааварчилгааны нээлттэй формат юм.

Сангийн эх кодын хавтсанд дараах бүтэцтэйгээр байрлана:

node_modules/@tanstack/react-table/
├── package.json
├── dist/
└── skills/
    └── table-features/
        ├── SKILL.md       # Үндсэн заавар ба мета өгөгдөл
        └── references/    # Шаардлагатай үед дуудах дэлгэрэнгүй баримт

SKILL.md файлын эхэнд YAML frontmatter байх бөгөөд AI агент юунд зориулагдсаныг таньж мэднэ:

---
name: tanstack-table-features
description: Explains headless table architecture, explicit feature registration, and TypeScript patterns for TanStack Table v9.
metadata:
  sources:
    - docs/framework/react/guide/features.md
---

Progressive Disclosure: Контекст хэмнэх ухаалаг механизм

Хэрэв төсөлд 50 сан суулгасан бол 50 сангийн бүх заавар LLM-ийн контекст рүү зэрэг ачаалагдах уу? Үгүй.

Энэхүү систем нь Progressive Disclosure (Үе шаттай нээх) зарчмаар ажилладаг:

Discovery (Нээлт): Агент эхлэх үедээ зөвхөн суулгасан сангуудын name болон description (~100 токен) хэсгийг л уншина.
Activation (Идэвхжүүлэлт): Хөгжүүлэгч "Хүснэгтэд багана эрэмбэлэх болон шүүлтүүр нэмье" гэж хүсэлт тавихад уг даалгаварт TanStack Table skill тохирч байгааг агент мэдэрч, бүтэн зааврыг (<5,000 токен) санах ойд татаж авна.
Execution (Гүйцэтгэл): Алдаагүй, хамгийн сүүлийн хувилбарын синтакс, шилдэг туршлага (best practices), гаргаж болохгүй анти-паттернүүдийг баримтлан кодыг үүсгэнэ.

TanStack Intent хэрхэн ажилладаг вэ?

TanStack багийн танилцуулсан @tanstack/intent CLI нь хөгжүүлэгч болон сан бүтээгчдэд зориулсан бүрэн экосистемийг бүрдүүлж байна.

1. Төсөл дээрээ идэвхжүүлэх (Хэрэглэгчдэд):

Хөгжүүлэгч төсөл дээрээ ганцхан комманд ажиллуулахад хангалттай:

npx @tanstack/intent@latest install

Энэ нь таны суулгасан бүх package-ийг уншиж, CLAUDE.md, .cursorrules, эсвэл AGENTS.md файлд агент шаардлагатай үед node_modules-оос skill дуудаж ажиллах дүрмийг автоматаар нэмж тохируулна.

Хамгийн том давуу тал нь: Та npm update @tanstack/react-table хийх үед SKILL.md шинэчлэгдэж, таны AI агент шинэ хувилбарыг ямар ч нэмэлт тохиргоогүйгээр шууд мэддэг болно!

2. Сангийн хөгжүүлэгчдэд зориулсан CI баталгаажуулалт:

Баримт бичиг өөрчлөгдөх үед SKILL.md хуучирч үлдэхээс сэргийлж, Intent нь CI пайплайн дээр ажиллах intent stale шалгуурыг санал болгодог. Хэрэв docs өөрчлөгдөөд харгалзах skill өөрчлөгдөөгүй бол Build унах тул баримт бичиг болон AI skill хэзээ ч зөрөхгүй.

Дүгнэлт: Программ хангамжийн баримтжуулалтын шинэ үе

AI кодинг агентууд хөгжүүлэгчийн өдөр тутмын хэрэглээ болсон өнөө үед сангуудыг зөвхөн хүнд зориулж вебсайт дээр бичдэг үе ард хоцорч байна.

SKILL.md стандарт болон TanStack Intent нь кодын багц өөрөө өөрийгөө хэрхэн ашиглах зааврыг AI-д зориулан тээвэрлэдэг шинэ эриний эхлэлийг тавьж байна. Хэрэв та өөрийн open-source сан эсвэл компанийн дотоод package хөгжүүлдэг бол одооноос эхлэн skills/ хавтсаа нэмж, багийнхаа AI агентуудыг алдаагүй ажиллуулах цаг иржээ.

Эх сурвалж:

TanStack Intent Official Announcement & Documentation (tanstack.com/intent)
Agent Skills Open Standard Specification (agentskills.io)
GitHub: @tanstack/intent & skills-npm repositories