የXygeni የደህንነት መዝገበ ቃላት
የሶፍትዌር ልማት እና የማድረስ ደህንነት መዝገበ ቃላት

የ SKILL.md ፋይል ምንድን ነው?

የSKILL.md ፋይል አጭር የYAML ራስጌ ያለው የMarkdown ፋይል ሲሆን የAI ወኪል የተወሰነ ተግባር እንዴት ማከናወን እንዳለበት ያስተምራል። በአማራጭ ስክሪፕቶች፣ የማጣቀሻ ሰነዶች እና አብነቶች ባሉበት አቃፊ ውስጥ ይቀመጣል፣ እና ወኪሉ ተግባሩ ሲጠየቅ ብቻ ይጭነዋል። የSKILL.md ፋይሎች ክፍት የወኪል ክህሎቶችን ዝርዝር መግለጫ ይከተላሉ፣ ስለዚህ አንድ ክህሎት በብዙ የኮድ ወኪሎች ላይ ይሰራል። ለምርት ቡድኖች፣ የSKILL.md ፋይል አዲሱ የፊት በር ነው፡ አንድ ወኪል ምርትዎን በትክክል እንዴት መጠቀም እንዳለበት የሚማርበት መንገድ። ለደህንነት ቡድኖች፣ አንድ ወኪል የሚያደርገውን የሚቀይር ግልጽ ጽሑፍ ያለው ፋይል ነው፣ እና ከኮዱ ጋር ተመሳሳይ ግምገማ ይገባዋል።

የ SKILL.md ፋይል ምንድን ነው? #

የAI ወኪሎች ችሎታ ያላቸው ግን አጠቃላይ ናቸው። የኮድ እና የጥሪ መሳሪያዎችን እንዴት እንደሚጽፉ ያውቃሉ። የማሰማራት ሂደትዎን፣ የኤፒአይ ኮንቬንሽኖችዎን ወይም CLIዎ በCI ውስጥ ደህንነቱ በተጠበቀ ሁኔታ እንዲሰራ የሚያስፈልጉትን ሶስት ባንዲራዎች አያውቁም። እስከ ቅርብ ጊዜ ድረስ፣ መፍትሄው እያንዳንዱን ክፍለ ጊዜ የሚጭን እና ከእውነተኛው ስራ ጋር የሚወዳደር የስርዓት ጥያቄ ውስጥ መለጠፍ ነበር።

የ SKILL.md ፋይል ይህንን በተለየ መንገድ ይፈታል። አንድ አቅም (ይህንን አገልግሎት ማሰማራት፣ እነዚህን ግኝቶች መለየት፣ ይህንን ሪፖርት ማመንጨት) ወኪሉ ሊያገኘው፣ ተገቢ ሲሆን ማንበብ እና ሌላ ችላ ማለት ወደሚችልበት አቃፊ ያሽገዋል። ቅርጸቱ የተዘጋጀው በአንትሮፒክ ሲሆን እንደ ክፍት ተለቋል። standardወደ የወኪል ክህሎቶች ዝርዝር መግለጫእና ከዚያን ጊዜ ጀምሮ ቁጥራቸው እየጨመረ በመጣ ቁጥር በኤጀንቶች ተቀባይነት አግኝቷል፣ ከእነዚህም ውስጥ OpenAI Codex፣ GitHub Copilot እና Cursor ይገኙበታል።

ስለዚህ የ SKILL.md ፋይል ምንድን ነው ብሎ የሚጠይቅ ቡድን ሁለት ጥያቄዎችን እያነሳ ነው፡ ወኪሎች መሳሪያዎቻችንን በአግባቡ እንዲጠቀሙ እንዴት እናስተምራለን እና ወኪሎች የተሳሳተ ነገር እንዳይማሩ እንዴት እናቆማለን? → ወኪል የአይቲ ደህንነት ምንድን ነው?

SKILL.md ትርጉም፡ ፋይሉ በትክክል የያዘው ነገር #

የ SKILL.md ትርጉም በዙሪያው ካለው ግርግር የበለጠ ቀላል ነው። ክህሎት አንድ የሚያስፈልግ ፋይል ያለው አቃፊ ነው፡

የ SKILL.md ፋይል ራሱ ሁለት ክፍሎች አሉት፦ #

  • የማርክዳውን አካል። መመሪያዎቹ፡- ወኪሉ በሚፈልግበት ጊዜ ሊከፍታቸው የሚገቡ የድጋፍ ፋይሎች ደረጃዎች፣ ደንቦች፣ ምሳሌዎች እና ጠቋሚዎች።
  • የYAML የፊት ጉዳይ። ቢያንስ ሀ name እና descriptionመግለጫው በፋይሉ ውስጥ በጣም አስፈላጊው መስመር ነው፣ ምክንያቱም ክህሎቱ ተግባራዊ መሆን አለመሆኑን ለመወሰን ወኪሉ የሚያነበው ነው።
markdown — name: acme-cli-deploy መግለጫ፡ አገልግሎቶችን በAcme CLI ያሰማራል። ተጠቃሚው የAcme አገልግሎት ለመላክ፣ ለመልቀቅ ወይም ለመመለስ ሲጠይቅ ይጠቀሙ። — # በAcme CLI ማሰማራት 1. ከማንኛውም ማሰማራት በፊት `acme validate`ን ያሂዱ። 2. በምርት ውስጥ `–force`ን በጭራሽ አያልፉ። 3. ለመልሶ ማጥቃት ሂደቶች፣ references/rollback.md ን ያንብቡ።

የማይይዘው፡- የምስክር ወረቀቶች፣ በኮዱ ውስጥ የሚገባ የንግድ አመክንዮ ወይም ለአንድ ውይይት ብቻ ትርጉም የሚሰጡ መመሪያዎች።

የ SKILL.md ፋይሎች ለምን እንደ ሆኑ standard #


ምክንያቱም አውዱ የተወሰነ ነው። ወኪል ለማያስፈልገው መመሪያ የሚውል እያንዳንዱ ቶከን ለተግባሩ የማይውል ቶከን ነው። ክህሎቶች በንብርብሮች ይጫናሉ፣ ስለዚህ አንድ ወኪል በደርዘን የሚቆጠሩትን ሊሸከም እና አንዱ አስፈላጊ እስኪሆን ድረስ ምንም መክፈል አይችልም።

ተንቀሳቃሽነት የቀረውን አድርጓል። አንድ ጊዜ የተጻፈ ክህሎት ዝርዝር መግለጫውን በሚተገብር በማንኛውም ወኪል ውስጥ ይሰራል። ለምርት ኩባንያ፣ የወኪል ድጋፍን ኢኮኖሚ ይለውጣል፡ በአንድ ረዳት አንድ ውህደት ከማድረግ ይልቅ አንድ ክህሎት ያትማሉ።

እና ወኪሎች ተጠቃሚዎች ሆኑ። ገንቢዎች አንድ ወኪል “ስካነሩን እንዲያዘጋጅ” ወይም “እንዲጠግን” እየጠየቁ ነው። pipeline"ሰነዶቹን እራሳቸው ከማንበብ ይልቅ። ወኪሉ ምርትዎን ከቆየ የመድረክ ልጥፍ ቢማር፣ በመጥፎ ሁኔታ ይጠቀምበታል። የSKILL.md ፋይል ወኪሉ ምን እንደሚማር እንዲወስኑ ያስችልዎታል።

የ SKILL.md ፋይል እንዴት እንደሚሰራ፡- ተራማጅ ይፋ ማድረግ #

በተግባር የ SKILL.md ፋይል ምን እንደሆነ መረዳት ማለት ወኪሉ ምን እንደሚጭን እና መቼ እንደሚጫን ማወቅ ማለት ነው፣ ምክንያቱም በደርዘን የሚቆጠሩ የወኪል ክህሎቶች የአውድ መስኮቱን እንዳያጥለቀልቁ የሚያደርጋቸው ይህ ነው።

መድረክወኪሉ የሚጫነውን ነገርሲጫን
ማግኘትከግንባር ጉዳይ የተወሰደው ስም እና መግለጫ፣ በአንድ ክህሎት ጥቂት ደርዘን ቶከኖችበጅምር ላይ፣ ለእያንዳንዱ የተጫነ ክህሎት
ማግበርሙሉው የ SKILL.md አካል፡ ደረጃዎች፣ ደንቦች እና ምሳሌዎችአንድ ተግባር ከማብራሪያው ጋር ሲዛመድ
ማስፈጸምስክሪፕቶች፣ የማጣቀሻ ሰነዶች እና በፎልደሩ ውስጥ የተጠቀለሉ ንብረቶችመመሪያዎቹ ሲጠይቋቸው ብቻ

የዲዛይን መርህ ተራማጅ ይፋ ማድረግ ነው፡ ጅምር ላይ ሜታዳታ፣ ስለ ማግበር መመሪያዎች፣ ስለ አፈፃፀም ግብዓቶች። መግለጫው በጣም አስፈላጊ የሆነውም ለዚህ ነው። ግልጽ ያልሆነ መግለጫ ማለት ክህሎቱ በጭራሽ አይቀሰቅስም ወይም አስፈላጊ ካልሆነ በስተቀር አይቀሰቅስም ማለት ነው።

ምርትዎን ለ AI ወኪሎች እንዴት ማዋቀር እንደሚቻል
#

የወኪል ክህሎቶችን እንደ የምርት ገጽታ አድርገው ይይዟቸው፣ ልክ እንደ ኤፒአይ ማጣቀሻዎ መጠን በጥንቃቄ።

  1. በአንድ ሥራ አንድ ክህሎት እንጂ በአንድ ምርት አንድ ክህሎት አይደለም። “በCI ውስጥ ቅኝትን ማዋቀር” እና “የመለየት ግኝቶች” የተለያዩ ክህሎቶች ናቸው። ሁሉንም ነገር ለመሸፈን የሚሞክር አንድ ክህሎት ባልተጠበቀ ሁኔታ የሚቀሰቅስ እና የሚጫነውን አውድ የሚያደናቅፍ ነው።
  2. መግለጫውን እንደ ቀስቅሴ ይፃፉ። ክህሎቱ ምን እንደሚሰራ እና መቼ እንደሚጠቀሙበት፣ ተጠቃሚዎች በትክክል እንደሚተይቡ በሚሉት ቃላት ይግለጹ።
  3. ሰውነትን አጭር እና አስፈላጊ አድርገው ይያዙ። ደረጃዎች፣ guardrails እና ነባሪዎች። ጥልቀትን ወደ ውስጥ ውሰድ references/ ስለዚህ አስፈላጊ በሚሆንበት ጊዜ ብቻ ይጫናል።
  4. በስክሪፕቶች ውስጥ የተወሰነ ስራን ያስቀምጡ። አንድ እርምጃ በእያንዳንዱ ጊዜ በተመሳሳይ መንገድ መከሰት ካለበት (ውቅርን ማረጋገጥ፣ የውጤት ቅርጸት)፣ ሞዴሉ መተርጎም ያለበትን ከመግለጽ ይልቅ ስክሪፕት ይላኩ።
  5. ደህንነቱ የተጠበቀውን መንገድ ኮድ ያስገቡ። ወኪሉ በፍፁም ማድረግ የሌለበትን ነገር ይግለጹ፡ ማረጋገጫውን ይዝለሉ፣ ቼኮችን ያሰናክሉ፣ የምርት ምስክርነቶችን ይጠቀሙ። ወኪሎች ከተዘዋዋሪ ደንቦች ይልቅ ግልጽ የሆኑ ደንቦችን ይከተላሉ።
  6. ስሪት እና እንደ ኮድ ይሞክሩት። ክህሎቶችን በማከማቻ ውስጥ ያስቀምጡ፣ ለውጦችን ይገምግሙ pull requests እና ከመልቀቃቸው በፊት ከእውነተኛ ተግባራት ጋር ይሞክሯቸው።

ምርትዎ ድርጊቶችን የሚያጋልጥ ከሆነ ክህሎቱን ከMCP አገልጋይ ጋር ያጣምሩት። MCP ለወኪሉ የመሳሪያዎችዎን መዳረሻ ይሰጠዋል፤ ክህሎቱ እንዴት በጥሩ ሁኔታ መጠቀም እንዳለበት ያስተምረዋል። ​​→ የሞዴል አውድ ፕሮቶኮል (MCP) ምንድን ነው?

የ SKILL.md ፋይል ምንድነው? የጎረቤት ውሎች
#

እነዚህ ግራ ይጋባሉ፣ ይህም የዲዛይን እና የግምገማ ውይይቶችን ያደናቅፋል።

  • Agents.md እና CLAUDE.md ሁልጊዜም በፋይሎች ላይ ናቸው፡- በእያንዳንዱ ክፍለ ጊዜ በማከማቻ ውስጥ ያሉ አጠቃላይ ኮንቬንሽኖች ይጫናሉ። ክህሎቶች በፍላጎት ይጫናሉ።
  • የኤምሲፒ አገልጋይ መሳሪያዎችን እና መረጃዎችን ያጋልጣል። የ SKILL.md ፋይል እውቀት እና ሂደት ይዟል። እርስ በእርስ ይጣጣማሉ።
  • የስርዓት ጥያቄ ለአንድ መተግበሪያ የተወሰነ መመሪያ ነው። ክህሎት ተንቀሳቃሽ እና በተወካዮች መካከል እንደገና ጥቅም ላይ ሊውል የሚችል ነው።
  • የደንቦች ፋይል (እንደ የጠቋሚ ደንብ ፋይል ያሉ) የረዳት ባህሪን በአንድ መሳሪያ ውስጥ ይመራል። ተመሳሳይ የአደጋ መገለጫ፣ ጠባብ ተንቀሳቃሽነት።
  • llms.txt ሞዴሎች ሰነዶችዎን እንዲያነቡ ይረዳል። ክህሎት አንድ ወኪል ምን ማድረግ እንዳለበት ይነግረዋል።

እነሱ ንብርብሮች ናቸው፣ ተወዳዳሪዎች አይደሉም። የሚጋሩት ነገር እያንዳንዱ ግልጽ ጽሑፍ ሲሆን የ AI ወኪል የሚያደርገውን ነገር ይለውጣል፣ እና እያንዳንዱም ብዙውን ጊዜ እንደ ሰነድ ይገመገማል።

Standardየስጋትን ትርጉም የሚቀርጹት የ SKILL.md #

አንድን ምንጭ በህትመት ሁኔታ ይፍረዱ፣ አሁን ባለው ድምፅ ሳይሆን።

ምንጭሁናቴይህን መጠቀም የሚቻለው እንዴት ነው?
የወኪል ክህሎቶች ዝርዝር መግለጫክፈት standard, የታተመው ታህሳስ 2025ቅርጸቱ ራሱ፡ የአቃፊ መዋቅር፣ የፊት ጉዳይ እና የመጫኛ ሞዴል
የሞዴል አውድ ፕሮቶኮልክፍት ፕሮቶኮል፣ በንቃት እየተሻሻለክህሎቶች የሚያሟሉ የመሳሪያ እና የውሂብ መዳረሻ ንብርብር
ለኤልኤልኤም አፕሊኬሽኖች ከፍተኛ 10 የ OWASPየታተመ፣ የአሁኑ እትምፈጣን መርፌ፣ የአቅርቦት ሰንሰለት እና ከመጠን በላይ ወኪል የመሆን ስጋት ታክሶኖሚ
ለወኪል አፕሊኬሽኖች ከፍተኛ 10 የ OWASPየታተመው ታህሳስ 2025ወኪል-ተኮር አደጋ። በስም ይጥቀሱ፣ የቅርብ ጊዜነቱን ልብ ይበሉ
ሚትር አትላስሕያው የእውቀት መሰረት፣ ያለማቋረጥ ይዘምናልየሰነድ የጉዳይ ጥናቶችን ጨምሮ የስጋት ሞዴሊንግ፣ የደንቦችን ፋይል የኋላ በርን ጨምሮ

አደጋው በሰነድ ተመዝግቧል፣ ግምታዊ አይደለም። MITRE ATLAS በደንቦች ፋይል ውስጥ የተደበቁ መመሪያዎች አንድ ረዳት ምንም የሚታይ ዱካ የሌለው የኋላ በር ኮድ እንዲያመነጭ የሚመራበትን ጥቃት ካታሎግ ያደርጋል። ተንኮል አዘል የSKILL.md ፋይል በተመሳሳይ መንገድ ይሰራል፣ እና ስክሪፕቶችን የሚያጠቃልል ክህሎት ኮድን መፈጸም እና ማስተማር ይችላል። የማህበረሰብ ክህሎትን መጫን ተመሳሳይ እምነት አለውcision እንደ ፓኬጅ መጫን። → ፈጣን መርፌ ምንድን ነው?

ከትርጓሜ እስከ ፕሮግራም #

የ SKILL.md ፋይል ምን እንደሆነ ማወቅ በማከማቻዎችዎ ውስጥ ስንት ሰዎች እንዳሉ፣ ማን እንዳከላቸው ወይም ወኪሎች ምን እንዲያደርጉ እንደሚያዝዙ አይነግርዎትም።

ያ ክፍተት በሚገመት ቅደም ተከተል ይዘጋል። በኮድዎ ውስጥ ያሉትን ሁሉንም ክህሎቶች፣ የደንብ ፋይሎች እና የMCP ውቅር ያግኙ፣ ማንም ያላወቃቸውን ጨምሮ። እንደ ሰነድ ሳይሆን እንደ የደህንነት ቅርሶች ይተነትኗቸው። ከዚያም ኦዲተር ወይም የክስተት ምላሽ ሰጪ የትኞቹ የወኪል ሀብቶች እንዳሉ እና እንዴት እንደሚገናኙ ማየት እንዲችሉ መዝገቡን ወቅታዊ ያድርጉት።

የኤጂኔ አይአይ ደህንነት ከኮድዎ ያንን መዝገብ ይገነባል። ክህሎቶች ከሞዴሎች፣ የውሂብ ስብስቦች፣ የግምታዊ መጨረሻ ነጥቦች፣ ወኪሎች፣ የMCP አገልጋዮች፣ ጥያቄዎች፣ guardrails እና የAI ኮድ ማድረጊያ መሳሪያዎች በተከታታይ የAI ክምችት ውስጥ፣ እያንዳንዳቸው የአደጋ ነጥብ፣ አቅራቢ፣ አይነት እና ትክክለኛ ቦታ በኮድ ውስጥ አላቸው። Xygeni የክህሎት ፋይሎችን ይተነትናል፣ ፋይሎችን እና የMCP ውቅሮችን እንደ የደህንነት ቅርሶች ይቆጣጠራሉ፣ እና ተንኮል አዘል የሆኑትን ይጠቁማል። የAI ግራፉ የትኛው ወኪል የትኛው መሳሪያ ላይ እንደሚደርስ ያሳያል፣ እና ማሽን-ሊነበብ የሚችል AI-BOM ከተመሳሳይ ግኝት ወደ ውጭ ይላካል። → የ AI BOM ምንድን ነው? ና ሻዶው ኤአይ ምንድን ነው?

አንድ ማሳያ ፕሮግራም ያውጡ በAI ክምችትዎ ውስጥ ያሉትን የወኪል ክህሎቶች ለማየት።

በየጥ #

በቀላል አነጋገር የ SKILL.md ፋይል ምንድን ነው?

የኤአይ ወኪል አንድ የተወሰነ ተግባር እንዴት ማከናወን እንዳለበት የሚያስተምር የማርክዳውን ፋይል፣ ያ ተግባር ሲመጣ ብቻ የሚጫን።

የ SKILL.md ፋይሎች የት ይኖራሉ?

በአንድ ክህሎት በአንድ አቃፊ ውስጥ፣ ብዙውን ጊዜ በፕሮጀክት ማከማቻ ወይም በተጠቃሚ ወኪል ውቅር ማውጫ ውስጥ። ትክክለኛው ቦታ የሚወሰነው በወኪሉ ላይ ነው።

የወኪል ክህሎቶች በተለያዩ የ AI ወኪሎች ላይ ይሰራሉ?

አዎ፣ ሁለቱም የወኪል ክህሎቶች ዝርዝር መግለጫን ሲከተሉ። ተመሳሳዩ የSKILL.md ፋይል በማንኛውም ተኳሃኝ ወኪል ውስጥ ያለምንም ለውጦች ይሰራል።

ምርቴ የSKILL.md ፋይል መላክ አለበት?

ገንቢዎች ምርትዎን ለማዋቀር ወይም ለማንቀሳቀስ የAI ወኪሎችን የሚጠቀሙ ከሆነ፣ አዎ። ወኪሎች በትክክል እና ደህንነቱ በተጠበቀ ሁኔታ እንደሚጠቀሙበት ለማረጋገጥ በጣም ቀጥተኛው መንገድ ነው።

የ SKILL.md ፋይሎች የደህንነት ስጋት ናቸው?

እነሱ ሊሆኑ ይችላሉ። ክህሎት ማለት ወኪሉ የሚከተለው መመሪያ ሲሆን ሊተገበሩ የሚችሉ ስክሪፕቶችን ሊያጠቃልል ይችላል። እንደ ኮድ ያሉ ክህሎቶችን ይገምግሙ፣ የማህበረሰብ ክህሎቶችን ከሚያምኗቸው ምንጮች ብቻ ይጫኑ፣ እና በማከማቻዎችዎ ውስጥ የትኞቹ ክህሎቶች እንዳሉ ዝርዝር ያስቀምጡ።

በነጻ ጀምር

በነፃ ይጀምሩ።
ምንም ዱቤ ካርድ አያስፈልግም።

በአንድ ጠቅታ ይጀምሩ፦

ይህ መረጃ በተጠቀሰው መሰረት ደህንነቱ በተጠበቀ ሁኔታ ይቀመጣል የአገልግሎት ውል ና የ ግል የሆነ

የመተግበሪያ ቅጽበታዊ ገጽ እይታ