/planning-with-files-ar

name: planning-with-files-ar
description: "تخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات. يحتفظ بملفات task_plan.md و findings.md و progress.md على القرص، وتحقن خطافات دورة الحياة سياق التخطيط المحدد للمشروع. تقرأ الاستعادة التلقائية ملفات تخطيط المشروع فقط. يمكن للأمر الصريح session-catchup.py --metadata فحص بيانات وصفية لجلسات الوكيل المحلية التابعة للمشروع نفسه، بينما قد يصدر --replay مقتطفات محدودة مؤطرة بقيمة nonce. يمكن للوضع المحكوم الاختياري طلب المتابعة فقط عندما يدعمه المضيف، ولا ينفذ أبدًا أوامر معلنة في Markdown. لا تتضمن المهارة مسارًا لرفع البيانات عبر الشبكة. تُستخدم للبحث أو العمل الذي يحتاج إلى 5 استدعاءات أدوات أو أكثر."
user-invocable: true
allowed-tools: "Read Write Edit Bash Glob Grep"
hooks:
  # Generated dispatch block: the 11 IDE and language variants share one
  # template (parity locked by tests/test_skill_hook_dispatch_parity.py).
  # Candidate order, first existing file wins: PWF_SCRIPT_DIR (explicit user
  # override for workspace or other nonstandard installs), CLAUDE_SKILL_DIR,
  # host env var, host user-level install dirs, then the two .claude paths.
  # Deliberate asymmetry: only UserPromptSubmit reports an unresolved script,
  # once per prompt. PreToolUse and PreCompact fire per tool call and Stop
  # carries no plan body, so a notice there would be spam; they stay silent.
  UserPromptSubmit:
    - hooks:
        - type: command
          command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files-ar/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; if [ -n \"$SH\" ]; then sh \"$SH\" --event=userprompt; else echo \"[planning-with-files] hook script not found; plan injection is off. Set PWF_SCRIPT_DIR to the skill's scripts directory, or install the skill to a user-level path.\"; fi; exit 0"
  PreToolUse:
    - matcher: "Write|Edit|Bash|Read|Glob|Grep"
      hooks:
        - type: command
          command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files-ar/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=pretool; exit 0"
  PostToolUse:
    - matcher: "Write|Edit"
      hooks:
        - type: command
          command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files-ar/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=posttool; exit 0"
  Stop:
    - hooks:
        - type: command
          command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files-ar/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=stop; exit 0"
  PreCompact:
    - matcher: "*"
      hooks:
        - type: command
          command: "SH=\"\"; for c in \"${PWF_SCRIPT_DIR}/skill-hook.sh\" \"${CLAUDE_SKILL_DIR}/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files-ar/scripts/skill-hook.sh\" \"$HOME/.claude/skills/planning-with-files/scripts/skill-hook.sh\" \"$HOME/.claude/plugins/marketplaces/planning-with-files/scripts/skill-hook.sh\"; do [ -f \"$c\" ] && { SH=\"$c\"; break; }; done; [ -n \"$SH\" ] && sh \"$SH\" --event=precompact; exit 0"
metadata:
  version: "3.18.0"

نظام تخطيط الملفات

العمل بنمط Manus: استخدام ملفات Markdown المستمرة كـ «ذاكرة عمل على القرص».

الخطوة الأولى: استعادة حالة المشروع

**قبل المتابعة**، حدّد دليل الخطة الذي تملكه هذه المهمة:

1. استخدم `scripts/resolve-plan-dir.sh` (أو `.ps1`) المثبت مع `PLAN_ID` و`PWF_PLAN_ROOT` الخاصين بالمضيف، ثم اقرأ `task_plan.md` و`progress.md` و`findings.md` من ذلك الدليل المحدد. 2. إذا رُفض محدد صريح، أو كانت عزلة الجلسة مفعلة وفيها عدة خطط بلا `PLAN_ID`، صحح التثبيت ولا ترجع إلى مهمة أخرى. استخدم ملفات جذر المشروع القديمة فقط عندما لا ينطبق محدد أو خطة مسماة. 3. نفّذ `git diff --stat` لرؤية تغييرات الكود التي قد لا تكون مسجلة بعد.

كل أسماء ملفات التخطيط التالية تعني ذلك الدليل المحدد. للمهام المتوازية، ثبّت كل مضيف قبل بدئه أو استخدم أشجار عمل منفصلة؛ تصدير متغير داخل عملية ابن لا يغير بيئة المضيف. يملك المنسق الخطة والملخصات المشتركة، ويستخدم العاملون ملفات أو دفاتر مخصصة لهم.

تنتهي الاستعادة التلقائية عند هذا الحد. لا يفحص الاستدعاء المجرد لـ `session-catchup.py` ولا خطافات دورة الحياة مخازن جلسات الوكيل. لا تستخدم أحد الوضعين التاليين إلا عندما يطلب المستخدم صراحةً الرجوع إلى سجل الجلسات المحلي:

# Linux/macOS
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-ar}"
# أعداد خاصة بالمشروع نفسه فقط، بلا مقتطفات من المحادثة
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --metadata "$(pwd)"

# إعادة تشغيل محدودة وصريحة، تصدر مقتطفات مؤطرة بقيمة nonce من المشروع نفسه
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --replay "$(pwd)"

# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-ar\scripts\session-catchup.py" --metadata (Get-Location)
# استبدل --metadata بـ --replay فقط بعد موافقة المستخدم الصريحة.

قد يفيد وضع ال