技能 file-organization
📦

file-organization

安全

نظّم ملفات مشروعك كمحترف

هياكل المجلدات الفوضوية تبطئ التطوير وتربك أعضاء الفريق. توفر هذه المهارة أنماطًا مثبتة لتنظيم الملفات في مشاريع React و Node.js والمشاريع القائمة على الميزات التي تتماشى مع قاعدة الكود الخاصة بك.

支持: Claude Codex Code(CC)
📊 70 充足
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“file-organization”。 إنشاء بنية لتطبيق React للتجارة الإلكترونية

预期结果:

  • src/
  • ├── app/
  • │ ├── layout.tsx
  • │ └── page.tsx
  • ├── components/
  • │ ├── ui/
  • │ │ ├── Button/
  • │ │ └── Input/
  • │ └── features/
  • │ ├── products/
  • │ └── cart/
  • ├── lib/
  • │ ├── api/
  • │ └── hooks/
  • ├── store/
  • ├── types/
  • └── config/

正在使用“file-organization”。 عرض اتفاقيات التسمية لملفات TypeScript

预期结果:

  • المكونات: UserProfile.tsx (PascalCase)
  • الخطافات: useAuth.ts (camelCase مع بادئة 'use')
  • الأدوات: formatDate.ts (camelCase)
  • الثوابت: API_ENDPOINTS.ts (UPPER_SNAKE_CASE)
  • الأنواع: user.types.ts (camelCase.types.ts)
  • الاختبارات: UserProfile.test.ts (*.test.ts)

安全审计

安全
v1 • 3/10/2026

All 43 static analysis findings are false positives. The skill is purely educational documentation containing markdown code examples showing file structure patterns, naming conventions, and best practices. No executable code, command injection, or malicious behavior detected. Code blocks marked as Ruby/shell execution are documentation examples. URLs and file paths are reference links and template structures, not actual code execution.

2
已扫描文件
348
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
25
社区
100
安全
91
规范符合性

你能构建什么

بدء مشروع React جديد

أنشئ ب��رعة بنية مجلدات قابلة للتوسع لتطبيق React أو Next.js جديد مع فصل صحيح للمكونات والخطافات والأدوات وملفات التكوين.

إعادة بناء قاعدة كود متنامية

أعد هيكلة مشروع غير منظم أصبح من الصعب التنقل فيه من خلال تنفيذ التنظيم القائم على الميزات وأنماط التسمية المتسقة.

توحيد معايير الفريق

أنشئ ووثق معايير تنظيم الملفات التي يتبعها جميع أعضاء الفريق، مما يقلل الارتباك ووقت التهيئة للمطورين الجدد.

试试这些提示

بنية React الأساسية
إنشاء بنية مجلدات لمشروع React جديد مع مكونات وخطافات وأدو��ت وإعداد عميل API.
Next.js App Router
إنشاء بنية مشروع Next.js 13+ باستخدام App Router مع مجموعات مسارات لأقسام المصادقة ولوحة التحكم.
واجهة خلفية Node.js API
تصميم بنية خلفية Node.js و Express مع فصل صحيح للمسارات ووحدات التحكم والخدمات والمستودعات والبرمجيات الوسيطة.
ترحيل قائم على الميزات
تحويل بنية مشروعي الحالية القائمة على المكونات إلى تنظيم قائم على الميزات مع وحدات مستقلة ذاتيًا لميزات المصادقة والمنتجات والطلبات.

最佳实践

  • احتفظ بالملفات ذات الصلة معًا من خلال التنسيق: ضع اختبارات المكون والأنماط والأنواع في نفس المجلد مثل المكون
  • استخدم التنظيم القائم على الميزات للتطبيقات الكبيرة بدلاً من التجميع حسب نوع الملف (components/، hooks/، utils/)
  • كوّن أسماء TypeScript المستعارة للمسار لاستبدال الاستيرادات النسبية مثل '../../../components/ui/Button' بـ '@/components/ui/Button'

避免

  • إنشاء أسماء مجلدات غامضة مثل utils/ أو helpers/ أو misc/ أو common/ التي تجمع كودًا غير مرتبط
  • تداخل المجلدات أعمق من 5-7 مستويات مما يجعل التنقل والاستيرادات صعبًا
  • استخدام export * from './module' في ملفات barrel مما يؤثر سلبًا على tree-shaking ويجعل التصحيح أصعب

常见问题

هل يجب أن أنظم حسب نوع الملف أم حسب الميزة؟
استخدم التنظيم القائم على الميزات للتطبيقات الكبيرة ذات المجالات المتعددة (auth و products و orders). نظم حسب نوع الملف (components/، hooks/) للمشاريع الصغيرة أو عناصر واجهة المستخدم المشتركة. ادمج كلا النهجين: features/ للكود الخاص بالمجال و shared/ للأدوات القابلة لإعادة الاستخدام.
ما هو الحد الأقصى لعمق المجلد الذي يجب استخدامه؟
احتفظ بعمق المجلد في 5 مستويات أو أقل. التداخل الزائد يجعل الاستيراد معقدًا والتنقل صعبًا. إذا تجاوزت 7 مستويات، فكر في تسطيح بنيتك أو استخدام وحدات قائمة على الميزات لتقليل العمق.
كيف أتعامل مع الكود المشترك بين الميزات؟
أنشئ مجل�� shared/ على المستوى الجذري للأدوات والمكونات والخطافات والأنواع المشتركة عبر الميزات. يمكن لكل ميزة الاستيراد من shared/ مع الحفاظ على بنيتها الداخلية. احتفظ بـ shared/ بسيطًا وموثقًا جيدًا.
هل يجب أن أستخدم ملفات barrel (index.ts) للتصديرات؟
استخدم التصديرات المسماة في ملفات barrel (export { Button } from './Button') بدلاً من إعادة تصدير كل شيء (export * from './Button'). تدعم التصديرات المسماة tree-shaking وتحسن الإكمال التلقائي لبيئة التطوير وتجعل التبعيات صريحة.
كيف أختار بين kebab-case و camelCase و PascalCase للمجلدات؟
التناسق أهم من الاتفاقية المحددة. استخدم kebab-case (user-profile/) للمجلدات العامة، و camelCase (hooks/، utils/) لمجلدات الأدوات، و PascalCase (components/) لمجلدات مكونات React. اختر نمطًا واحدًا وفر��ه عبر فريقك.
هل يمكن لهذه المهارة إعادة تنظيم مشروعي الحالي تلقائيًا؟
لا، توفر هذه المهارة إرشادات وقوالب لتنظيم الملفات. يجب عليك تنفيذ البنى المقترحة يدويًا أو استخدام الأنماط كمرجع عند إعادة الهيكلة. يمكن للمهارة إنشاء أوامر مستهدفة لمهام إعادة التنظيم ��لمحددة.

开发者详情

文件结构

📄 SKILL.md

📄 SKILL.toon