OthmanAdi/planning-with-files / skills/i18n/planning-with-files-ar
planning-with-files-ar
Verifiedتخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات. يحتفظ بملفات task_plan.md و findings.md و progress.md على القرص، وتحقن خطافات دورة الحياة سياق التخطيط المحدد للمشروع. تقرأ الاستعادة التلقائية ملفات تخطيط المشروع فقط. يمكن للأمر الصريح session-catchup.py --metadata فحص بيانات وصفية لجلسات الوكيل المحلية التابعة للمشروع نفسه، بينما قد يصدر --replay مقتطفات محدودة مؤطرة بقيمة nonce. يمكن للوضع المحكوم الاختياري طلب المتابعة فقط عندما يدعمه المضيف، ولا ينفذ أبدًا أوامر معلنة في Markdown. لا تتضمن المهارة مسارًا لرفع البيانات عبر الشبكة. تُستخدم للبحث أو العمل الذي يحتاج إلى 5 استدعاءات أدوات أو أكثر.
scripts/init-session.sh
View on GitHub#!/usr/bin/env bash
# تهيئة ملفات التخطيط لجلسة جديدة
# الاستخدام: ./init-session.sh [اسم المشروع]
set -e
PROJECT_NAME="${1:-project}"
DATE=$(date +%Y-%m-%d)
echo "جارٍ تهيئة ملفات التخطيط: $PROJECT_NAME"
# إنشاء task_plan.md إذا لم يكن موجودًا
if [ ! -f "task_plan.md" ]; then
cat > task_plan.md << 'EOF'
# خطة المهمة: [وصف موجز]
استخدم هذا الملف بوصفه خارطة الطريق المستمرة للمهمة. حافظ على تحديثه كلما تغيرت المراحل.
## الهدف
[وصف الحالة النهائية في جملة واحدة]
## الخطوة التالية
[الإجراء التالي الوحيد. حدّثه كلما تغيرت حالة المرحلة.]
## المرحلة الحالية
المرحلة 1
## المراحل
استخدم فقط `pending` أو `in_progress` أو `complete` للحالة.
### المرحلة 1: المتطلبات والاكتشاف
- [ ] فهم نية المستخدم
- [ ] تحديد القيود والمتطلبات
- [ ] توثيق الاكتشافات في findings.md
- **الحالة:** in_progress
### المرحلة 2: التخطيط والهيكل
- [ ] تحديد الحل التقني
- [ ] إنشاء هيكل المشروع إذا لزم الأمر
- **الحالة:** pending
### المرحلة 3: التنفيذ
- [ ] التنفيذ خطوة بخطوة حسب الخطة
- [ ] كتابة الكود في الملفات قبل التنفيذ
- **الحالة:** pending
### المرحلة 4: الاختبار والتحقق
- [ ] التحقق من استيفاء جميع المتطلبات
- [ ] توثيق نتائج الاختبار في progress.md
- **الحالة:** pending
### المرحلة 5: التسليم
- [ ] فحص جميع ملفات الإخراج
- [ ] التسليم للمستخدم
- **الحالة:** pending
## القرارات المتخذة
| القرار | السبب |
|------|------|
## الأخطاء التي تمت مواجهتها
| الخطأ | المحاولة | الحل |
|------|----------|------|
| | 1 | |
## ملاحظات
- أعد قراءة الهدف والخطوة التالية قبل القرارات المهمة.
- سجّل الأخطاء فورًا، وغيّر النهج قبل إعادة محاولة إجراء فاشل.
EOF
echo "تم إنشاء task_plan.md"
else
echo "task_plan.md موجود بالفعل، تخطي"
fi
# إنشاء findings.md إذا لم يكن موجودًا
if [ ! -f "findings.md" ]; then
cat > findings.md << 'EOF'
# الاكتشافات والقرارات
## المتطلبات
-
## نتائج البحث
-
## القرارات التقنية
| القرار | السبب |
|------|------|
## المشكلات التي تمت مواجهتها
| المشكلة | الحل |
|------|---------|
## الموارد
-
EOF
echo "تم إنشاء findings.md"
else
echo "findings.md موجود بالفعل، تخطي"
fi
# إنشاء progress.md إذا لم يكن موجودًا
if [ ! -f "progress.md" ]; then
cat > progress.md << EOF
# سجل التقدم
## الجلسة: $DATE
### الحالة الحالية
- **المرحلة:** 1 - المتطلبات والاكتشاف
- **وقت البدء:** $DATE
### الإجراءات المتخذة
-
### نتائج الاختبار
| الاختبار | النتيجة المتوقعة | النتيجة الفعلية | الحالة |
|------|---------|---------|------|
### الأخطاء
| الخطأ | الحل |
|------|---------|
EOF
echo "تم إنشاء progress.md"
else
echo "progress.md موجود بالفعل، تخطي"
fi
echo ""
echo "تم تهيئة ملفات التخطيط بنجاح!"
echo "الملفات: task_plan.md، findings.md، progress.md"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |