أسلوب الكود

أسلوب الكود

Python

• Python 3.11+
• تلميحات الأنواع مطلوبة
• طول السطر: 100 حرف
• المُنسِّق: Ruff
• الفاحص النصّي: Ruff + MyPy

الاستيرادات

# Standard library first
import asyncio
from pathlib import Path

# Third-party
import yaml
import aiosqlite

# Local
from kazma_core.hub.manifest_schema import SkillManifest

تلميحات الأنواع

async def process(message: str, agent_id: str | None = None) -> dict:
    ...

def parse_skill_id(skill_id: str) -> tuple[str, str, str]:
    ...

YAML

• إزاحة بمقدار مسافتين
• kebab-case للمفاتيح
• لا مسافات زائدة في نهايات الأسطر

TypeScript/React

• مكوّنات دالّية (functional components)
• وضع TypeScript الصارم (strict)
• وحدات CSS للتنسيق