技能 review-architecture
🏗️

review-architecture

安全 🌐 網路存取📁 檔案系統存取⚙️ 外部命令

مراجعة البنية المعمارية لمعايير جودة الكود

تأكد من أن الكود الخاص بك يلبي المعايير المعمارية ويتبع الأنماط المعتمدة. توفر هذه المهارة مراجعات معمارية منهجية لقواعد كود متسقة وقابلة للصيانة عبر مشاريع Spring Boot وNext.js.

支援: Claude Codex Code(CC)
⚠️ 68
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「review-architecture」。 راجع وحدة التحكم Spring Boot هذه للامتثال المعماري

預期結果:

  • ✅ بنية الحزم: موضوعة بشكل صحيح في حزمة controller
  • ✅ اتفاقيات التسمية: نقطة نهاية RESTful بدون أفعال
  • ✅ التعليقات التوضيحية: استخدام صحيح لـ @RestController و@RequestMapping
  • ✅ التحقق: تم تطبيق تعليق @Valid
  • ❌ انتهاك DRY: يجب استخدام SecurityUtils.getCurrentUserId()
  • ❌ التوثيق: لم يتم إضافة رمز الخطأ الجديد إلى error-codes.md
  • ⚠️ بشكل عام: بنية جيدة مع الحاجة لتحسينات طفيفة

正在使用「review-architecture」。 حلل مكون صفحة Next.js هذا لمعايير الجودة

預期結果:

  • ✅ الوضع الصارم TypeScript: لم يتم اكتشاف أخطاء
  • ✅ مكون Server/Client: تم وضع العلامة بشكل مناسب
  • ✅ shadcn/ui: استخدام مكون Button بشكل صحيح
  • ❌ React Hooks: دالة التنظيف useEffect مفقودة
  • ❌ التصدير: يجب أن يكون التصدير المسمى عند وقت التعريف
  • ⚠️ بشكل عام: مشاكل طفيفة تحتاج إلى إصلاح قبل الدمج

安全審計

安全
v5 • 1/16/2026

This is a pure documentation skill with no executable code. The static scanner produced false positives by misidentifying documentation markup (backticks for code blocks), file path references, and documentation filenames as security vulnerabilities. No network calls, no command execution, no cryptographic operations exist in this skill.

2
已掃描檔案
648
分析行數
3
發現項
5
審計總數
審計者: claude 查看審計歷史 →

品質評分

38
架構
95
可維護性
87
內容
22
社群
100
安全
83
規範符合性

你能建構什麼

اتساق البنية المعمارية

تأكد من أن الكود الجديد يتبع الأنماط المعمارية المعتمدة قبل الدمج في الفرع الرئيسي.

حراسة جودة الكود

أتمتة عمليات مراجعة الكود للحفاظ على معايير جودة متسقة عبر الفريق.

تكامل CI/CD

دمج مراجعات البنية المعمارية في سير عمل CI/CD لاكتشاف مشكلات التصميم مبكراً.

試試這些提示

مراجعة معمارية أساسية
راجع كود Spring Boot هذا للامتثال المعماري: تحقق من بنية الحزم واتفاقيات التسمية ومبادئ DRY وتحديثات التوثيق.
معايير الواجهة الأمامية
حلل مكون Next.js هذا للامتثال للوضع الصارم في TypeScript والاستخدام الصحيح لـ React Hooks وأفضل ممارسات shadcn/ui.
مراجعة تصميم API
تحقق من تطبيق API هذا لمبادئ تصميم RESTful وطرق HTTP الصحيحة ومواءمة توثيق OpenAPI.
تدقيق شامل
قم بإجراء مراجعة معمارية كاملة لطلب السحب هذا تغطي معايير Java الخلفية والامتثال لـ TypeScript الأمامي واتساق التوثيق.

最佳實務

  • اقرأ دائماً توثيق المشروع قبل بدء المراجعات لفهم السياق والمتطلبات
  • ركز فقط على التغييرات الجديدة - تجنب تكرار المشكلات التي تم معالجتها بالفعل من المراجعات السابقة
  • قدم ملاحظات محددة وقابلة للتنفيذ مع مسارات الملفات وأرقام الأسطر لسهولة الإصلاح

避免

  • لا تراجع دون فهم معايير الترميز والأنماط المعمارية للمشروع
  • تجنب الملاحظات العامة - أشر دائماً إلى قواعد محددة من backend-rules.md أو frontend-rules.md
  • لا توافق أبداً على كود يخالف المتطلبات الإلزامية مثل @SuppressWarnings أو أنواع any في TypeScript

常見問題

ما هي معايير الترميز التي تتحقق منها هذه المهارة؟
يتحقق من Google Java Style Guide للخلفية والوضع الصارم TypeScript للواجهة الأمامية بالإضافة إلى قواعد خاصة بالمشروع.
هل يمكنها مراجعة مشاريع تستخدم حزم تقنية مختلفة؟
حالياً محسّن فقط لـ Spring Boot الخلفي وNext.js الأمامي مع مكونات shadcn/ui.
كيف تتعامل مع تحديثات التوثيق؟
يتحقق من تحديث error-codes.md وdatabase-design.md وapi-docs.yaml عند إجراء تغييرات ذات صلة في الكود.
هل المهارة آمنة للاستخدام على قواعد كود حساسة؟
نعم، هي توثيقية فقط بدون وصول للشبكة أو تنفيذ للكود - مجرد تحليل وتوصيات.
ماذا لو لم يكن مشروعي يحتوي على ملفات قواعد ترميز؟
تتطلب المهارة ملفات توثيق موجودة مثل backend-rules.md وfrontend-rules.md للعمل بشكل صحيح.
ما مدى صرامة عملية المراجعة؟
صارمة جداً - يجب استيفاء جميع الشروط الإلزامية للموافقة مع عدم التسامح مع الانتهاكات الحرجة.

開發者詳情

檔案結構

📄 SKILL.md