المهارات changelog-automation
📦

changelog-automation

آمن

أتمتة إنشاء سجل التغييرات وسير عمل الإصدارات

إدارة سجل التغييرات يدويًا عرضة للأخطاء وتستغرق وقتًا طويلاً. توفر هذه المهارة أنماطًا وأدوات لأتمتة إنشاء سجل التغييرات وملاحظات الإصدار وإدارة الإصدارات وفقًا للمعايير الصناعية مثل Keep a Changelog و Conventional Commits.

يدعم: Claude Codex Code(CC)
📊 69 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "changelog-automation". Show me a basic Keep a Changelog template

النتيجة المتوقعة:

قالب markdown مع أقسام لـ Unreleased و Added و Changed و Deprecated و Removed و Fixed و Security، يتبع مواصفات keepachangelog.com مع روابط الإصدار الدلالي المناسبة.

استخدام "changelog-automation". What are the Conventional Commit types I should use?

النتيجة المتوقعة:

  • feat: ميزات جديدة (تؤدي إلى زيادة MINOR)
  • fix: إصلاحات الأخطاء (تؤدي إلى زيادة PATCH)
  • docs: تغييرات التوثيق (لا زيادة في الإصدار)
  • refactor: إعادة هيكلة الكود (تتعامل مع قسم Changed)
  • perf: تحسينات الأداء (تتعامل مع قسم Changed)
  • test: إضافات الاختبار (لا زيادة في الإصدار)
  • chore: مهام الصيانة (لا زيادة في الإصدار)

استخدام "changelog-automation". Configure git-cliff for my Rust project

النتيجة المتوقعة:

ملف تكوين cliff.toml كامل مع تحليل conventional commits وتكامل GitHub وأقسام قالب سجل التغييرات المُنسقة وفقًا لمعايير Keep a Changelog.

التدقيق الأمني

آمن
v5 • 1/21/2026

This skill contains documentation and configuration templates for changelog automation tools. All static findings are false positives: network URLs are documentation references to keepachangelog.com and semver.org, backtick patterns are code examples in markdown format, and env_access references are configuration samples for GitHub Actions workflows. No executable code or security risks detected.

2
الملفات التي تم فحصها
1,378
الأسطر التي تم تحليلها
0
النتائج
5
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
22
المجتمع
100
الأمان
87
الامتثال للمواصفات

ماذا يمكنك بناءه

إعداد الإصدار لمشروع جديد

إعداد إنشاء تلقائي لسجل التغييرات لمشروع Node.js جديد باستخدام standard-version و commitlint و GitHub Actions لسير عمل الإصدار المتسق.

الانتقال إلى Conventional Commits

ترحيل مشروع موجود إلى معيار Conventional Commits مع التحقق والتجزئة التلقائية وإنشاء سجل التغييرات لتحسين اتساق الإصدار.

أتمتة الإصدار متعددة اللغات

تكوين أتمتة سجل التغييرات للمشاريع بلغات مختلفة باستخدام أدوات مناسبة مثل semantic-release لـ Node.js أو commitizen لـ Python.

جرّب هذه الموجهات

إعداد أساسي لسجل التغييرات
ساعدني في إعداد ملف CHANGELOG.md بتنسيق Keep a Changelog لمشروعي
تكوين Conventional Commits
تكوين commitlint و husky لفرض Conventional Commits في مشروعي Node.js
أتمتة سير عمل الإصدار
إنشاء سير عمل GitHub Actions الذي ينشئ سجلات التغييرات تلقائيًا وينشئ الإصدارات باستخدام semantic-release
تكوين إصدار مخصص
تكوين standard-version مع أنواع تغييرات مخصصة وأقسام سجل تغييرات محددة لبنية مشروعي

أفضل الممارسات

  • استخدم commitlint مع husky للتحقق من رسائل التغييرات قبل إنشائها، مما يمنع التغييرات غير الصالحة من دخول المستودع
  • تكوين سير عمل منفصل للإصدارات اليدوية والآلية لدعم كل من الإصدارات المجدولة والإصلاحات العاجلة
  • تحديد اتفاقيات واضحة لأنواع التغييرات في وثائق الفريق وتكوين المحللات لتتناسب مع احتياجات سير العمل المحددة لديك

تجنب

  • لا تعدل ملفات CHANGELOG.md المُنشأة يدويًا حيث سيتم الكتابة فوقها في الإصدار الآلي التالي
  • تجنب خلط تغييرات متعددة غير ذات صلة في تغيير واحد، مما يجعل التصنيف الآلي غير دقيق
  • لا تتخطى التحقق من commitlint أثناء التطوير حيث يؤدي إلى سجلات تغييرات غير متسقة وأتمتة معطلة

الأسئلة المتكررة

ما الفرق بين standard-version و semantic-release؟
يتطلب standard-version تشغيلًا يدويًا ويمنحك التحكم في وقت حدوث الإصدارات، بينما يقوم semantic-release بأتمتة الإصدارات بالكامل بناءً على رسائل التغييرات في CI/CD. استخدم standard-version للموافقة اليدوية على الإصدار، semantic-release للأتمتة الكاملة.
كيف أتعامل مع التغييرات المتغيرة في تغييراتي؟
أضف علامة تعجب بعد النوع (feat!) أو قم بتضمين BREAKING CHANGE: في ذيل التغيير. يؤدي هذا إلى زيادة MAJOR ويبرز التغيير بشكل بارز في سجل التغييرات.
هل يمكنني تخصيص أنواع التغييرات التي تظهر في سجل التغييرات؟
نعم، تدعم جميع الأدوات التخصيص. في standard-version استخدم .versionrc.js، في semantic-release استخدم خيارات commit-analyzer، وفي git-cliff استخدم commit_parsers في cliff.toml. اضبط hidden: true أو skip: true لاستبعاد الأنواع.
أي أداة يجب أن أستخدمها لمشروع Python؟
استخدم commitizen لمشاريع Python. يتكامل مع pyproject.toml، ويدعم التغييرات التفاعلية، ويمكنه تحديث ملفات الإصدارات في حزم Python تلقائيًا.
كيف أرحبيل مشروع موجود إلى Conventional Commits؟
ابدأ بإضافة تكوين commitlint و hooks husky، ثم استخدم changelog_start_rev للبدء من إصدار محدد. يمكن أن تبقى التغييرات السابقة بتنسيق قديم بينما تتبع التغييرات الجديدة الاتفاقية.
ما الأذونات التي تحتاجها GitHub Actions للإصدارات الآلية؟
يحتاج سير العمل إلى إذن contents: write لإنشاء الإصدارات والتغييرات، وقد يحتاج إلى pull-requests: write لـ PRs الإصدار. استخدم GITHUB_TOKEN للعمليات الأساسية و NPM_TOKEN فقط إذا كنت تنشر في سجل npm.

تفاصيل المطور

بنية الملفات

📄 SKILL.md