Contribuer¶

Prérequis¶

Python 3.11+
gestionnaire de paquets uv
Git

Développement local¶

# Clone the repository
git clone https://github.com/Zts0hg/codexspec.git
cd codexspec

# Install development dependencies
uv sync --extra dev

# Run locally
uv run codexspec --help

# Run tests
uv run pytest

# Lint code
uv run ruff check src/

Documentation¶

# Install docs dependencies
uv sync --extra dev --extra docs

# Preview documentation locally
uv run mkdocs serve

# Build documentation
uv run mkdocs build --strict

Build¶

uv build

Processus de pull request¶

Forkez le dépôt
Créez une branche de fonctionnalité
Effectuez vos modifications
Lancez les tests et le linting
Soumettez une pull request

Style de code¶

Longueur de ligne : 120 caractères maximum
Suivre PEP 8
Utiliser des indications de type pour les fonctions publiques

Avant de modifier les modèles, le packaging ou l'initialisation, lisez CLAUDE.md, AGENTS.md et Organisation du dépôt. Les copies distribuées des commandes et des compétences sont des artefacts d'installation générés ; modifiez leurs sources faisant autorité, puis régénérez-les.