
ماسح للقراءة فقط لما يسمح لمستودع بتشغيل التعليمات البرمجية داخل وكيل برمجة (Claude Code، Codex، Cursor، Copilot): إعدادات git، والخطافات (hooks)، وتعريفات خادم MCP المثبّتة في المستودع، وإعدادات الوكيل. مخرجات SARIF. بلا اعتماديات، بلا شبكة، بلا قياس عن بُعد.
يمكن أن يجعل المستودع وكيل البرمجة الخاص بك يشغّل التعليمات البرمجية بمجرد فتحه للمجلد. يتحقق GuardSkill من ذلك قبل أن تفعل.
npx guardskill .
للقراءة فقط. لا اتصال بالشبكة، ولا قياس عن بُعد، ولا إعدادات، ولا حساب، ولا تبعيات. يقرأ إعدادات git ونصوص الخطافات (hooks)، ويطبع ما وجده، ثم يخرج.
تجمع وكلاء البرمجة السياق عبر تشغيل أوامر git العادية — git status، git diff — بمجرد فتحهم لمشروع. يقرأ git إعداداته من ملف .git/config الخاص بالمستودع نفسه، ونحو عشرينين من تلك الإعدادات تسمّي برنامجًا لينفذه git. ضع أمرًا في core.fsmonitor فيُنفَّذ، بصلاحياتك، خارج أي صندوق رمل (sandbox)، قبل أن تكتب أي شيء.
هناك بحثان عامّان يجعلان هذا ملموسًا:
.git/config لا يُنقل عبر الاستنساخ. يجب أن يصل المستودع كملفات مع مجلد .git بداخله أصلًا — ملف zip، أو قرص مشترك، أو مجلد مزامنة، أو ذاكرة USB، أو وكيل يفكّ ضغط أرشيف. (Manifold Security، The Hacker News)@github/copilot 1.0.43 بفرض safe.bareRepository=explicit. (GitHub Advisory)التخفيف الموصى به من جهة المستخدم في كلتا الدراستين هو نفسه: افحص إعدادات git قبل أن تفتح المجلد بوكيل. القيام بذلك يدويًا عبر شجرة كاملة أمر ممل. هذه الأداة تفعله في ثانية.
للمتجهات المتعلقة بـ git ميزة إنقاذ واحدة: يجب أن يصل المستودع كملفات، لأن الاستنساخ لا يحمل .git/config. أما إعدادات الوكلاء فلا تشترط ذلك. ملف .mcp.json أو .claude/settings.json أو .vscode/mcp.json هو ملف عادي متتبَّع — يصل مع git clone كأي ملف آخر — ويقرأه وكيل البرمجة عند فتحه للمشروع. مدخل خادم MCP يسمّي برنامجًا فيشغّله الوكيل؛ وخطاف يسمّي أمرًا فينفّذه الوكيل عند حدث ما؛ وإعداد صلاحيات يمكنه تعطيل الخطوة التي يسألك فيها الوكيل أولًا.
مدى العناية بهذه الإعدادات في الممارسة العملية يستحق رقمًا خارجيًا واحدًا. قاست Bloomberry 1,412 خادم MCP مستضافًا لدى شركات في فبراير 2026 ووجدت أن 38.7% منها بلا مصادقة إطلاقًا، ارتفاعًا من 425 خادمًا قبل ستة أشهر. تلك نقاط نهاية عامة وليست تعريفات خوادم في مستودعك — أي جمهرة مختلفة — لكنها المنظومة نفسها، وهي تقول شيئًا عن مقدار العناية التي تحظى بها هذه الإعدادات. (Bloomberry)
وثمة أمر آخر يستحق القول بوضوح، دون إعطائه رقمًا: الفجوة بين "أن يجد أحدهم هذا" و"أن يستخدمه أحدهم" تضيق، لأن الاكتشاف والاستخدام يتولاهما على نحو متزايد نفس الجهاز الآلي. وهذا سبب للنظر قبل فتح مجلد، لا سبب للهلع من سطر بعينه في تقرير — ولهذا لا تُلحق GuardSkill ادعاءً بزمن الاستغلال على النتائج الفردية. فهي لا تستطيع معرفته.
كل إعدادات git يمكن أن يلتقطها وكيل، وليس الإعداد الواضح فقط: مجلد .git الخاص بالمشروع، وأي .git متداخل وصل كمحتوى، وأي مستودع عارٍ مخفي في مجلد فرعي، وملف .git الذي يتركه مستودع فرعي (submodule) أو شجرة عمل مرتبطة، وconfig.worktree، وكل .git/modules/<name>/config، وأي ملف يُضمّ عبر include.path ويقع داخل الشجرة.
وملفات إعدادات الوكيل التي يمكن أن يشحنها المستودع: .mcp.json في أي مكان في الشجرة، و.claude/settings.json وsettings.local.json، و.vscode/mcp.json، و.cursor/mcp.json، و.gemini/settings.json، و.windsurf/mcp.json. يتم العثور على الفئتين في جولة واحدة عبر شجرة الدليل؛ والفئة الثانية لا تكلّف شيئًا إضافيًا.
القائمة الكاملة، مفتاحًا بمفتاح، مع مصدر وحالة تغطية لكل منها، موجودة في rules/git-exec-keys-inventory.md. يفشل الاختبار إذا انحرفت تلك القائمة عن مجموعة القواعد، لذا فإن القائمة قابلة للتدقيق وليست مجرد طموح. باختصار:
| الفئة | الفحوصات |
|---|---|
| تعمل عند الأوامر العادية | core.fsmonitor، core.pager، pager.<cmd>، core.editor، sequence.editor، diff.external، core.askPass، core.alternateRefsCommand |
| تعمل عند عمليات الشبكة | core.sshCommand، core.gitProxy، remote.<n>.uploadPack / receivePack، uploadpack.packObjectsHook |
تعمل عبر .gitattributes | filter.<d>.clean / .smudge / .process، diff.<d>.textconv، merge.<d>.driver |
| تعمل عند الطلب | mergetool / difftool / browser / guitool / man .cmd، credential.helper، gpg.program، trailer.<t>.command، أي alias.* يستدعي shell أو يعيد الدخول إلى git باستخدام -c |
| تُدخل إعدادات لاحقًا | include.path، includeIf.*.path (يُتبع ويُفحص)، init.templateDir |
| وسائل نقل تنفّذ | protocol.allow، عناوين URL البعيدة والوحدات الفرعية التي تستخدم ext:: |
| الخطافات (Hooks) | core.hooksPath، السكربتات النشطة في .git/hooks، سكربتات الخطافات التي تنزّل أو تفكّ ترميز الشيفرة، سكربتات الخطافات التي هي روابط رمزية |
| البنية | مستودعات عارية في الشجرة، أدلة .git متداخلة غير مسجّلة كوحدات فرعية، أدلة باسم .git بحالة أحرف مختلفة |
أربعة مفاتيح خارج النطاق عمدًا، ولكل منها سبب في القائمة: sendemail.smtpServer، وinstaweb.httpd، وssh.variant، وإعدادات وسيط HTTP. ولهذا السبب يسرد هذا README ما يفحصه بدلًا من ادعاء تغطية فئة ثغرات كاملة — فالادعاء لا يكون صحيحًا إلا عندما يكون ذلك العمود فارغًا.
الفئة الثانية، ولها قائمتها الخاصة في rules/agent-settings-inventory.md واختبار الانحراف نفسه خلفها.
| الفحص | الخطورة |
|---|---|
خادم MCP يبدأ من PATH (npx، uvx، node، docker) | منخفضة — معلوماتية. هكذا تُضبط معظم خوادم MCP |
| الأمر مسار داخل الشجرة، أو وسيط يسمّي ملفًا داخلها | عالية |
الأمر shell، أو ينزّل شيفرة ويشغّلها، أو يقع في /tmp أو في دليل مخفي | حرجة |
خادم بعيد معلن دون أي مادة اعتماد في headers أو env | متوسطة |
| خطاف يشغّل أمرًا عند حدث وكيل | السلّم نفسه أعلاه — npx prettier --write معلوماتي، وسكربت من الشجرة عالٍ، وخط أنابيب shell حرج |
طلب تخطي خطوة الموافقة (bypassPermissions) | عالية، مع ذكر النتيجة لما يفعله العميل به فعليًا |
| إدخال خادم بشكل لا يتعرف عليه الماسح | متوسطة — عدم الفهم ليس كعدم الوجود |
حرف بدل في permissions.allow | عالية |
| قيمة على شكل بيانات اعتماد | عالية |
إذا كان مشروعك أنت يشحن خادم MCP خاصًا به، فسيُبلَّغ عن ذلك الإدخال بدرجة عالية — لا يستطيع GuardSkill التمييز بين مستودع كتبته أنت وآخر وُكّل إليك. استخدم --fail-on critical، أو استبعد المسار بـ --exclude.
والعكس: بالنسبة لشجرة وُكّلت إليك، افحص باستخدام --fail-on low. خادم يبدأ كـ npx -y @attacker/mcp-helper هو معلوماتي بحكم التصميم — فالأمر عادي واسم الحزمة هو الهجوم بأكمله، والحكم على حزمة باسمها مسألة سمعة في السجل تتطلب الشبكة. لن تفشل العتبة الافتراضية بسببه. تلك العتبة الافتراضية مضبوطة لمستودعك أنت في CI؛ أما الدليل المُسلَّم فمسألة مختلفة ويستحق العتبة الأدنى وقراءة القائمة.
لا يتم الإبلاغ عن acceptEdits وplan. توضّح الوثائق صراحةً ما يسمح به acceptEdits — القراءة وتعديل الملفات وأوامر نظام الملفات الشائعة، مع بقاء Bash والشبكة يطلبان الموافقة — لذا فإن وصفه بأنه تجاوز للموافقة سيكون خطأً من حيث الوقائع، وهو أحد أكثر الإعدادات استخدامًا على الإطلاق.
ما لا يتم فحصه عمدًا: ما إذا كان خادم MCP بعيد فعليًا يتطلب المصادقة. لا يمكن الإجابة عن ذلك إلا بالاتصال به، وهذه الأداة لا تُجري أي اتصالات شبكية. تُبلّغ نتيجة mcp-remote-no-auth عمّا يصرّح به الملف، وتقول ذلك في نصّها الخاص.