إن كنت تكتب مهام مشروعك في ملف todo.md على هيئة مربعات اختيار، فهذا الأمر يغنيك عن إعادة كتابة التعليمات نفسها في كل جلسة: تستدعي act، فيقرأ Claude Code الملف، ويأخذ أول بند غير مؤشَّر، ويخطط له، ثم ينفّذه في فرع جديد ويؤشّر عليه ويسجّل commit. ويصف نفسه في رأس الملف بأنه دورة RED-GREEN-REFACTOR للتطوير الموجّه بالاختبارات (TDD): اختبار يفشل أولًا، ثم أقل كود يجعله ينجح، ثم تحسين الكود مع بقاء الاختبارات ناجحة.
الأمر مكتوب لـ Claude Code تحديدًا. نصه تعليمات إنجليزية قصيرة يمكنك لصقها في Codex أو غيره، لكن إحالته إلى ~/.claude/CLAUDE.md لا تعمل خارج Claude Code، ولا يناسب claude.ai لأنه يعمل على ملفات مستودع محلي وأوامر git.
الخطوات الخمس في act.md
- يفتح todo.md ويختار أول البنود غير المؤشَّر عليها.
- يخطط لكل بند بعناية، ثم يعرض عليك خطته.
- ينشئ فرعًا جديدًا وينفّذ الخطة.
- يؤشّر على البنود المنجزة في todo.md.
- يسجّل تغييراته في commit.
أما قواعد الدورة نفسها فلا يكتبها الأمر، بل يحيل إلى ملف ~/.claude/CLAUDE.md في مجلد المستخدم على جهازك ويبني عليه. فإن لم يذكر ملفك إطار الاختبار وأمر تشغيله، ولم يشترط أن يفشل الاختبار قبل كتابة الكود، ترك الأمرُ ذلك كله لتقدير Claude؛ لذلك أضف هذه القواعد إلى ملفك قبل أول تشغيل.
مثال: بندان في todo.md
في جذر مشروعك ملف todo.md فيه بندان: «رفض البريد الإلكتروني غير الصالح» ثم «حد لمحاولات الدخول الفاشلة». تكتب /commands-automation-workflow:act، والمنتظر بحسب نص الملف أن يعرض Claude خطته، وينشئ فرعًا، ويكتب الاختبار والكود، ثم يحوّل المربع إلى [x] ويسجّل commit.
وفي الملف تفصيلان يستحقان الانتباه. عبارة «first unchecked items» جاءت بصيغة الجمع، فقد يأخذ البندين معًا؛ فإن أردت بندًا واحدًا في كل مرة فعدّل هذا السطر في نسختك من act.md. والخطوة الثانية تطلب عرض الخطة ولا تطلب انتظار موافقتك، فقد ينتقل مباشرة إلى التنفيذ؛ فإن أردت التوقف بعد الخطة فشغّله في Plan Mode، أو أضف هذا الشرط إلى act.md.
التثبيت
- للتجربة في جلسة واحدة: فُكّ ضغط الملف، وافتح الطرفية في مجلد مشروعك، وشغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بعد وضع مسار فك الضغط الفعلي، ثم استدعِ الأمر باسمه الكامل /commands-automation-workflow:act. - للاستخدام الدائم باسم أقصر: انسخ plugin/commands/act.md إلى .claude/commands داخل مشروعك، أو إلى ~/.claude/commands ليظهر في كل مشروعاتك، فيصبح الأمر /act.
ما يلزمك وحدود الأمر
- Claude Code مثبّتًا مع تسجيل الدخول، وتكلفة تشغيل النموذج على حسابك.
- مستودع git مهيّأ، وملف todo.md بمربعات Markdown، وإطار اختبار يعمل في المشروع.
- الحزمة أمر واحد بلا سكربتات. ونصه لا يذكر تشغيل الاختبارات صراحة، ولا رفع الفرع (push)، ولا فتح طلب دمج؛ فكل ما يتجاوز الخطوات الخمس يأتي من CLAUDE.md أو من طلبك.
- لا يحدد الملف قائمة أدوات (allowed-tools)، فيعمل بصلاحيات جلستك، ويطلب إذنك لأوامر git وتعديل الملفات بحسب إعداداتك.
- التعليمات بالإنجليزية؛ فإن أردت الخطة ورسائل commit بالعربية فاطلب ذلك صراحة.
أرفقتُ مع الملف الأصلي دليلًا عربيًا للتشغيل وفهرسًا للمحتويات.
الترخيص: MIT. الأمر من مجتمع BuildWithClaude وحقوقه لـ davepoon، ونصه كما ورد دون تعديل.
