sast — إضافة Claude Code (SAST)

إضافة Claude Code مستقلة بذاتها (sast) تُدخل SAST مباشرةً إلى Claude Code عبر مهارات أوامر الشرطة المائلة، والوكلاء الفرعيين، وخطافات دورة الحياة.

بنية الإضافة

sast/
├── .claude-plugin/
│   ├── plugin.json                  # بيان الإضافة (name: "sast")
│   ├── marketplace.json             # بيان السوق (name: "sast")
│   └── icon.png                     # أيقونة الإضافة PNG مربعة 1024x1024
├── skills/
│   ├── scan/
│   │   └── SKILL.md                 # /sast:scan    — فحص SAST كامل + taint + أسرار + IaC + SCA
│   ├── diff/
│   │   └── SKILL.md                 # /sast:diff    — فحص تزايدي سريع على ملفات git المتغيرة
│   ├── secrets/
│   │   └── SKILL.md                 # /sast:secrets — كشف الأسرار + التحقق الحي من المفاتيح + سجل git
│   ├── sca/
│   │   └── SKILL.md                 # /sast:sca     — ثغرات التبعيات (OSV)، dep confusion، CMS، التراخيص
│   ├── triage/
│   │   └── SKILL.md                 # /sast:triage  — نموذج التهديد، فحص بوابة FP وتصنيف قابلية الاستغلال
│   └── fix/
│       └── SKILL.md                 # /sast:fix     — فروقات المعالجة التلقائية والتحقق بعد الترقيع
├── agents/
│   ├── security-auditor.md          # @agent-sast:security-auditor
│   └── remediation-engineer.md      # @agent-sast:remediation-engineer
├── hooks/
│   └── hooks.json                   # PostToolUse (Write|Edit) سلك تعثر الأسرار وفحص اختياري لملف واحد
├── scripts/
│   ├── sast_runner.py               # مشغّل SAST مضمّن مستقل بذاته ومنسّق ملخص Claude
│   └── post_edit_check.py           # معالج خطاف PostToolUse سريع
└── README.md

البدء السريع

التثبيت من سوق GitHub (موصى به)

claude plugin marketplace add vulnz/sast
claude plugin install sast@sast

أو داخل جلسة Claude Code تفاعلية:

/plugin marketplace add vulnz/sast
/plugin install sast@sast

التحقق من الإضافة محليًا

claude plugin validate .

أوامر الشرطة المائلة (المهارات)

الأمر	الوصف
/sast:scan [path]	فحص SAST كامل + AST/taint (أكثر من 16 لغة) + أسرار + IaC + SCA
/sast:diff [path]	فحص SAST تزايدي سريع للملفات المعدّلة والمُجهّزة وغير المتتبعة في git (--changed)
/sast:secrets [path]	فحص شجرة العمل و--git-history بحثًا عن بيانات اعتماد مضمّنة مع التحقق الحي من مفاتيح المزوّد
/sast:sca [path]	تدقيق التبعيات (ثغرات OSV)، وdep confusion، ومكتبات JS المضمّنة، وإضافات CMS، و--licenses
/sast:triage [path]	بناء STRIDE --threat-model وتصنيف النتائج مقابل بوابة 0-FP الحقيقية فقط
/sast:fix [path]	معالجة الثغرات (--remediation) وإعادة التحقق باستخدام --changed

الوكلاء الفرعيون

• @agent-sast:security-auditor — يشغّل ماسح SAST المضمّن، ويتتبع تدفقات البيانات من المصدر إلى المصب في ملفات المصدر، ويُنتج تقارير ثغرات مرتبة حسب الأولوية.
• @agent-sast:remediation-engineer — يصوغ ترقيعات أمنية دنيا ويعيد تشغيل الماسح للتحقق من كل إصلاح.

خيارات الإضافة (userConfig)

تُضبط عبر مربع حوار إعدادات الإضافة في Claude Code (/plugin ← Configure options):

• scan_on_edit (boolean، الافتراضي false) — تفعيل الفحص التلقائي لملف واحد بـ SAST داخل خطاف PostToolUse (Write|Edit).
• provider_api_key (string، sensitive: true، اختياري) — مفتاح API اختياري يُخزَّن في مخزن بيانات الاعتماد الآمن في Claude Code لتصنيف/معالجة AI المستقلة للفروقات.