المهارات system-design
🏛️
system-design
آمن ⚙️
الأوامر الخارجية🌐
الوصول إلى الشبكة📁
الوصول إلى نظام الملفات🔑
متغيرات البيئة
Проектирование поддерживаемой архитектуры программного обеспечения
متاح أيضًا من: Dwsy
Проекты программного обеспечения часто страдают от плохой архитектуры, что приводит к техническому долгу и замедлению разработки. Этот навык проведет вас через структурированный сократический процесс проектирования систем Clean/Hexagonal Architecture с четкими границами, тестируемыми компонентами и документированными решениями.
يدعم: Claude Codex Code(CC)
1
تنزيل ZIP المهارة
2
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
3
فعّل وابدأ الاستخدام
اختبرها
استخدام "system-design". Design a payment processing service using Clean Architecture
النتيجة المتوقعة:
- Phase 1: Discovery Questions
- Who is the primary user (merchant, customer, internal system)?
- What payment methods must be supported?
- What are the regulatory constraints?
- How do you define success for this service?
- Key insight: Start by understanding the problem before defining solutions.
استخدام "system-design". Help me understand ports and adapters
النتيجة المتوقعة:
- Ports are interfaces defining interaction boundaries
- Inbound ports: What the application offers to the outside world
- Outbound ports: What the application needs from external systems
- Adapters implement these ports for specific technologies
- Example: HTTP controller is a driving adapter, database repository is a driven adapter
التدقيق الأمني
آمنv5 • 1/16/2026
Pure documentation skill containing only markdown guides and TypeScript code templates for software architecture patterns. All 553 static findings are false positives caused by the analyzer misclassifying markdown code formatting (backticks), educational algorithm references, and import path examples as executable code. No network calls, file system access, command execution, or credential handling exists in this skill.
19
الملفات التي تم فحصها
5,015
الأسطر التي تم تحليلها
4
النتائج
5
إجمالي عمليات التدقيق
عوامل الخطر
⚙️ الأوامر الخارجية (269)
references/clean-architecture.md:7-24 references/clean-architecture.md:24-35 references/clean-architecture.md:35-56 references/clean-architecture.md:56-65 references/clean-architecture.md:65-90 references/clean-architecture.md:90-99 references/clean-architecture.md:99-115 references/clean-architecture.md:115-135 references/clean-architecture.md:135-154 references/clean-architecture.md:154-191 references/common-mistakes.md:9-22 references/common-mistakes.md:22-33 references/common-mistakes.md:33-58 references/common-mistakes.md:58-64 references/common-mistakes.md:64-87 references/common-mistakes.md:87-98 references/common-mistakes.md:98-131 references/common-mistakes.md:131-137 references/common-mistakes.md:137-151 references/common-mistakes.md:151-161 references/common-mistakes.md:161-187 references/common-mistakes.md:187-193 references/common-mistakes.md:193-214 references/common-mistakes.md:214-225 references/common-mistakes.md:225-268 references/common-mistakes.md:268-274 references/common-mistakes.md:274-283 references/common-mistakes.md:283-294 references/common-mistakes.md:294-314 references/common-mistakes.md:314-322 references/common-mistakes.md:322-329 references/common-mistakes.md:329-339 references/common-mistakes.md:339-351 references/common-mistakes.md:351-357 references/common-mistakes.md:357-371 references/common-mistakes.md:371-384 references/common-mistakes.md:384-394 references/dependency-inversion.md:10-20 references/dependency-inversion.md:20-29 references/dependency-inversion.md:29-56 references/dependency-inversion.md:56-61 references/dependency-inversion.md:61-64 references/dependency-inversion.md:64-67 references/dependency-inversion.md:67-70 references/dependency-inversion.md:70-78 references/dependency-inversion.md:78-86 references/dependency-inversion.md:86-95 references/dependency-inversion.md:95-119 references/dependency-inversion.md:119-125 references/dependency-inversion.md:125-142 references/dependency-inversion.md:142-146 references/dependency-inversion.md:146-171 references/dependency-inversion.md:171-179 references/dependency-inversion.md:179-197 references/dependency-inversion.md:197-216 references/dependency-inversion.md:216-228 references/dependency-inversion.md:228-232 references/dependency-inversion.md:232-242 references/dependency-inversion.md:242-246 references/dependency-inversion.md:246-255 references/domain-modeling.md:13-34 references/domain-modeling.md:34-40 references/domain-modeling.md:40-67 references/domain-modeling.md:67-73 references/domain-modeling.md:73-99 references/domain-modeling.md:99-111 references/domain-modeling.md:111-138 references/domain-modeling.md:138-144 references/domain-modeling.md:144-156 references/domain-modeling.md:156-169 references/domain-modeling.md:169-175 references/domain-modeling.md:175-181 references/domain-modeling.md:181-185 references/domain-modeling.md:185-191 references/domain-modeling.md:191-199 references/domain-modeling.md:199-205 references/domain-modeling.md:205-214 references/domain-modeling.md:214-251 references/domain-modeling.md:251-279 references/domain-modeling.md:279-283 references/domain-modeling.md:283-299 references/domain-modeling.md:299-303 references/domain-modeling.md:303-313 references/hexagonal-architecture.md:15-48 references/hexagonal-architecture.md:48-58 references/hexagonal-architecture.md:58-65 references/hexagonal-architecture.md:65-71 references/hexagonal-architecture.md:71-83 references/hexagonal-architecture.md:83-93 references/hexagonal-architecture.md:93-112 references/hexagonal-architecture.md:112-115 references/hexagonal-architecture.md:115-121 references/hexagonal-architecture.md:121-154 references/hexagonal-architecture.md:154-158 references/hexagonal-architecture.md:158-162 references/hexagonal-architecture.md:162-181 references/hexagonal-architecture.md:181-200 references/hexagonal-architecture.md:200-206 references/hexagonal-architecture.md:206 references/hexagonal-architecture.md:206-207 references/hexagonal-architecture.md:207 references/hexagonal-architecture.md:207 references/hexagonal-architecture.md:207-208 references/hexagonal-architecture.md:208 references/hexagonal-architecture.md:208-209 references/hexagonal-architecture.md:209 references/hexagonal-architecture.md:209-214 references/hexagonal-architecture.md:214-215 references/hexagonal-architecture.md:215-222 references/hexagonal-architecture.md:222-223 references/hexagonal-architecture.md:223-226 references/hexagonal-architecture.md:226-227 SKILL.md:30 SKILL.md:31 SKILL.md:32 SKILL.md:33 SKILL.md:66 SKILL.md:67 SKILL.md:68 SKILL.md:69 SKILL.md:70 SKILL.md:76 SKILL.md:77 SKILL.md:78 SKILL.md:79 SKILL.md:85 SKILL.md:87-89 SKILL.md:89-112 SKILL.md:112-122 templates/adr-template.md:5-11 templates/adr-template.md:11-15 templates/adr-template.md:15-117 templates/adr-template.md:117-121 templates/adr-template.md:121-201 templates/adr-template.md:201-202 templates/adr-template.md:202-203 templates/adr-template.md:203-204 templates/adr-template.md:204-239 templates/adr-template.md:239-250 templates/controller-template.md:5-21 templates/controller-template.md:21-25 templates/controller-template.md:25-85 templates/controller-template.md:85-175 templates/controller-template.md:175-181 templates/controller-template.md:181-223 templates/controller-template.md:223-227 templates/controller-template.md:227-262 templates/controller-template.md:262-266 templates/controller-template.md:266-291 templates/controller-template.md:291-295 templates/controller-template.md:295-378 templates/entity-template.md:5-62 templates/entity-template.md:62-66 templates/entity-template.md:66-254 templates/entity-template.md:254-258 templates/entity-template.md:258-283 templates/entity-template.md:283-287 templates/entity-template.md:287-368 templates/port-adapter-interface.md:5-44 templates/port-adapter-interface.md:44-48 templates/port-adapter-interface.md:48-66 templates/port-adapter-interface.md:66-70 templates/port-adapter-interface.md:70-103 templates/port-adapter-interface.md:103-107 templates/port-adapter-interface.md:107-116 templates/port-adapter-interface.md:116-120 templates/port-adapter-interface.md:120-133 templates/port-adapter-interface.md:133-137 templates/port-adapter-interface.md:137-150 templates/port-adapter-interface.md:154-194 templates/port-adapter-interface.md:194-198 templates/port-adapter-interface.md:198-268 templates/port-adapter-interface.md:268-272 templates/port-adapter-interface.md:272-304 templates/repository-template.md:5-22 templates/repository-template.md:22-28 templates/repository-template.md:28-50 templates/repository-template.md:50-54 templates/repository-template.md:54-81 templates/repository-template.md:88-144 templates/repository-template.md:146-185 templates/repository-template.md:186-207 templates/repository-template.md:207-211 templates/repository-template.md:211-260 templates/repository-template.md:260-264 templates/repository-template.md:264-330 templates/repository-template.md:330-336 templates/repository-template.md:336 templates/repository-template.md:336-337 templates/repository-template.md:337 templates/repository-template.md:337-338 templates/repository-template.md:338 templates/repository-template.md:338-339 templates/repository-template.md:339 templates/repository-template.md:339-340 templates/repository-template.md:340 templates/repository-template.md:340-341 templates/repository-template.md:341 templates/repository-template.md:341-345 templates/repository-template.md:345-371 templates/ts-hexagonal-scaffold.md:5-69 templates/ts-hexagonal-scaffold.md:69-73 templates/ts-hexagonal-scaffold.md:73-86 templates/ts-hexagonal-scaffold.md:86-90 templates/ts-hexagonal-scaffold.md:90-108 templates/ts-hexagonal-scaffold.md:108-112 templates/ts-hexagonal-scaffold.md:112-152 templates/ts-hexagonal-scaffold.md:152-158 templates/ts-hexagonal-scaffold.md:158-169 templates/ts-hexagonal-scaffold.md:169-173 templates/ts-hexagonal-scaffold.md:173-204 templates/ts-hexagonal-scaffold.md:204-208 templates/ts-hexagonal-scaffold.md:208-231 templates/use-case-template.md:5-46 templates/use-case-template.md:46-50 templates/use-case-template.md:50-157 templates/use-case-template.md:157-161 templates/use-case-template.md:161-260 templates/use-case-template.md:260-264 templates/use-case-template.md:264-307 templates/value-object-template.md:12-47 templates/value-object-template.md:47-51 templates/value-object-template.md:51-133 templates/value-object-template.md:133-145 templates/value-object-template.md:145-150 templates/value-object-template.md:150-154 templates/value-object-template.md:154-170 templates/value-object-template.md:170-192 templates/value-object-template.md:192-196 templates/value-object-template.md:196-246 templates/value-object-template.md:246-249 templates/value-object-template.md:249-253 templates/value-object-template.md:253-319 templates/value-object-template.md:319-323 templates/value-object-template.md:323-398 workflows/01-discovery.md:55-75 workflows/01-discovery.md:75-85 workflows/02-modeling.md:55-68 workflows/02-modeling.md:68-100 workflows/02-modeling.md:100-120 workflows/02-modeling.md:120-131 workflows/03-boundaries.md:12-39 workflows/03-boundaries.md:39-82 workflows/03-boundaries.md:82-94 workflows/03-boundaries.md:94-102 workflows/03-boundaries.md:102 workflows/03-boundaries.md:102-103 workflows/03-boundaries.md:103 workflows/03-boundaries.md:103-104 workflows/03-boundaries.md:104 workflows/03-boundaries.md:104-125 workflows/03-boundaries.md:125-146 workflows/03-boundaries.md:146-157 workflows/04-scaffolding.md:16-23 workflows/04-scaffolding.md:23-29 workflows/04-scaffolding.md:29-70 workflows/04-scaffolding.md:70-91 workflows/04-scaffolding.md:91-92 workflows/04-scaffolding.md:92-93 workflows/04-scaffolding.md:93-94 workflows/04-scaffolding.md:94-95 workflows/04-scaffolding.md:95-96 workflows/04-scaffolding.md:96-125 workflows/04-scaffolding.md:125-130 workflows/04-scaffolding.md:130-142 workflows/04-scaffolding.md:142-163 workflows/04-scaffolding.md:163-165 workflows/04-scaffolding.md:165-171 workflows/04-scaffolding.md:171-179
🌐 الوصول إلى الشبكة (8)
📁 الوصول إلى نظام الملفات (116)
skill-report.json:6 templates/controller-template.md:8 templates/controller-template.md:8 templates/controller-template.md:8 templates/controller-template.md:33 templates/controller-template.md:33 templates/controller-template.md:33 templates/controller-template.md:230 templates/controller-template.md:230 templates/controller-template.md:270 templates/controller-template.md:270 templates/controller-template.md:300 templates/controller-template.md:300 templates/controller-template.md:300 templates/entity-template.md:8 templates/entity-template.md:9 templates/entity-template.md:10 templates/entity-template.md:69 templates/entity-template.md:71 templates/entity-template.md:72 templates/entity-template.md:292 templates/port-adapter-interface.md:8 templates/port-adapter-interface.md:8 templates/port-adapter-interface.md:8 templates/port-adapter-interface.md:51 templates/port-adapter-interface.md:51 templates/port-adapter-interface.md:51 templates/port-adapter-interface.md:73 templates/port-adapter-interface.md:73 templates/port-adapter-interface.md:73 templates/port-adapter-interface.md:110 templates/port-adapter-interface.md:110 templates/port-adapter-interface.md:110 templates/port-adapter-interface.md:140 templates/port-adapter-interface.md:140 templates/port-adapter-interface.md:141 templates/port-adapter-interface.md:141 templates/port-adapter-interface.md:207 templates/port-adapter-interface.md:207 templates/port-adapter-interface.md:207 templates/port-adapter-interface.md:275 templates/port-adapter-interface.md:275 templates/port-adapter-interface.md:275 templates/repository-template.md:8 templates/repository-template.md:8 templates/repository-template.md:8 templates/repository-template.md:31 templates/repository-template.md:31 templates/repository-template.md:31 templates/repository-template.md:58 templates/repository-template.md:58 templates/repository-template.md:59 templates/repository-template.md:59 templates/repository-template.md:221 templates/repository-template.md:221 templates/repository-template.md:221 templates/repository-template.md:267 templates/repository-template.md:267 templates/repository-template.md:267 templates/repository-template.md:268 templates/repository-template.md:268 templates/repository-template.md:268 templates/repository-template.md:204 templates/ts-hexagonal-scaffold.md:78 templates/ts-hexagonal-scaffold.md:81 templates/ts-hexagonal-scaffold.md:82 templates/ts-hexagonal-scaffold.md:85 templates/ts-hexagonal-scaffold.md:114 templates/ts-hexagonal-scaffold.md:115 templates/ts-hexagonal-scaffold.md:116 templates/ts-hexagonal-scaffold.md:117 templates/ts-hexagonal-scaffold.md:175 templates/ts-hexagonal-scaffold.md:175 templates/ts-hexagonal-scaffold.md:192 templates/ts-hexagonal-scaffold.md:192 templates/use-case-template.md:8 templates/use-case-template.md:8 templates/use-case-template.md:8 templates/use-case-template.md:9 templates/use-case-template.md:9 templates/use-case-template.md:53 templates/use-case-template.md:53 templates/use-case-template.md:53 templates/use-case-template.md:54 templates/use-case-template.md:54 templates/use-case-template.md:54 templates/use-case-template.md:55 templates/use-case-template.md:55 templates/use-case-template.md:166 templates/use-case-template.md:166 templates/use-case-template.md:166 templates/use-case-template.md:167 templates/use-case-template.md:167 templates/use-case-template.md:167 templates/use-case-template.md:168 templates/use-case-template.md:168 templates/use-case-template.md:168 templates/use-case-template.md:169 templates/use-case-template.md:169 templates/use-case-template.md:169 templates/use-case-template.md:170 templates/use-case-template.md:170 templates/use-case-template.md:170 templates/use-case-template.md:267 templates/use-case-template.md:267 templates/use-case-template.md:267 templates/use-case-template.md:268 templates/use-case-template.md:268 templates/use-case-template.md:268 workflows/04-scaffolding.md:91 workflows/04-scaffolding.md:92 workflows/04-scaffolding.md:93 workflows/04-scaffolding.md:94 workflows/04-scaffolding.md:95 workflows/04-scaffolding.md:96 workflows/04-scaffolding.md:165
🔑 متغيرات البيئة (2)
تم تدقيقه بواسطة: claude عرض سجل التدقيق →
درجة الجودة
45
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
23
المجتمع
100
الأمان
91
الامتثال للمواصفات
ماذا يمكنك بناءه
Проектирование новых микросервисов
Проектирование новой архитектуры сервиса с четкими границами, изоляцией зависимостей и заменяемыми адаптерами
Документирование архитектурных решений
Создание ADRs, которые фиксируют контекст, компромиссы и последствия для согласования команды
Изучение паттернов чистой архитектуры
Понимание доменных сущностей, объектов-значений, агрегатов и того, как структурировать поддерживаемый код
جرّب هذه الموجهات
Новый дизайн системы
I need to architect [describe your system]. Start with Phase 1 Discovery.
Продолжение сессии
Continue from [phase name] for our existing architecture session.
Генерация каркаса
Generate a TypeScript hexagonal scaffold for a [entity name] feature with these decisions: [list known ports/adapters].
Обзор архитектуры
Review my current code structure and help me refactor to Clean Architecture. Here is my current file layout: [describe structure].
أفضل الممارسات
- Никогда не пропускайте фазу Discovery - понимание проблемы предотвращает дорогостоящие архитектурные ошибки
- Определяйте порты (интерфейсы) до реализаций - это обеспечивает инверсию зависимостей
- Документируйте решения как ADRs, пока контекст свеж - будущие разработчики будут благодарны
تجنب
- Прыгать к коду до понимания домена и определения ограниченных контекстов
- Размещать бизнес-логику в контроллерах или инфраструктуре вместо доменного слоя
- Использовать технологически-специфичные термины в доменных интерфейсах (утечка абстракций)
الأسئلة المتكررة
В чем разница между Clean и Hexagonal Architecture?
They share the same core principle (dependency inversion) but structure layers differently. Clean uses concentric circles; Hexagonal uses a hexagon with ports/adapters on each side.
Сколько времени занимает полная архитектурная сессия?
Полная сессия от Discovery до Scaffolding обычно занимает 1-2 часа в зависимости от сложности системы и требуемых решений пользователя.
Могу ли я использовать это с существующими проектами?
Да. Используйте определение границ и шаблоны ADRs для документирования текущей архитектуры, затем планируйте постепенный рефакторинг к более чистому разделению.
К каким данным имеет доступ этот навык?
Никакие. Этот навык читает только собственные файлы документации и генерирует текстовый/кодовый вывод. Нет доступа к вашим файлам проекта или системным данным.
Чем это отличается от генерации общего кода?
Этот навык сначала задает вопросы и генерирует каркас на основе решений пользователя. Он создает архитектурную структуру, не реализуя код.
Какие паттерны рекомендует этот навык?
Он представляет несколько вариантов с компромиссами (порты/адаптеры, внедрение зависимостей, доменные события, объекты-значения) и позволяет пользователям выбирать на основе их контекста.