المهارات planning-with-files
📦

planning-with-files

آمن ⚙️ الأوامر الخارجية

تخطيط المهام المعقدة باستخدام الملفات الثابتة

متاح أيضًا من: OthmanAdi,ZhanlinCui,AmmarCodes

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

يدعم: Claude Codex Code(CC)
🥈 77 فضي
1

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "planning-with-files". Initialize planning for a Python CLI todo app with add, list, and delete commands

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

  • Created task_plan.md with 5 phases: Requirements, Planning, Implementation, Testing, Delivery
  • Created findings.md with sections for requirements, research, and technical decisions
  • Created progress.md with session timestamp and initial status

استخدام "planning-with-files". Log error: FileNotFoundError when reading config.json

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

  • Added to Errors Encountered table: FileNotFoundError, Attempt 1, Resolution: Create default config file
  • Updated progress.md error log with timestamp
  • Phase status remains in_progress until error resolved

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

آمن
v1 • 2/24/2026

All static analysis findings were evaluated and determined to be false positives. The shell command patterns detected are from markdown documentation code blocks and legitimate bash helper scripts that only perform file operations. No cryptographic code, network exfiltration, or credential access exists. This is a safe productivity skill for planning complex tasks using persistent markdown files.

8
الملفات التي تم فحصها
1,146
الأسطر التي تم تحليلها
1
النتائج
1
إجمالي عمليات التدقيق

عوامل الخطر

تم تدقيقه بواسطة: claude

درجة الجودة

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

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

مشاريع التطوير متعددة الخطوات

تتبع مهام الترميز المعقدة عبر أكثر من 50 استدعاء أداة مع تتبع المراحل وتسجيل الأخطاء وتوثيق القرارات.

البحث والتوثيق

التقاط نتائج البحث على الويب ونتائج المتصفح والمواد المصدرية في markdown مهيك قبل فقدان السياق.

استكشاف الأنظمة وتصحيح الأخطاء

توثيق الاكتشافات والمحاولات الفاشلة والحلول عند استكشاف قواعد بيانات غير مألوفة أو تصحيح الأخطاء.

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

تهيئة جلسة التخطيط
إنشاء ملفات task_plan.md و findings.md و progress.md في دليل مشروعي. الهدف هو: [صف هدف مهمتك]. ابدأ بالمرحلة الأولى لجمع المتطلبات.
تتبع تقدم إصلاح الخطأ
اقرأ task_plan.md وحدّث حالة المرحلة الحالية. سجّل الخطأ الذي واجهته: [الصق الخطأ]. وثّق السبب الجذري والمحاولات الإصلاحية في جدول الأخطاء المواجهة.
التقاط النتائج البحثية
أكمل للتو بحثين على الويب حول [الموضوع]. حدّث findings.md بالاكتشافات الرئيسية وعناوين URL ذات الصلة وأي قرارات تقنية اتخذتها بناءً على هذا البحث.
اكتمال المرحلة والمراجعة
وضع علامة مكتملة على المرحلة [X] في task_plan.md. لخص ما تم إنجازه والملفات التي تم إنشاؤها أو تعديلها، وحدّث progress.md بنتائج الاختبار. ثم اضبط المرحلة [X+1] على قيد التقدم.

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

  • إنشاء جميع ملفات التخطيط الثلاث قبل بدء أي مهمة معقدة ذات 3 خطوات أو أكثر
  • قراءة task_plan.md قبل اتخاذ قرارات رئيسية للحفاظ على الأهداف في الانتباه
  • تحديث findings.md فوراً بعد كل عمليتي عرض أو متصفح
  • تسجيل كل خطأ واجهته، حتى لو تم حله بسرعة، لمنع التكرار
  • تغيير حالة المرحلة بوضوح: معلق إلى قيد التقدم إلى مكتمل

تجنب

  • بدء التنفيذ دون إنشاء ملف task_plan.md أولاً
  • إعادة المحاولة بصمت للإجراءات الفاشلة دون تسجيل الخطأ
  • تكرار نفس الإجراء الفاشل بدلاً من تغيير النهج
  • إنشاء ملفات التخطيط في دليل المهارة بدلاً من دليل المشروع
  • استخدام TodoWrite للاستمرارية بدلاً من التخزين القائم على الملفات

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

أين يجب أن أنشئ ملفات التخطيط؟
أنشئ task_plan.md و findings.md و progress.md في دليل المشروع الذي تعمل فيه، وليس في مجلد تثبيت المهارة. يؤدي هذا إلى الاحتفاظ بملفات التخطيط بجانب الكود الخاص بك.
متى يجب أن أحدّث ملفات التخطيط؟
حدّث task_plan.md بعد اكتمال كل مرحلة. حدّث findings.md بعد كل عمليتي عرض أو متصفح. حدّث progress.md طوال الجلسة مع إكمال الإجراءات.
ما هي قاعدة الإجراءين؟
بعد كل عمليتي عرض أو متصفح أو بحث، اكتب فوراً النتائج الرئيسية في findings.md. يمنع هذا فقدان المعلومات المرئية أو متعددة الوسائط عند إعادة تعيين السياق.
كيف أتعامل مع الأخطاء بهذه المهارة؟
سجّل كل خطأ في جدول الأخطاء المواجهة مع رقم المحاولة والحل. لا تكرر نفس الإجراء الفاشل أبداً. بعد 3 محاولات فاشلة، ارفع الأمر إلى المستخدم بما جربته.
هل يمكنني استخدام هذا للمهام البسيطة؟
لأسئلة بسيطة أو تعديلات ملف واحد أو عمليات بحث سريعة، تخطي ملفات التخطيط. استخدم هذا النمط للمهام ذات 3 خطوات أو أكثر أو مشاريع البحث أو أي شيء يتطلب التنظيم عبر العديد من استدعاءات الأدوات.
ما هي نصوص shell؟
ينشئ init-session.sh جميع ملفات التخطيط الثلاثة بمحتوى القالب. يتحقق check-complete.sh من اكتمال جميع المراحل في task_plan.md. كلاهما مساعدون اختياريون للأتمتة.

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

بنية الملفات