المهارات

modulestf: مهارات agent لمراجعة وحدات Terraform وتعديلها وفق قواعد terraform-aws-modules

المهندسون الذين يريدون مراجعة وحدات Terraform القابلة لإعادة الاستخدام وتعديلها وفق قواعد terraform-aws-modules داخل agent برمجي، أنسب خطوة لهم البدء بمراجعة PR عبر هذه المهارات مع نقطة تأكيد؛ وقبل الاستخدام يجب إعداد MCP server لـ HashiCorp Terraform باسم terraform وربطه بالـ agent، وإلا فلن تعمل القواعد المعتمدة على معلومات الـ provider ولن تتجاوز نتيجة المراجعة حدّ عدم اليقين (غير مؤكد).

Official source · modulestf

Install

git clone https://github.com/modulestf/modulestf.git && ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/

لمن هذه الأداة

  • هذه مجموعة مهارات agent skills موجهة للمهندسين الذين يكتبون ويصونون وحدات Terraform داخل Claude Code أو Codex، ويرغبون في مراجعة الوحدات أو تعديلها وفق القواعد المكتوبة لسلسلة terraform-aws-modules. تعمل على جهازك الخاص وباستخدام حساب GitHub الخاص بك.
  • حاليًا تأتي بملف قواعد واحد فقط: terraform-aws-modules. إذا كان مشروعك يحتاج إلى قواعد لعائلات أخرى، فالأدلة الرسمية لا تذكر شيئًا عن ملاءمتها.
  • قبل الاستخدام لأول مرة، يجب إعداد MCP server لـ Terraform باسم terraform وربطه بالـ agent. النص الرسمي صريح: بدونه، القواعد التي تتطلب معلومات من الـ provider ستُبلَّغ بحالة not run، ولن تتجاوز نتيجة مراجعة الـ PR حدّ «غير مؤكد».
  • إذا لم تكن متأكدًا مما إذا كانت وحدتك تنتمي إلى هذه العائلة، فابدأ بالمراجعة منخفضة المخاطر الموضحة أدناه.

أول تجربة في 3 دقائق

المتطلبات المسبقة: تثبيت Claude Code، وربط HashiCorp Terraform MCP server بالـ agent باسم terraform وفق التعليمات الرسمية. يجب الإقرار بالآثار الجانبية: سير عمل المراجعة يستنسخ الـ PR إلى مجلد مؤقت، ويشغّل في كل مثال (example) الأمرين terraform init -backend=false وterraform validate — والنص الرسمي يوضح أن ذلك لا يكتب state ولا يستخدم backend حقيقيًا، لكنه ينفّذ أوامر Terraform داخل المجلد المؤقت.

  1. استنسخ المستودع وضع مجلدات المهارات الأربعة كلها في مجلد skills الخاص بـ Claude Code:
git clone https://github.com/modulestf/modulestf.git
ln -sfn "$PWD"/modulestf/.agents/skills/* ~/.claude/skills/
  1. أطلق في Claude Code مهمة منخفضة المخاطر: تشغيل مراجعة على PR لوحدة Terraform قابلة لإعادة الاستخدام موجودة أصلًا (عملية تشخيصية). إشارة النجاح: أن يقدّم الـ agent حكمًا (verdict) وقائمة نتائج (findings) ومسودة تعليق مقترح على الـ PR.
  2. نقطة التأكيد الأساسية: لن يُنشر أي شيء قبل موافقتك؛ وعند التأكيد تختار في الوقت نفسه حدث المراجعة — نشر التعليق، أو الموافقة (approve)، أو طلب التعديل، وفق الأنواع الثلاثة المذكورة رسميًا. أما ما عدا الأوامر المذكورة والاتصال بالشبكة، فما إذا كانت عملية المراجعة تقرأ أو تكتب ملفات أخرى أو تصل إلى الشبكة، فالنص الرسمي لم يفصّل ذلك، ويبقى الأمر مجهولًا.
  3. إذا ظهرت بعض القواعد بحالة not run، فتحقق أولًا من أن terraform MCP server قد رُبط بشكل صحيح.

حالات الاستخدام

  1. مراجعة PR: اطلب من الـ agent في Claude Code مراجعة PR مفتوح وفق قواعد terraform-aws-modules. يستنسخ سير العمل الـ PR إلى مجلد مؤقت، ويشغّل terraform init -backend=false وterraform validate في كل مثال، ثم يقدّم الحكم والنتائج والتعليق المزمع نشره؛ ولن يُنشر أي شيء قبل أن تؤكد التعليق وتختار حدث المراجعة.
  2. التعديل بعد المراجعة: بعد إصدار الحكم، اطلب من الـ agent تعديل الوحدة وفق متطلبات المراجعة. النص الرسمي يقول إن هذه المهارات تقوم بـ «review, change and create reusable Terraform modules» وتساعد على تنفيذ التعديلات التي تطلبها المراجعة؛ والتعديل يغيّر ملفات الوحدة، لذا تأكد قبل البدء من الملفات التي سيشملها. الأدلة الرسمية لا تفصّل خطوات عملية التعديل، والمؤكد هو أنها تنفّذ التعديل وفق قواعد الملف، بشرط وجود نتائج المراجعة أولًا.

حدود الاستخدام

  • قيود صريحة على الآثار الجانبية (بنص رسمي): لا توجد مهارة تشغّل terraform apply أو تكتب state أو تستخدم backend حقيقيًا؛ ولا توجد مهارة تدمج (merge) أو تدفع (push) إلى pull request أو تحلّ خيوط النقاش (threads). ولا تنشر عملية المراجعة أي تعليق أو حدث مراجعة قبل التأكيد. انتبه: النص الرسمي اكتفى بسرد هذه القيود ولم يوضح أن سير عمل التعديل (change) للقراءة فقط — فتلك المهارات مصممة لتعديل وإنشاء الوحدات وفق متطلبات المراجعة، وهذا السير سيعدّل ملفات الوحدة، فتأكد بنفسك من النطاق قبل التعديل.
  • متطلبات التشغيل: يعمل محليًا على Claude Code أو Codex باستخدام حساب GitHub الخاص بك؛ وطريقة التثبيت هي نسخ المجلدات الأربعة أو إنشاء روابط رمزية لها، ومجلد skills في المنصتين هو ~/.claude/skills/ و~/.agents/skills/ على التوالي. لا توجد أدلة عن طرق تثبيت أو منصات أخرى.
  • تتطلب المراجعة استنساخ الـ PR أولًا وتنفيذ terraform init/validate في مجلد مؤقت، لذا يلزم وجود بيئة Terraform على جهازك.
  • معلومات أساسية غير مؤكدة: الأدلة الرسمية لا تذكر إصدارات Terraform المدعومة، ولا نطاق الـ providers، ولا التوافق مع agents أخرى، ولا قوائم الخطوات التفصيلية لكل سير عمل عدا «review, change and create»؛ كما لم تُفصَّل كاملة نطاقات وصول عمليتي المراجعة والتعديل إلى الملفات والشبكة. يُنصح بالتحقق في بيئتك قبل الاستخدام.