- الرئيسية
- Docs Control
- مزامنة الملفات
مزامنة الملفات
يعمل سير عمل مزامنة الملفات في .github/workflows/sync-managed-files.yml كمهمة موازية إلى جانب إنفاذ الإعدادات، باستخدام REPO_SYNC_TOKEN (قراءة/كتابة المحتويات، قراءة/كتابة المشكلات، قراءة/كتابة طلبات السحب، قراءة البيانات الوصفية).
ويتخطى التنفيذ عند تشغيله على المستودع المصدر نفسه (docs-control)، نظرًا لأن الملفات المعتمدة توجد هنا بالفعل.
مزامنة الملفات الثابتة
Section titled “مزامنة الملفات الثابتة”يتنقل سير العمل عبر مصفوفة managed_files.files من التكوين المركزي. لكل إدخال، يجلب المحتوى المعتمد من docs-control ويقارنه بالنسخة التابعة. يتم تحديد الملفات المفقودة أو المنحرفة للمزامنة.
يتضمن بيان الملفات المدارة:
- مسارات العمل المستدعية (
enforce-repo-settings.ymlوgithub-pages-deploy.ymlوrequire-linked-issue.ymlوantigravity-review.ymlوantigravity-translate.yml) - مهارات الوكيل (
.agents/skills/demo-components/SKILL.mdو.agents/skills/i18n-translate/SKILL.md) - قوالب المشكلات وطلبات السحب
CONTRIBUTING.mdوCLAUDE.mdوAGENTS.mdوSTYLE_GUIDE.mdو.editorconfigو.gitignoreوLICENSE.pre-commit-config.yaml
الإنشاء الديناميكي لملف dependabot.yml
Section titled “الإنشاء الديناميكي لملف dependabot.yml”يكتشف سير العمل أنظمة تعريف الحزم الموجودة في المستودع التابع:
npm—package.jsonموجودpip—requirements.txtأوpyproject.tomlأوsetup.pyموجودdocker—Dockerfileموجود
ينشئ ملف .github/dependabot.yml مع إدخال لنظام github-actions (مضمن دائماً) بالإضافة إلى إدخالات لكل نظام بيئي مكتشف. تستخدم جميع الأنظمة جداول أسبوعية يوم الاثنين مع بادئات الالتزام التقليدية وتجميع التحديثات الفرعية/التصحيحية.
الإنشاء الديناميكي لملف README.md
Section titled “الإنشاء الديناميكي لملف README.md”يتلقى كل مستودع تابع ملف README.md منشأً ومبنياً من مصدرين:
README.md.tpl— قالب في جذر docs-control يحتوي على عناصر نائبة (__TITLE__و__DESCRIPTION__و__REPO_NAME__و__DOCS_URL__)docs-sites.json— يوفر التسمية القابلة للقراءة والوصف لكل مستودع عن طريق مطابقة اسم المستودع مع حقل URL