دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

دير تدقيق آمن على تعليمات الذكاء الاصطناعي القديمة باستعمال Skill Sunset

تعلّم كيفاش تستعمل Skill Sunset باش تدير تدقيق لملفات AGENTS.md وCLAUDE.md وSKILL.md وتلقى الإحالات المكسورة، والتكرار، والتعليمات الكبيرة بزاف، والقواعد اللي ممكن تكون ولات قديمة. هاد الدليل كيغطي الإعداد، وإنشاء التقرير، والدمج مع CI، والتجارب السلوكية، والإصلاح الآمن، والتراجع.

حوالي 19 دقايق ديال القراية
تدقيق آمن على تعليمات الذكاء الاصطناعي القديمة باستعمال Skill Sunset

شنو هو Skill Sunset؟

Skill Sunset هي أداة كتخدم من سطر الأوامر باش تراجع التعليمات ديال وكلاء الذكاء الاصطناعي المتراكمة. كتفحص ملفات بحال AGENTS.md وCLAUDE.md وSKILL.md باش تلقى الإشارات القديمة، والـSkills المكررة، والمحتوى الكبير اللي كيتحمّل ديما، وبيانات frontmatter غير الصحيحة، ومشاكل أخرى ديال الصيانة.

الأداة كاتجمع بين فحوصات حتمية وفرضيات حذرة للمراجعة. ما كتعتبرش كل تعليمة باينة قديمة غير صالحة، وحتى نتيجة ما كتعطيش الإذن بالحذف. عوض هاد الشي، كتفرّق بين المشاكل اللي يمكن التحقق منها بشكل ثابت والقواعد المرتابطة بالسلوك اللي خاصها الاختبار.

مهم: نتيجة TEST كتعني «قيّم هاد الفرضية». ما كتعنيش باللي نموذج ذكاء اصطناعي أحدث خلا التعليمة ما بقاتش ضرورية.

التدقيق كيتدار محلياً وبطريقة للقراءة فقط. النواة ديالو ما كتعيطش لأي API ديال الذكاء الاصطناعي، وما كتستهلكش حصة النماذج، وما كتقراش بيانات الدخول ديال المزوّدين.

تقرير تدقيق Skill Sunset مولّد انطلاقاً من بيانات اختبار

الخصائص الرئيسية

  • فحوصات ثابتة للتعليمات: كتلقى الإشارات المحلية المكسورة، والمسارات المطلقة القديمة، وبيانات frontmatter غير الصحيحة ديال Skill، والملفات الكبيرة اللي كيتحمّلو ديما، وبيانات الدخول المحتملة المكتوبة بصيغة واضحة.
  • تدبير حذر للتكرارات: كتكتاشف Skills بنفس الاسم وكتتحقق من الحزمة كاملة قبل ما توصي بإحالتها للتقاعد بطريقة قابلة للاسترجاع.
  • فرضيات السلوك: كتصنّف قواعد التعويض المرتابطة بعصر النماذج على أنها TEST بلا ما تصرّح بأنها ولات قديمة.
  • صيغ متعددة للتقارير: كتنتج صفحات HTML ثنائية اللغة، وMarkdown، وJSON، ومحفزات تسليم لـCodex وClaude، وخطة تقييم، وقالب تجربة، وبيان تغييرات قابل للتراجع.
  • فئات محمية من التعليمات: كتستثني المعرفة الخاصة بالمجال، وقواعد السلامة، وبوابات التفويض، وثوابت المشروع من الإحالة التلقائية للتقاعد.
  • دعم CI: تقدر ترجع رموز خروج مبنية على مستوى الخطورة من خلال --fail-on.
  • تقارير كتراعي الخصوصية: كتحجب المسارات اللي تحت مجلد المستخدم وكتعرضها بصيغة $HOME/...، وكتُمثّل الأهداف المطلقة الأخرى بصيغة $ABSOLUTE/<name>.

المتطلبات والبيئات المدعومة

Skill Sunset كتدعم Node.js 20 و22 و24. وكتتختبر عبر GitHub Actions فـUbuntu وmacOS وWindows. من المتوقّع تخدم حتى فالتوزيعات الأخرى ديال Linux مع Node.js 20 أو أحدث، ولكن ما داخلاش حالياً فمصفوفة CI ديال المشروع.

كاينين أهداف فحص جاهزة لـCodex فـ~/.codex وClaude Code فـ~/.claude. وتقدر حتى تدير تدقيق لأي مجلد محدد ومحصور كتزوّد به بشكل صريح.

التثبيت والإعداد

ما كايناش حاجة لتثبيت عام. شغّل آخر حزمة منشورة مباشرة باستعمال npx:

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

هاد الأمر كيدير تدقيق لإعداد Codex وكيفتح تقرير HTML المولّد. باش تدير تدقيق لـClaude Code، شغّل:

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

باش تفحص مشروع أو مجلد آخر محصور، دوز المسار ديالو للأمر audit:

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

لغة التقرير الرئيسية كتكون افتراضياً --lang auto. اختار اللغة بشكل صريح باستعمال --lang en أو --lang zh-CN. كل حزمة ديال التقارير كتبقى فيها صفحات HTML محمولة بالإنجليزية والصينية المبسطة.

دير أول تدقيق ديالك

دقّق فالمجلد الحالي

قبل ما تبدّل ملفات التعليمات، دير نسخة قابلة للاسترجاع. مثلاً، نسخ AGENTS.md الاحتياطية وكتب التقرير فمجلد مخصص:

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

التدقيق كيتدار للقراءة فقط. كيعرض أعمال الصيانة المحتملة، ولكن ما كيبدّلش وما كيحذفش الملفات اللي تفحصات.

فهم حزمة التقرير

افتراضياً، الحزمة المولّدة تقدر تحتوي على الآثار التالية:

.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

استعمل ملفات HTML للمراجعة البشرية التفاعلية، وaudit-report.md لتقرير نصي محمول، وaudit.json للأتمتة. محفزات التنفيذ كتدعم التسليم لـCodex أو Claude Code، بينما خطة التقييم وقالب التجربة كيساعدو فالتثبت من فرضيات السلوك.

الملف المولّد rollback-manifest.json كيبقى خاوي حتى يسجّل وكيل تنفيذ مفوّض التغييرات الفعلية والهاشات.

فهم النتائج

  • MERGE: التكرارات المطابقة تماماً أو Skills اللي عندها نفس الاسم ولكن متعارضة خاصها المراجعة بهدف الدمج.
  • UPDATE: مسار أو إشارة أو افتراض متعلق بأداة أو تعليمة مرتبطة بإصدار معيّن يمكن تحتاج التصحيح.
  • DEMOTE: تفاصيل مفيدة كيتحمّل نطاق واسع بزاف، ويمكن خاصها تكون ضمن الكشف التدريجي.
  • RETIRE: كاينين داخل جذر فحص واحد حزم Skills عامة، كاملة، ومطابقة على مستوى البايت، وعندها نفس الاسم. التوصية الوحيدة هي الأرشفة القابلة للاسترجاع.
  • TEST: ادعاء محتمل بأن شيئاً ولى قديماً كيتطلب تقييماً سلوكياً بين القديم والجديد قبل التنظيف.

هاد النتائج هي فئات للمراجعة، وماشي موافقات تلقائية على التغيير. أكد كل مشكل بالرجوع للمستودع، والأدوات الحالية، والمهام التمثيلية قبل ما تعدّل شي تعليمة.

مثال: من النتيجة إلى التراجع

نفترضو أن ملف AGENTS.md فيه شرط غير مشروط لاستعمال أداة، ورابط لدليل نشر مفقود:

استعمل Context7 ديما فكل مهمة.
[دليل النشر](docs/deploy.md)

إلا ما كانش docs/deploy.md موجود، يقدر Skill Sunset يبلّغ على ثلاثة ديال المخاوف المميّزة:

  • UPDATE / broken-reference حيث ما قدرش يلقى الهدف ديال دليل النشر.
  • UPDATE / context7-assumption حيث خاص التحقّق من توفّر الأدوات دابا.
  • TEST / unconditional-tooling حيث عبارة «فكل مهمة» كتحتاج تقييم سلوكي تمثيلي.

طبّق غير التغييرات المؤكّدة

فالأول، لقا دليل النشر الحقيقي وتحقّق من لائحة الأدوات الحالية. صحّح غير المرجع القديم اللي قدرت تأكّد منو. اعتبر قاعدة الاستعمال غير المشروط للأدوات مرشّحاً لتجربة مستقلة، وما تحيدهاش غير اعتماداً على التقرير الثابت.

من بعد التعديل، عاود دير التدقيق واختبارات المشروع الخاصة بيه:

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

تحقّق من نتيجة TEST

بالنسبة لعنصر TEST، كمّل .skill-sunset/experiment-template.json اللي تولّد. تحقّق من المانيفست بلا ما تنفّذ الأوامر ديالو:

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

التحقّق بوحدو ما كيشغّل حتى أمر. التنفيذ كيتطلب الخيار المنفصل --run:

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

التجربة الناجحة كتثبت غير معايير القبول المضمّنة فداك المانيفست. وما كتثبتش بلي التعليمات ما عندها حتى فائدة بشكل عام.

رجّع التغيير إلا وقع تراجع

إلا وقع تراجع فالروابط، ولا فاختبارات المشروع، ولا فسلوك المهمة، رجّع الملف المحفوظ وعاود دير التدقيق:

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

استعمل Skill Sunset فـ CI

طلب إخراج بصيغة JSON وحدّد عتبة الخطورة للأتمتة:

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

هاد الصيغة مناسبة لخطوط CI اللي محتاجة إخراج قابل للقراءة آلياً وشرط فشل بالنسبة للنتائج عالية الخطورة. راجع ملف JSON الناتج، وما تعتبرش حالة الخروج ترخيصاً لتبديل التعليمات ولا حذفها.

نصائح متقدّمة للسلامة وسير العمل

خلّي جذور الفحص محدودة

مرّر أصغر مجلد فيه إعدادات التعليمات اللي باغي تدير ليها التدقيق. تحليل التكرارات وتوصيات التقاعد كتتقيّم داخل جذر فحص واحد، وهاد الحدّ الواضح كيخلّي النتائج أسهل فالفهم.

فرّق بين الإصلاحات الثابتة والتغييرات السلوكية

الروابط المعطوبة والمسارات القديمة المؤكّدة غالباً يمكن التحقّق منها مباشرة. القواعد اللي كتهم سلوك النموذج ولا الاستعمال غير المشروط للأدوات خاصها تبقى مرشّحات مستقلة، بمعايير قبول واضحة، ومهام تمثيلية، وخطة للرجوع.

اعتبر تنفيذ التجارب امتيازاً خاصاً

مانيفستات التجارب كتكون غير للتحقّق إلا إلا تعطات --run. الأوامر كتتنفّذ بلا shell وكتتوصل افتراضياً بلائحة صغيرة من متغيّرات البيئة المسموح بها، بلا أسرار.

توريث البيئة كاملة كيتطلب --inherit-env بالإضافة إلى --run. حيث المتغيّرات الموروثة تقدر تكون فيها بيانات اعتماد المزوّد، استعمل هاد الخيار غير مع أوامر موثوقة. ما تحطّش بيانات الاعتماد فمانيفست التجربة أبداً.

فهم بيانات التجارب المحفوظة

التشغيلات الجافة وملفات النتائج كتحافظ على أسماء الملفات التنفيذية، وعدد الوسائط، وبصمات الأوامر، وأحجام المخرجات، وبصمات المخرجات. وما كتحافظش على وسائط الأوامر ولا على محتوى المخرجات. هاد الشي كيقلّل من الانكشاف، ولكن خاص مراجعة تعريفات التجارب والأوامر بعناية.

ما تعتبرش فحص الأسرار دليلاً قاطعاً

يقدر Skill Sunset يعلّم على بيانات اعتماد محتملة مكتوبة بشكل صريح، والمشروع كيستعمل Gitleaks كحاجز قبل النشر. ولكن README كيوضّح صراحةً أن هاد الشي ماشي دليلاً على إمكانية التعرّف على كل صيَغ بيانات الاعتماد.

التطوير المحلي

باش تخدم على المستودع براسو، شغّل الاختبارات ديالو، وعاين محتويات الحزمة، وولّد تقريراً تجريبياً من الـ fixture المرفق:

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

سير عمل GitHub Actions ديال المشروع كيشغّل Gitleaks والاختبارات على مصفوفة أنظمة التشغيل وNode.js اللي كيدعمها. كاينة معلومات إضافية على المشروع فـ سجل التغييرات، ودليل المساهمة، وسياسة الأمان ديال المستودع.

النطاق الحالي

الإصدار 0.2.0 كيوفّر فحوصات ثابتة، وتقاعداً محافظاً للتكرارات، وتقارير محلية، وحجب المسارات، وإطاراً لتجارب الأوامر مقيّداً، ومخارج CI حسب مستوى الخطورة، واختبارات للمخرجات العدائية. لقطات قدرات المزوّد الحالي، ومحوّلات استعمال الجلسات، ومحوّلات جودة المهام موصوفة كطبقات أدلة مستقبلية، وماشي كميزات موجودة دابا.

الخلاصة

كيقدّم Skill Sunset سير عمل حذراً لصيانة ملفات تعليمات الذكاء الاصطناعي بلا ما يفترض أن القواعد القديمة ولات بالضرورة بلا فائدة. بدا بتدقيق للقراءة فقط، وفرّق بين المشاكل الحتمية والفرضيات السلوكية، وتحقّق من التغييرات باختبارات المشروع وتجارب مضبوطة، وحافظ على مسار قابل للاسترجاع للرجوع طوال العملية.