المهارات plugin-structure
📦
plugin-structure
آمن ⚙️
الأوامر الخارجية🔑
متغيرات البيئة🌐
الوصول إلى الشبكة📁
الوصول إلى نظام الملفات
إنشاء إضافات Claude Code المنظمة بشكل جيد
متاح أيضًا من: anthropics,davila7
يتطلب تطوير إضافات Claude Code فهم بنية الدليل الصحيح، وتكوين البيان، وأنماط تنظيم المكونات. توفر هذه المهارة إرشادات شاملة حول بنية الإضافات حتى تتمكن من بناء إضافات قابلة للصيانة تتبع اتفاقيات Claude Code.
يدعم: Claude Code(CC)
1
تنزيل ZIP المهارة
2
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
3
فعّل وابدأ الاستخدام
اختبرها
استخدام "plugin-structure". How do I structure a new plugin with commands and hooks?
النتيجة المتوقعة:
- تتبع إضافة Claude Code هذه البنية:
- • .claude-plugin/plugin.json - البيان المطلوب
- • commands/ - تعريفات الأوامر المائلة (ملفات .md)
- • hooks/ - تكوين معالج الأحداث
- يحدد البيان بيانات تعريف الإضافة ويمكنه تحديد مسارات مخصصة. تكتشف الأوامر والخطافات تلقائياً من أدلتها. يمكن للخطافات تشغيل سكريبتات bash استجابةً لأحداث مثل PreToolUse أو PostToolUse.
استخدام "plugin-structure". What goes in the plugin.json file?
النتيجة المتوقعة:
- يتطلب بيان plugin.json فقط حقل name كحد أدنى. الحقول الموصى بها تشمل version وdescription وauthor وlicense. يمكن تخصيص مسارات المكونات لكن الأدلة الافتراضية تكتشف تلقائياً. استخدم ${CLAUDE_PLUGIN_ROOT} لمراجع السكريبتات القابلة للنقل في تكوينات الخطافات.
استخدام "plugin-structure". How do I organize skills in my plugin?
النتيجة المتوقعة:
- تذهب المهارات في دليل skills/ مع كل مهارة في دليلها الخاص يحتوي على ملف SKILL.md. يكتشف Claude Code تلقائياً جميع ملفات SKILL.md في أدلة المهارات. يمكن أن تتضمن المهارات ملفات داعمة مثل السكريبتات والمراجع والأمثلة في أدلتها.
التدقيق الأمني
آمنv4 • 1/16/2026
This is a documentation-only skill from the official Anthropic repository (anthropics/claude-plugins-official). All 583 static findings are FALSE POSITIVES - the detected patterns are markdown code block delimiters, example configurations, and educational content in documentation files, not executable code with security implications.
9
الملفات التي تم فحصها
6,050
الأسطر التي تم تحليلها
4
النتائج
4
إجمالي عمليات التدقيق
عوامل الخطر
⚙️ الأوامر الخارجية (457)
evaluation.json:24 evaluation.json:24 examples/advanced-plugin.md:7-99 examples/advanced-plugin.md:99-105 examples/advanced-plugin.md:105-143 examples/advanced-plugin.md:143-147 examples/advanced-plugin.md:147-176 examples/advanced-plugin.md:176-180 examples/advanced-plugin.md:180-198 examples/advanced-plugin.md:198 examples/advanced-plugin.md:204 examples/advanced-plugin.md:204-223 examples/advanced-plugin.md:223-227 examples/advanced-plugin.md:227-285 examples/advanced-plugin.md:285-286 examples/advanced-plugin.md:286-287 examples/advanced-plugin.md:287-292 examples/advanced-plugin.md:292 examples/advanced-plugin.md:295 examples/advanced-plugin.md:295-300 examples/advanced-plugin.md:300 examples/advanced-plugin.md:307 examples/advanced-plugin.md:307-308 examples/advanced-plugin.md:308-312 examples/advanced-plugin.md:312-383 examples/advanced-plugin.md:383 examples/advanced-plugin.md:389 examples/advanced-plugin.md:389-396 examples/advanced-plugin.md:396 examples/advanced-plugin.md:399 examples/advanced-plugin.md:399-428 examples/advanced-plugin.md:428 examples/advanced-plugin.md:436 examples/advanced-plugin.md:436-444 examples/advanced-plugin.md:444 examples/advanced-plugin.md:458 examples/advanced-plugin.md:458-468 examples/advanced-plugin.md:468-473 examples/advanced-plugin.md:473 examples/advanced-plugin.md:473-478 examples/advanced-plugin.md:478-483 examples/advanced-plugin.md:483 examples/advanced-plugin.md:483-490 examples/advanced-plugin.md:490 examples/advanced-plugin.md:494 examples/advanced-plugin.md:494-497 examples/advanced-plugin.md:497 examples/advanced-plugin.md:500 examples/advanced-plugin.md:500-503 examples/advanced-plugin.md:503 examples/advanced-plugin.md:506 examples/advanced-plugin.md:506-518 examples/advanced-plugin.md:518 examples/advanced-plugin.md:526 examples/advanced-plugin.md:526-531 examples/advanced-plugin.md:531 examples/advanced-plugin.md:545 examples/advanced-plugin.md:545-567 examples/advanced-plugin.md:567 examples/advanced-plugin.md:586 examples/advanced-plugin.md:586-593 examples/advanced-plugin.md:593 examples/advanced-plugin.md:595 examples/advanced-plugin.md:595-598 examples/advanced-plugin.md:598 examples/advanced-plugin.md:600 examples/advanced-plugin.md:600-603 examples/advanced-plugin.md:603 examples/advanced-plugin.md:605 examples/advanced-plugin.md:605-610 examples/advanced-plugin.md:610-611 examples/advanced-plugin.md:611-612 examples/advanced-plugin.md:612-617 examples/advanced-plugin.md:617-618 examples/advanced-plugin.md:618-619 examples/advanced-plugin.md:619-624 examples/advanced-plugin.md:624 examples/advanced-plugin.md:626 examples/advanced-plugin.md:626-627 examples/advanced-plugin.md:627-631 examples/advanced-plugin.md:631-697 examples/advanced-plugin.md:697-716 examples/advanced-plugin.md:716-723 examples/advanced-plugin.md:498 examples/minimal-plugin.md:7-13 examples/minimal-plugin.md:13-19 examples/minimal-plugin.md:19-23 examples/minimal-plugin.md:23-27 examples/minimal-plugin.md:27-46 examples/minimal-plugin.md:46-52 examples/minimal-plugin.md:52-60 examples/minimal-plugin.md:60-64 examples/minimal-plugin.md:64-65 examples/minimal-plugin.md:65-80 examples/minimal-plugin.md:80 examples/minimal-plugin.md:80-81 examples/minimal-plugin.md:81-82 examples/minimal-plugin.md:82-83 examples/standard-plugin.md:7-35 examples/standard-plugin.md:35-41 examples/standard-plugin.md:41-55 examples/standard-plugin.md:55-59 examples/standard-plugin.md:59-80 examples/standard-plugin.md:80 examples/standard-plugin.md:82 examples/standard-plugin.md:82-93 examples/standard-plugin.md:93-97 examples/standard-plugin.md:97-128 examples/standard-plugin.md:128-132 examples/standard-plugin.md:132-165 examples/standard-plugin.md:165-175 examples/standard-plugin.md:175-179 examples/standard-plugin.md:179-212 examples/standard-plugin.md:212-222 examples/standard-plugin.md:222-226 examples/standard-plugin.md:226-293 examples/standard-plugin.md:293 examples/standard-plugin.md:307 examples/standard-plugin.md:307-320 examples/standard-plugin.md:320-321 examples/standard-plugin.md:321-325 examples/standard-plugin.md:325-334 examples/standard-plugin.md:334 examples/standard-plugin.md:334 examples/standard-plugin.md:334-336 examples/standard-plugin.md:336 examples/standard-plugin.md:343 examples/standard-plugin.md:343-349 examples/standard-plugin.md:349 examples/standard-plugin.md:359 examples/standard-plugin.md:359-365 examples/standard-plugin.md:365 examples/standard-plugin.md:379 examples/standard-plugin.md:379-387 examples/standard-plugin.md:387 examples/standard-plugin.md:402 examples/standard-plugin.md:402-408 examples/standard-plugin.md:408 examples/standard-plugin.md:416 examples/standard-plugin.md:416-421 examples/standard-plugin.md:421-422 examples/standard-plugin.md:422-423 examples/standard-plugin.md:423-424 examples/standard-plugin.md:424-428 examples/standard-plugin.md:428-455 examples/standard-plugin.md:455-459 examples/standard-plugin.md:459-504 examples/standard-plugin.md:504-510 examples/standard-plugin.md:510-545 examples/standard-plugin.md:545-549 examples/standard-plugin.md:549-572 examples/standard-plugin.md:466 examples/standard-plugin.md:472 examples/standard-plugin.md:486 examples/standard-plugin.md:491 examples/standard-plugin.md:459-504 examples/standard-plugin.md:460 README.md:9 README.md:12 README.md:34 references/component-patterns.md:11 references/component-patterns.md:35-42 references/component-patterns.md:42-58 references/component-patterns.md:58-70 references/component-patterns.md:70-73 references/component-patterns.md:73-81 references/component-patterns.md:81-97 references/component-patterns.md:97-109 references/component-patterns.md:109-113 references/component-patterns.md:113-121 references/component-patterns.md:121-139 references/component-patterns.md:139-145 references/component-patterns.md:145-156 references/component-patterns.md:156-162 references/component-patterns.md:162-173 references/component-patterns.md:173-179 references/component-patterns.md:179-192 references/component-patterns.md:192-202 references/component-patterns.md:202-213 references/component-patterns.md:213-227 references/component-patterns.md:227-238 references/component-patterns.md:238-254 references/component-patterns.md:254-265 references/component-patterns.md:265-282 references/component-patterns.md:282-297 references/component-patterns.md:297-304 references/component-patterns.md:304-307 references/component-patterns.md:307-314 references/component-patterns.md:314-325 references/component-patterns.md:325-337 references/component-patterns.md:337-340 references/component-patterns.md:340-346 references/component-patterns.md:346-359 references/component-patterns.md:359-374 references/component-patterns.md:374-387 references/component-patterns.md:387-394 references/component-patterns.md:394-405 references/component-patterns.md:405-419 references/component-patterns.md:419-430 references/component-patterns.md:430-441 references/component-patterns.md:441-454 references/component-patterns.md:454-467 references/component-patterns.md:467-470 references/component-patterns.md:470-474 references/component-patterns.md:474-485 references/component-patterns.md:485-494 references/component-patterns.md:494-505 references/component-patterns.md:505-519 references/component-patterns.md:519-522 references/component-patterns.md:522-530 references/component-patterns.md:471 references/manifest-reference.md:3 references/manifest-reference.md:7 references/manifest-reference.md:9 references/manifest-reference.md:19 references/manifest-reference.md:34-36 references/manifest-reference.md:36-39 references/manifest-reference.md:39 references/manifest-reference.md:39 references/manifest-reference.md:39-40 references/manifest-reference.md:40 references/manifest-reference.md:40 references/manifest-reference.md:40 references/manifest-reference.md:40-46 references/manifest-reference.md:46-47 references/manifest-reference.md:47-55 references/manifest-reference.md:55-56 references/manifest-reference.md:56-57 references/manifest-reference.md:57-60 references/manifest-reference.md:60-61 references/manifest-reference.md:61-62 references/manifest-reference.md:62-63 references/manifest-reference.md:63-69 references/manifest-reference.md:69-92 references/manifest-reference.md:92-100 references/manifest-reference.md:100-103 references/manifest-reference.md:103-107 references/manifest-reference.md:107-118 references/manifest-reference.md:118-129 references/manifest-reference.md:129-131 references/manifest-reference.md:131-136 references/manifest-reference.md:136-141 references/manifest-reference.md:141-145 references/manifest-reference.md:145-148 references/manifest-reference.md:148-156 references/manifest-reference.md:156-168 references/manifest-reference.md:168-173 references/manifest-reference.md:173-174 references/manifest-reference.md:174-175 references/manifest-reference.md:175-176 references/manifest-reference.md:176-177 references/manifest-reference.md:177-178 references/manifest-reference.md:178-183 references/manifest-reference.md:183-187 references/manifest-reference.md:187-192 references/manifest-reference.md:192-204 references/manifest-reference.md:204 references/manifest-reference.md:204 references/manifest-reference.md:204 references/manifest-reference.md:204-205 references/manifest-reference.md:205 references/manifest-reference.md:205 references/manifest-reference.md:205 references/manifest-reference.md:205-206 references/manifest-reference.md:206 references/manifest-reference.md:206 references/manifest-reference.md:206-207 references/manifest-reference.md:207 references/manifest-reference.md:207 references/manifest-reference.md:207-214 references/manifest-reference.md:214-215 references/manifest-reference.md:215-220 references/manifest-reference.md:220-224 references/manifest-reference.md:224-227 references/manifest-reference.md:227-235 references/manifest-reference.md:235-237 references/manifest-reference.md:237-247 references/manifest-reference.md:247-248 references/manifest-reference.md:248-252 references/manifest-reference.md:252-262 references/manifest-reference.md:262-267 references/manifest-reference.md:267-271 references/manifest-reference.md:271-274 references/manifest-reference.md:274-291 references/manifest-reference.md:291-301 references/manifest-reference.md:301-306 references/manifest-reference.md:306-310 references/manifest-reference.md:310-313 references/manifest-reference.md:313-325 references/manifest-reference.md:325-329 references/manifest-reference.md:329-339 references/manifest-reference.md:339-340 references/manifest-reference.md:340-344 references/manifest-reference.md:344-345 references/manifest-reference.md:345-346 references/manifest-reference.md:346-347 references/manifest-reference.md:347-348 references/manifest-reference.md:348 references/manifest-reference.md:348-349 references/manifest-reference.md:349-350 references/manifest-reference.md:350-357 references/manifest-reference.md:357-358 references/manifest-reference.md:358-359 references/manifest-reference.md:359-360 references/manifest-reference.md:360-361 references/manifest-reference.md:361-364 references/manifest-reference.md:364-365 references/manifest-reference.md:365-366 references/manifest-reference.md:366 references/manifest-reference.md:366-385 references/manifest-reference.md:385-386 references/manifest-reference.md:386-387 references/manifest-reference.md:387-398 references/manifest-reference.md:398-402 references/manifest-reference.md:402-404 references/manifest-reference.md:404-408 references/manifest-reference.md:408-411 references/manifest-reference.md:411-415 references/manifest-reference.md:415-417 references/manifest-reference.md:417-421 references/manifest-reference.md:421-424 references/manifest-reference.md:424-428 references/manifest-reference.md:428-430 references/manifest-reference.md:430-434 references/manifest-reference.md:434-437 references/manifest-reference.md:437-441 references/manifest-reference.md:441-443 references/manifest-reference.md:443-447 references/manifest-reference.md:447-455 references/manifest-reference.md:455-459 references/manifest-reference.md:459-467 references/manifest-reference.md:467-481 references/manifest-reference.md:481-487 references/manifest-reference.md:487-519 SKILL.md:15 SKILL.md:17 SKILL.md:24-37 SKILL.md:37-41 SKILL.md:41 SKILL.md:41-42 SKILL.md:42-48 SKILL.md:48-52 SKILL.md:52-56 SKILL.md:56-62 SKILL.md:62 SKILL.md:62 SKILL.md:62-66 SKILL.md:66-81 SKILL.md:81-90 SKILL.md:90-98 SKILL.md:98-104 SKILL.md:104-112 SKILL.md:112-114 SKILL.md:114 SKILL.md:114-117 SKILL.md:117-122 SKILL.md:122-125 SKILL.md:125-132 SKILL.md:132-138 SKILL.md:138-140 SKILL.md:140 SKILL.md:140-143 SKILL.md:143-148 SKILL.md:148-151 SKILL.md:151-160 SKILL.md:160-166 SKILL.md:166-167 SKILL.md:167-168 SKILL.md:168-171 SKILL.md:171-183 SKILL.md:183-186 SKILL.md:186-194 SKILL.md:194-202 SKILL.md:202 SKILL.md:202-207 SKILL.md:207-213 SKILL.md:213-216 SKILL.md:216-227 SKILL.md:227-235 SKILL.md:235 SKILL.md:235-240 SKILL.md:240-252 SKILL.md:252-260 SKILL.md:260-262 SKILL.md:262-266 SKILL.md:266-280 SKILL.md:280-281 SKILL.md:281-282 SKILL.md:282-287 SKILL.md:287-289 SKILL.md:289-292 SKILL.md:292-294 SKILL.md:294-297 SKILL.md:297-301 SKILL.md:301-307 SKILL.md:307-308 SKILL.md:308 SKILL.md:308-309 SKILL.md:309 SKILL.md:309-310 SKILL.md:310 SKILL.md:310-312 SKILL.md:312-313 SKILL.md:313-314 SKILL.md:314-315 SKILL.md:315-318 SKILL.md:318-319 SKILL.md:319-320 SKILL.md:320-325 SKILL.md:325-326 SKILL.md:326-327 SKILL.md:327-330 SKILL.md:330-331 SKILL.md:331-332 SKILL.md:332-335 SKILL.md:335-336 SKILL.md:336-337 SKILL.md:337-343 SKILL.md:343-344 SKILL.md:344 SKILL.md:344-345 SKILL.md:345 SKILL.md:345-346 SKILL.md:346 SKILL.md:346-347 SKILL.md:347-348 SKILL.md:348-355 SKILL.md:355-363 SKILL.md:363-365 SKILL.md:365-378 SKILL.md:378 SKILL.md:378-382 SKILL.md:382 SKILL.md:382-383 SKILL.md:383 SKILL.md:383 SKILL.md:383-386 SKILL.md:386 SKILL.md:386-387 SKILL.md:387 SKILL.md:387-388 SKILL.md:388 SKILL.md:388-409 SKILL.md:409-415 SKILL.md:415-420 SKILL.md:420-432 SKILL.md:432-437 SKILL.md:437-446 SKILL.md:446-453 SKILL.md:453 SKILL.md:453-457 SKILL.md:457-458 SKILL.md:458-460 SKILL.md:460-463 SKILL.md:463-476 SKILL.md:476 SKILL.md:298
🔑 متغيرات البيئة (8)
🌐 الوصول إلى الشبكة (21)
examples/advanced-plugin.md:113 examples/advanced-plugin.md:115 examples/advanced-plugin.md:118 examples/standard-plugin.md:50 examples/standard-plugin.md:51 references/manifest-reference.md:97 references/manifest-reference.md:105 references/manifest-reference.md:118 references/manifest-reference.md:136 references/manifest-reference.md:143 references/manifest-reference.md:152 references/manifest-reference.md:180 references/manifest-reference.md:476 references/manifest-reference.md:477 references/manifest-reference.md:495 references/manifest-reference.md:497 references/manifest-reference.md:500 skill-report.json:6 SKILL.md:74 SKILL.md:76 SKILL.md:77
📁 الوصول إلى نظام الملفات (9)
تم تدقيقه بواسطة: claude عرض سجل التدقيق →
درجة الجودة
55
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
21
المجتمع
100
الأمان
100
الامتثال للمواصفات
ماذا يمكنك بناءه
بناء إضافتك الأولى
يحتاج المطورون الجدد الذين يتعلمون بنية إضافات Claude Code إلى إرشادات واضحة حول تخطيط الدليل، وإعداد البيان، وتنظيم المكونات.
تأسيس معايير الفريق
تحتاج الفرق التي تتبنى Claude Code إلى أنماط بنية الإضافات المتسقة لتطوير إضافات قابلة للصيانة وقابلة للتوسع عبر المشاريع.
النشر في السوق
يحتاج مؤلفو الإضافات الذين يعدون الإضافات للنشر في السوق إلى فهم الاتفاقيات وأفضل ممارسات التبني المجتمعي.
جرّب هذه الموجهات
إنشاء إضافة
كيف أقوم ب هيكلة إضافة Claude Code جديدة؟ ما الأدلة التي أحتاجها وأين يجب أن يذهب ملف plugin.json؟
تكوين البيان
ما الحقول المطلوبة في plugin.json؟ أرني كيفية تكوين مسارات مخصصة للأوامر والوكلاء والخطافات.
تنظيم المكونات
كيف يجب أن أنظم الأوامر والوكلاء والمهارات والخطافات في إضافتي؟ ما اتفاقيات التسمية التي يجب أن أتبعها؟
أنماط متقدمة
أرني مثالاً متقدماً للإضافة مع خوادم MCP والخطافات وال스크بتات المشتركة. كيف أستخدم ${CLAUDE_PLUGIN_ROOT} بشكل صحيح؟أفضل الممارسات
- استخدم kebab-case لجميع أسماء الأدلة وأسماء الملفات وأسماء المكونات للاتساق عبر المنصات.
- حافظ على بيان plugin.json واعتمد على الاكتشاف التلقائي لدلائل المكونات القياسية.
- استخدم دائمًا ${CLAUDE_PLUGIN_ROOT} بدلاً من المسارات المطلقة الثابتة لجعل إضافتك قابلة للنقل.
تجنب
- ترميز المسارات المطلقة الثابتة مثل /Users/name/plugins/ - هذا يكسر قابلية النقل عبر الأنظمة المختلفة.
- تداخل أدلة المكونات داخل .claude-plugin/ - يجب أن تكون المكونات على مستوى جذر الإضافة.
- تجاهل بيان plugin.json أو وضعه في الموقع الخطأ - يتطلب Claude Code وجوده في .claude-plugin/
الأسئلة المتكررة
ما هو المطلوب بحد أدنى لإضافة Claude Code؟
تحتاج الإضافة الحد الأدنى فقط إلى .claude-plugin/plugin.json مع حقل name، وواحد على الأقل من المكونات مثل الأمر في دليل commands/.
أين يجب أن أضع ملف plugin.json؟
يجب أن يكون plugin.json في دليل .claude-plugin في جذر الإضافة الخاصة بك. تذهب المكونات مثل commands وagents وskills في المستوى الجذري، وليس داخل .claude-plugin.
كيف أستخدم المسارات القابلة للنقل في إضافتي؟
استخدم ${CLAUDE_PLUGIN_ROOT} كعنصر نائب لدليل تثبيت الإضافتك. يتم تعيين هذه المتغير البيئي تلقائيًا ويعمل عبر جميع المنصات.
ما المكونات التي يمكن أن تحتويها إضافة؟
يمكن أن تتضمن الإضافات أوامر (أوامر مائلة) ووكلاء (تعريفات الوكيل الفرعي) ومهارات (قدرات التنشيط التلقائي) وخطافات (معالجات الأحداث) وخوادم MCP وسكريبتات مساعدة.
كيف يعمل الاكتشاف التلقائي؟
يجد Claude Code المكونات تلقائيًا عن طريق مسح الأدلة القياسية: commands/ وagents/ وskills/ وتحميل hooks.json. لا تسجيل يدوي مطلوب للتخطيطات القياسية.
هل يمكنني استخدام مسارات مخصصة للمكونات؟
نعم، يمكنك تحديد مسارات مخصصة في plugin.json. هذه المسارات تُكمل الأدلة الافتراضية وليست بديلاً عنها. يجب أن تبدأ المسارات المخصصة بـ ./ وتكون نسبية من جذر الإضافة.