Skill Sunset yordamida eskirgan AI ko‘rsatmalarini xavfsiz tekshirish

Skill Sunset nima?

Skill Sunset — to‘planib qolgan AI agent ko‘rsatmalarini tekshirish uchun mo‘ljallangan buyruq satri vositasi. U eskirgan havolalar, takrorlangan Skill’lar, doim yuklanadigan hajmi katta kontent, noto‘g‘ri tuzilgan frontmatter va boshqa texnik xizmat muammolarini aniqlash uchun AGENTS.md, CLAUDE.md va SKILL.md kabi fayllarni skanerlaydi.

Vositada deterministik tekshiruvlar ehtiyotkor ko‘rib chiqish gipotezalari bilan birlashtirilgan. U eski ko‘rinadigan har bir ko‘rsatmani eskirgan deb hisoblamaydi va hech bir topilma o‘chirishga ruxsat bermaydi. Buning o‘rniga, statik ravishda tekshirilishi mumkin bo‘lgan muammolarni test qilishni talab qiladigan xulq-atvor qoidalaridan ajratadi.

Muhim: TEST xulosasi “bu gipotezani baholang” degan ma’noni anglatadi. Bu yangi AI modeli ko‘rsatmani keraksiz qilib qo‘ydi degani emas.

Audit lokal ravishda va faqat o‘qish rejimida ishlaydi. Uning yadrosi AI API’siga murojaat qilmaydi, model kvotasidan foydalanmaydi va provayder hisob ma’lumotlarini o‘qimaydi.

Asosiy imkoniyatlar

• Statik ko‘rsatma tekshiruvlari: Buzilgan lokal havolalar, eskirgan mutlaq yo‘llar, noto‘g‘ri tuzilgan Skill frontmatter’i, doim yuklanadigan hajmi katta fayllar va ochiq matndagi ehtimoliy hisob ma’lumotlarini topadi.
• Ehtiyotkor dublikatlarni boshqarish: Bir xil nomdagi Skill’larni aniqlaydi va qayta tiklanadigan arxivlashni tavsiya qilishdan oldin to‘liq to‘plamni tekshiradi.
• Xulq-atvor gipotezalari: Model avlodiga bog‘liq kompensatsiya qoidalarini eskirgan deb e’lon qilish o‘rniga TEST sifatida belgilaydi.
• Bir nechta hisobot formatlari: Ikki tilli HTML, Markdown, JSON, Codex va Claude uchun topshirish promptlari, baholash rejasi, tajriba shabloni hamda qaytarish manifestini yaratadi.
• Himoyalangan ko‘rsatma toifalari: Domen bilimlari, xavfsizlik qoidalari, avtorizatsiya to‘siqlari va loyiha invariantlarini avtomatik arxivlashdan chiqarib tashlaydi.
• CI qo‘llab-quvvatlashi: --fail-on orqali jiddiylik darajasiga asoslangan chiqish kodlarini qaytarishi mumkin.
• Maxfiylikni hisobga oluvchi hisobotlar: Foydalanuvchi uy katalogi ichidagi yo‘llarni $HOME/... ko‘rinishida yashiradi, boshqa mutlaq manzillarni esa $ABSOLUTE/<name> sifatida ifodalaydi.

Talablar va qo‘llab-quvvatlanadigan muhitlar

Skill Sunset Node.js 20, 22 va 24 versiyalarini qo‘llab-quvvatlaydi. U Ubuntu, macOS va Windows tizimlarida GitHub Actions orqali tekshiriladi. Boshqa Linux distributivlarida ham Node.js 20 yoki undan yangi versiya bilan ishlashi kutiladi, biroq hozircha ular loyiha CI matritsasiga kiritilmagan.

Codex uchun ~/.codex va Claude Code uchun ~/.claude manzillarida tayyor skanerlash nishonlari mavjud. Shuningdek, aniq ko‘rsatilgan har qanday cheklangan katalogni ham audit qilishingiz mumkin.

O‘rnatish va sozlash

Global o‘rnatish talab qilinmaydi. Eng so‘nggi e’lon qilingan paketni npx orqali bevosita ishga tushiring:

npx skill-sunset@latest audit --codex --open

Bu buyruq Codex konfiguratsiyasini tekshiradi va yaratilgan HTML hisobotini ochadi. Buning o‘rniga Claude Code’ni audit qilish uchun quyidagini ishga tushiring:

npx skill-sunset@latest audit --claude --open

Loyihani yoki boshqa cheklangan katalogni skanerlash uchun uning yo‘lini audit buyrug‘iga uzating:

npx skill-sunset@latest audit /path/to/setup

Asosiy hisobot tili sukut bo‘yicha --lang auto qilib belgilanadi. --lang en yoki --lang zh-CN orqali tilni aniq tanlang. Har bir hisobot to‘plamida baribir inglizcha va soddalashtirilgan xitoycha ko‘chma HTML sahifalari bo‘ladi.

Birinchi auditingizni ishga tushiring

Joriy katalogni audit qilish

Ko‘rsatma fayllarini o‘zgartirishdan oldin qayta tiklash mumkin bo‘lgan nusxa yarating. Masalan, AGENTS.md faylining zaxira nusxasini yarating va hisobotni alohida katalogga yozing:

cp AGENTS.md AGENTS.md.skill-sunset.bak
npx skill-sunset@latest audit . --out .skill-sunset --open

Audit faqat o‘qish rejimida ishlaydi. U ehtimoliy texnik xizmat ishlarini bildiradi, ammo skanerlangan fayllarni o‘zgartirmaydi yoki o‘chirmaydi.

Hisobot to‘plamini tushunish

Sukut bo‘yicha yaratilgan to‘plam quyidagi artefaktlarni o‘z ichiga olishi mumkin:

.skill-sunset/
├── index.html
├── index.en.html
├── index.zh-CN.html
├── audit-report.md
├── audit.json
├── execution-prompt-codex.md
├── execution-prompt-claude.md
├── eval-plan.md
├── experiment-template.json
└── rollback-manifest.json

Interaktiv inson tekshiruvi uchun HTML fayllaridan, ko‘chma matnli hisobot uchun audit-report.md dan, avtomatlashtirish uchun esa audit.json dan foydalaning. Bajarish promptlari Codex yoki Claude Code’ga topshirishni qo‘llab-quvvatlaydi, baholash rejasi va tajriba shabloni esa xulq-atvor gipotezalarini tasdiqlashga yordam beradi.

Yaratilgan rollback-manifest.json vakolatli ijro agenti haqiqiy o‘zgarishlar va xeshlarni qayd etmaguncha bo‘sh qoladi.

Xulosalarni talqin qilish

• MERGE: Aniq dublikatlar yoki bir xil nomdagi qarama-qarshi Skill’lar birlashtirish uchun ko‘rib chiqilishi kerak.
• UPDATE: Yo‘l, havola, vosita haqidagi taxmin yoki versiyaga bog‘langan ko‘rsatma tuzatishni talab qilishi mumkin.
• DEMOTE: Foydali tafsilot haddan tashqari keng yuklanadi va bosqichma-bosqich ochib berishga ko‘chirilishi mumkin.
• RETIRE: Bitta skanerlash ildizi ichida bir xil nomga ega baytma-bayt bir xil, to‘liq va umumiy Skill to‘plamlari mavjud. Faqat qayta tiklanadigan arxivlash tavsiya etiladi.
• TEST: Ehtimoliy eskirganlik haqidagi da’vo tozalashdan oldin eski va yangi xulq-atvorni baholashni talab qiladi.

Bu xulosalar ko‘rib chiqish toifalaridir, avtomatik o‘zgartirishga berilgan ruxsat emas. Ko‘rsatmani tahrirlashdan oldin har bir muammoni repozitoriy, joriy vositalar va odatiy vazifalar asosida tasdiqlang.

Misol: topilmadan qaytarishgacha

Faraz qilaylik, AGENTS.md faylida vositadan shartsiz foydalanish talabi va mavjud bo‘lmagan joylashtirish qo‘llanmasiga havola bor:

Har bir vazifa uchun doimo Context7-dan foydalaning.
[Joylashtirish bo‘yicha qo‘llanma](docs/deploy.md)

Agar docs/deploy.md mavjud bo‘lmasa, Skill Sunset uchta alohida muammoni ko‘rsatishi mumkin:

• UPDATE / broken-reference, chunki qo‘llanma manzili aniqlanmadi.
• UPDATE / context7-assumption, chunki joriy vositalar mavjudligini tekshirish kerak.
• TEST / unconditional-tooling, chunki “har bir vazifa uchun” talabi amaliy xatti-harakatni namunaviy tarzda baholashni talab qiladi.

Faqat Tasdiqlangan O‘zgarishlarni Qo‘llang

Avval haqiqiy joylashtirish bo‘yicha qo‘llanmani toping va joriy vositalar ro‘yxatini tekshiring. Faqat tasdiqlay olgan eskirgan havolani tuzating. Shartsiz vositalardan foydalanish qoidasini statik hisobotga asoslanib o‘chirib tashlamang, balki alohida tajriba nomzodi sifatida ko‘rib chiqing.

Tahrirdan so‘ng auditni va loyihaning o‘z testlarini qayta ishga tushiring:

npx skill-sunset@latest audit . --out .skill-sunset --format json
npm test

TEST Natijasini Tekshiring

TEST bandi uchun yaratilgan .skill-sunset/experiment-template.json faylini to‘ldiring. Manifestni uning buyruqlarini bajarmagan holda tekshiring:

npx skill-sunset@latest test .skill-sunset/experiment-template.json --root .

Faqat tekshirish hech qanday buyruqni ishga tushirmaydi. Bajarish uchun alohida --run bayrog‘i talab qilinadi:

npx skill-sunset@latest test .skill-sunset/experiment-template.json --root . --run

Muvaffaqiyatli tajriba faqat manifestda kodlangan qabul qilish mezonlarini tasdiqlaydi. U ko‘rsatmaning umuman keraksiz ekanini isbotlamaydi.

Regressiyani Orqaga Qaytaring

Agar havolalar, loyiha testlari yoki vazifa xatti-harakati yomonlashsa, saqlangan faylni tiklang va auditni qayta bajaring:

cp AGENTS.md.skill-sunset.bak AGENTS.md
npx skill-sunset@latest audit . --out .skill-sunset

CI-da Skill Sunset-dan Foydalanish

JSON formatidagi chiqishni so‘rang va avtomatlashtirish uchun jiddiylik chegarasini belgilang:

npx skill-sunset@latest audit /path/to/setup --format json --fail-on high

Bu shakl mashina o‘qiy oladigan chiqish va yuqori jiddiylikdagi topilmalar uchun muvaffaqiyatsizlik shartiga muhtoj CI quvurlari uchun mos. Chiqish holatini ko‘rsatmalarni o‘zgartirish yoki o‘chirishga ruxsat deb qabul qilmasdan, JSON artefaktini ko‘rib chiqing.

Kengaytirilgan Xavfsizlik va Ish Jarayoni Bo‘yicha Maslahatlar

Skanerlash Ildizlarini Chegaralangan Holda Saqlang

Audit qilmoqchi bo‘lgan ko‘rsatmalar to‘plamini o‘z ichiga olgan eng kichik katalogni uzating. Takroriy tahlil va bekor qilish bo‘yicha tavsiyalar bitta skanerlash ildizi doirasida baholanadi, shuning uchun aniq chegara natijalarni talqin qilishni osonlashtiradi.

Statik Tuzatishlarni Xatti-Harakatdagi O‘zgarishlardan Ajrating

Uzilgan havolalar va tasdiqlangan eskirgan yo‘llar odatda bevosita tekshirilishi mumkin. Model xatti-harakati yoki vositalardan shartsiz foydalanishga oid qoidalar aniq qabul qilish mezonlari, namunaviy vazifalar va orqaga qaytarish rejasi bilan alohida nomzodlar sifatida qolishi kerak.

Tajriba Bajarilishini Imtiyozli Amal Deb Hisoblang

Tajriba manifestlari faqat tekshirish rejimida ishlaydi, faqat --run berilgandagina bajariladi. Buyruqlar shell-dan foydalanmasdan ishga tushadi va sukut bo‘yicha minimal, maxfiy bo‘lmagan muhit ruxsatnomalari ro‘yxatini oladi.

Muhitni to‘liq meros qilib olish uchun --run bilan birga --inherit-env ham talab qilinadi. Meros qilib olingan o‘zgaruvchilar provayder hisob ma’lumotlarini o‘z ichiga olishi mumkinligi sababli, bu parametrdan faqat ishonchli buyruqlar bilan foydalaning. Hisob ma’lumotlarini hech qachon tajriba manifestiga joylashtirmang.

Saqlangan Tajriba Ma’lumotlarini Tushuning

Quruq ishga tushirishlar va natija fayllarida bajariladigan nomlar, argumentlar soni, buyruq xeshlari, chiqish hajmlari va chiqish xeshlari saqlanadi. Ularda buyruq argumentlari yoki chiqish mazmuni saqlanmaydi. Bu ma’lumotlar oshkor bo‘lishini kamaytiradi, biroq tajriba ta’riflari va buyruqlar baribir diqqat bilan ko‘rib chiqilishi kerak.

Maxfiy Ma’lumotlarni Skanerlashni Isbot Deb Hisoblamang

Skill Sunset oddiy matn ko‘rinishidagi ehtimoliy hisob ma’lumotlarini belgilashi mumkin, loyiha esa nashrni himoyalash uchun Gitleaks-dan foydalanadi. Biroq README-da har bir hisob ma’lumotlari formatini aniqlash mumkinligiga bu isbot emasligi aniq qayd etilgan.

Mahalliy Ishlab Chiqish

Repositoryning o‘zida ishlash uchun uning testlarini ishga tushiring, paket tarkibini tekshiring va kiritilgan fixture-dan namoyish hisobotini yarating:

npm test
npm pack --dry-run
node ./bin/skill-sunset.js audit ./test/fixtures/sample-setup --out ./demo-report --open

Loyihaning GitHub Actions ish jarayoni Gitleaks va testlarni qo‘llab-quvvatlanadigan operatsion tizimlar hamda Node.js versiyalari matritsasida ishga tushiradi. Loyiha haqidagi qo‘shimcha ma’lumotlar repositorydagi o‘zgarishlar jurnali, hissa qo‘shish bo‘yicha qo‘llanma va xavfsizlik siyosatida mavjud.

Joriy Qamrov

0.2.0 versiyasi statik tekshiruvlar, ehtiyotkorona takroriy ko‘rsatmalarni bekor qilish, mahalliylashtirilgan hisobotlar, yo‘llarni yashirish, ruxsat bilan boshqariladigan buyruq tajriba mexanizmi, CI jiddiylik bo‘yicha chiqish kodlari va qarama-qarshi chiqish testlarini taqdim etadi. Joriy provayder imkoniyatlari suratlari, sessiyadan foydalanish adapterlari va vazifa sifati adapterlari mavjud funksiyalar emas, balki kelajakdagi dalil qatlamlari sifatida tavsiflangan.

Xulosa

Skill Sunset eski qoidalar avtomatik ravishda eskirgan deb hisoblamasdan, AI ko‘rsatmalar fayllarini saqlash uchun ehtiyotkor ish jarayonini taqdim etadi. Faqat o‘qish rejimidagi auditdan boshlang, deterministik muammolarni xatti-harakat haqidagi farazlardan ajrating, o‘zgarishlarni loyiha testlari va nazorat qilinadigan tajribalar bilan tekshiring hamda butun jarayon davomida tiklash mumkin bo‘lgan orqaga qaytarish yo‘lini saqlang.