المهارات software-architecture
🏗️

software-architecture

آمن 🌐 الوصول إلى الشبكة📁 الوصول إلى نظام الملفات⚙️ الأوامر الخارجية

設計清晰的軟體架構

متاح أيضًا من: Chemiseblanc,sickn33

糟糕的架構會導致技術債務和難以維護。此技能提供 SOLID 原則和 Clean Architecture 模式,幫助您從一開始就建立可維護、可測試的系統。

يدعم: Claude Codex Code(CC)
📊 70 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "software-architecture". Design a user authentication module with Clean Architecture

النتيجة المتوقعة:

  • 領域層:User 實體、UserRepository 介面、AuthenticationService 介面
  • 應用層:LoginUseCase、RegisterUseCase、AuthenticateUserService
  • 基礎設施層:UserRepositoryImpl、PasswordEncoder、JWT token 生成器
  • 展示層:AuthController、AuthRequest DTO、AuthResponse DTO
  • 依賴方向:所有層次都指向領域層

استخدام "software-architecture". How do I structure a new Python project following Clean Architecture?

النتيجة المتوقعة:

  • 領域層:models/ 包含純業務實體和例外
  • 應用層:use_cases/ 包含業務規則實作
  • 基礎設施層:repositories/、services/ 用於外部關注點
  • 展示層:api/、cli/ 用於使用者介面
  • 避免:將業務邏輯放在 api/ 或將 models/ 與基礎設施混合

استخدام "software-architecture". What are signs that a class violates Single Responsibility Principle?

النتيجة المتوقعة:

  • 類別名稱包含多個概念,如 UserHelperAuthFormatter
  • 方法不共享共同的目的或變更頻率
  • 難以用一句話描述類別職責
  • 當其任何功能變更時,類別都需要修改
  • 管理多個關注點導致高循環複雜度

التدقيق الأمني

آمن
v5 • 1/17/2026

This is a pure documentation skill containing architectural guidelines. The static findings are all false positives triggered by pattern matching on benign content. The skill-report.json contains standard metadata (URLs, hashes) and the SKILL.md contains markdown documentation with code examples for educational purposes. No executable code, network calls, file system access, or command execution exists.

2
الملفات التي تم فحصها
308
الأسطر التي تم تحليلها
3
النتائج
5
إجمالي عمليات التدقيق

عوامل الخطر

تم تدقيقه بواسطة: claude عرض سجل التدقيق →

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
21
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

設計新功能

在設計新功能時應用 Clean Architecture,確保程式碼結構可維護。

審查架構

根據 SOLID 原則和架構最佳實踐評估提議的解決方案。

修復遺留程式碼

識別反模式並將關注點分離應用於遺留程式碼庫。

جرّب هذه الموجهات

新功能設計
Design a new feature using Clean Architecture. Show how to separate domain, application, and infrastructure layers. Apply SOLID principles. Include early return patterns.
程式碼審查
Review this code for SOLID principle violations. Identify God Classes, nested conditionals, and incorrect dependency direction. Suggest specific refactoring.
反模式修復
This code has deep nesting and mixed concerns. Refactor using early return pattern and separate into appropriate layers with domain-specific naming.
架構決策
Evaluate these three approaches for our use case. Consider dependency direction, testability, and separation of concerns. Use the decision checklist.

أفضل الممارسات

  • 應用單一職責原則 - 每個類別都有一個明確的目的
  • 遵循依賴規則 - 外層依賴內層,絕不反向
  • 使用領域特定命名,而非通用名稱如 utils 或 common

تجنب

  • NIH 症候群 - 避免重新發明輪子,優先使用程式庫解決方案
  • 上帝類別 - 拆分職責過多的類別
  • 深度巢狀 - 使用提前返回來扁平化條件邏輯

الأسئلة المتكررة

哪些 AI 工具支援此技能?
與 Claude、Codex 和 Claude Code 相容。適用於任何遵循系統提示的 LLM。
建議的函式大小上限是多少?
建議 30 行,最多 50 行。超過 50 行的函式應拆分為更小的單元。
如何與現有程式碼庫整合?
在設計會議期間將此技能作為指南使用。將原則逐步應用於新程式碼和重構任務。
此技能是否會存取我的檔案或資料?
否。這是一個僅提供架構指導的提示技能。它不會讀取、寫入或執行任何程式碼。
如果我的框架有特定模式怎麼辦?
根據您的框架調整 Clean Architecture 原則。分層分離的核心概念保持不變。
這與設計模式有何不同?
設計模式解決特定問題。架構原則定義整體結構。兩者結合使用以獲得可維護的程式碼。

تفاصيل المطور

المؤلف

Doyajin174

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md