🐙 تايدي فاكتور جيت هب (TidyFactor GitHub) v1.1.0¶
محرك تشغيل، حوكمة، مشاريع Open Source، تجربة المساهمين (CX) وتجربة README للوكلاء البرمجيين¶
تحويل مستودعات GitHub من مجرد خوادم بعيدة لملفات Git إلى بيئة عمل متكاملة ومشاريع مفتوحة المصدر مستدامة تخضع لأعلى معايير الحوكمة والأمان والجودة البصرية وتجربة المطور.
🌐 الموقع الرسمي • 📚 التوثيق الشامل • 🤝 الشريك (وكالة الوكالة) • ⚡ الأوامر التشغيلية • 🛡️ ضمانات الأمان • 📖 Read in English
[!NOTE] مهارة TidyFactor GitHub هي مهارة ذكاء اصطناعي احترافية مخصصة لبيئات التطوير بالوكلاء (Google Antigravity, Claude Code, Cursor, Codex, Windsurf). تعمل عبر كافة طبقات المنصة: الحساب ➔ المنظمة ➔ المستودع ➔ الكود ➔ التعاون ➔ الأمان ➔ تجربة المساهمين (CX) ➔ حوكمة المشاريع المفتوحة المصدر.
🌟 القيمة المضافة والمحرك الخماسي¶
┌─────────────────────────────────────────┐
│ TIDYFACTOR GITHUB │
│ محرك تشغيل وحوكمة وذكاء منصة جيت هب │
└────────────────────┬────────────────────┘
│
┌───────────────────┬───────────────────────┼───────────────────────┬───────────────────┐
│ │ │ │ │
┌─────▼───────┐ ┌─────▼─────────┐ ┌─────▼─────────┐ ┌─────▼─────────┐ ┌─────▼─────────┐
│ العمليات │ │ الحوكمة │ │ المحتوى │ │ الهوية والتنسيق│ │ المجتمع والذكاء│
├─────────────┤ ├───────────────┤ ├───────────────┤ ├───────────────┤ ├───────────────┤
│• المستودعات │ │• قواعد Ruleset│ │• تجربة README │ │• التنسيق البصري│ │• فحص الجاهزية │
│• المنظمات │ │• تعيين الملاك │ │• نماذج Issues │ │• مصفوفة الشارات│ │• تجربة المساهم│
│• إدارة الفرق│ │• حماية الفروع │ │• قوالب الـ PR │ │• التايبوغرافي │ │• مهام المبتدئين│
│• سلاسل CI/CD│ │• الصلاحيات │ │• التوثيق الفني│ │• بطاقات المعاينة│ │• قرارات ADRs │
│• الإصدارات │ │• GOVERNANCE.md│ │• سجل التغييرات│ │• سهولة المسح │ │• مؤشر BusFactor│
└─────────────┘ └───────────────┘ └───────────────┘ └───────────────┘ └───────────────┘
| للمطورين وقادة الفرق التقنية | للوكلاء والمساعدين البرمجيين | للمنظمات وأصحاب المشاريع المفتوحة |
|---|---|---|
| تدقيق الجاهزية المفتوحة المصدر (10 محاور): فحص شامل لمؤشرات الصحة والنضج (0-100) عبر الهوية، الأمان، وسلاسل CI/CD. | توجيه خفيف وموفر للتوكنز: موزع مركزي SKILL.md (~340 توكن) مع طبقة اتخاذ القرارات (/brief). |
حوكمة المنظمات: هيكلة الفرق، مصفوفة الصلاحيات، وتطبيق مبدأ Least Privilege. |
| تجربة المساهمين (CX): خفض زمن المساهمة الأولى لأقل من 30 دقيقة مع سلم مجتمعي من 6 مستويات. | أنماط أمان ثلاثية صارمة: وضع AUDIT، محاكاة PLAN، وتنفيذ مشروط APPLY ببوابات تأكيد. |
هندسة القرارات: مسار متكامل لطلبات التعليقات (docs/rfcs/) وسجلات القرارات المعمارية (docs/adrs/). |
| أمن سلاسل التوريد: تثبيت أرقام الـ SHA لإجراءات Actions تلقائياً وقفل الصلاحيات الافتراضية. | أدوات حتمية مكتوبة بـ Python/Node: سكربتات فحص دقيقة (oss_audit.py, repo_audit.py, readme_linter.py). |
توافق ثنائي اللغة (RTL): دعم أصيل وتنسيقات عربية احترافية بدون ترجمات آلية ركيكة. |
🛡️ أنماط التشغيل الثلاثية وبوابات السلامة¶
graph TD
A[أمر المستخدم / النية] --> B{تحديد النمط}
B -->|AUDIT Mode| C[للقراءة فقط: فحص وتوليد تقرير Scorecard للجاهزية]
B -->|PLAN Mode| D[محاكاة: توليد الفوارق Diffs وأوامر gh المقترحة]
B -->|APPLY Mode| E{هل العملية تدميرية أو عالية الخطورة؟}
E -->|نعم| F[بوابة التأكيد الصريح Explicit Confirmation Gate]
F -->|موافقة المستخدم| G[تنفيذ العملية الحتمية]
F -->|إلغاء| H[إيقاف العملية وحفظ التقرير]
E -->|لا: توليد ملفات عادية| G⚡ مصفوفة القدرات والأوامر (22 أمراً)¶
| الأمر | النية وحالة الاستخدام | الملفات المحملة | المخرج المتولد |
|---|---|---|---|
/brief |
الاستكشاف وتثبيت خط الأساس التقني | brief-discovery.md + decision-points.md |
.tidyfactor/github-brief.md |
/audit |
الفحص التساعي الشامل للصحة والنضج | run-repo-audit.md + maturity-model.md |
بطاقة الدرجات Scorecard وخطة الإصلاح |
/oss |
تدقيق الجاهزية المفتوحة المصدر والتشخيص | run-oss-audit.md + oss-readiness-rubric.md |
بطاقة الجاهزية (0-100) وخطة العلاج |
/cx |
تحسين تجربة المساهمين وتسهيل البداية | optimize-cx-onboarding.md + cx-framework.md |
ملف CONTRIBUTING.md وسلم المساهمين |
/gfi |
فرز وتأهيل مهام المبتدئين Good First Issues | triage-good-first-issues.md + cx-framework.md |
صياغة المهام السهلة مع تقدير الجهد |
/rfc |
إدارة مقترحات الـ RFCs والقرارات ADRs | author-rfc-adr.md + oss-governance-models.md |
وثائق docs/rfcs/ و docs/adrs/ |
/org |
هيكلة المنظمة والفرق ومصفوفة الصلاحيات | setup-org-hierarchy.md + permission-matrix.md |
تقرير الصلاحيات وخريطة الفرق |
/repo |
مصنع إنشاء المستودعات ودورة حياتها | scaffold-repository.md + maturity-model.md |
هيكل المستودع المعياري المتكامل |
/branch |
استراتيجيات الفروع (Trunk, Flow) والتسميات | configure-rulesets.md + branch-strategies.md |
سياسة وتسميات الفروع |
/ruleset |
قواعد الحماية المتقدمة GitHub Rulesets | configure-rulesets.md + gov-rules.md |
تكوينات Ruleset بصيغة JSON |
/issue |
نماذج الـ Issues بصيغة YAML والتصنيفات | setup-issue-forms.md + issue-taxonomy.md |
.github/ISSUE_TEMPLATE/*.yml |
/pr |
قوالب مراجعة الكود وتعيين الملاك | setup-pr-template.md + gov-rules.md |
.github/PULL_REQUEST_TEMPLATE.md |
/action |
سلاسل CI/CD وتثبيت SHA والتخزين المؤقت | audit-actions-ci.md + ci-rules.md |
.github/workflows/ci.yml |
/security |
تعزيز الأمان، Dependabot وحماية الأسرار | harden-security.md + sec-rules.md |
.github/dependabot.yml, SECURITY.md |
/community |
ملفات المجتمع ودليل المساهمة المفتوحة | setup-community-health.md + maturity-model.md |
CONTRIBUTING.md, CODE_OF_CONDUCT.md |
/readme |
محرك صياغة الـ README ومكافحة الحشو | craft-readme.md + content-rules.md |
ملف README.md تقني رصين |
/style |
الهوية البصرية، الشارات وبطاقة المعاينة | design-social-preview.md + repo-design-tokens.md |
بطاقة المعاينة (1280x640) ومصفوفة الشارات |
/release |
أتمتة الإصدارات والوسوم وسجل التغييرات | automate-release.md + maturity-model.md |
رفع الإصدار الذري ووسم Git |
/project |
إدارة مشاريع GitHub Projects والخرائط | manage-projects.md + maturity-model.md |
حقول ولوحات المشروع |
/discover |
تحسين الظهور والـ SEO والمواضيع (RDO) | optimize-discoverability.md + rdo-matrix.md |
8-12 موضوع منتقى ووصف دقيق |
/incident |
التعامل مع طوارئ الإنتاج والتقارير الفنية | handle-incident.md + security-baseline.md |
تحليل الخلل وتقرير Postmortem |
/blueprint |
فحص الفجوات وتطبيق المخططات المعيارية | apply-blueprint.md + decision-points.md |
تقرير الفجوات ومواءمة المخطط |