junjiang858/agent-project-kit

Que fait agent-project-kit ?

Une compétence Codex pour mener des projets logiciels assistés par IA, de l'idée vague à la livraison vérifiée.

Aperçu

Ce kit permet à un agent Codex de gérer un projet logiciel de manière proactive, en le décomposant en phases structurées :

• Phase 1 : Exploration – Clarifier le besoin, poser des questions et définir le périmètre du projet.
• Phase 2 : Planification – Créer un plan de projet détaillé, des user stories et une liste de tâches.
• Phase 3 : Implémentation – Coder les fonctionnalités selon le plan, en suivant les bonnes pratiques.
• Phase 4 : Test – Écrire et exécuter des tests automatisés pour valider le bon fonctionnement.
• Phase 5 : Vérification – Vérifier que la livraison est complète et fonctionnelle, et générer un rapport de synthèse.

Utilisation

Pour utiliser ce skill, placez-le dans le répertoire .agent ou .skills de votre projet, puis exécutez Codex avec l'instruction initiale correspondante.

Exemple d'instruction :

Utilise le skill agent-project-kit pour m'aider à développer [description de votre idée].

L'agent commencera par la phase d'exploration, en vous posant des questions pour préciser le besoin.

Prérequis

• Plateforme : Codex (ou agent compatible avec les skills markdown)
• Environnement : Node.js / Python / tout langage supporté par votre projet
• Dépendances : Aucune dépendance externe ; le skill s'appuie sur les capacités de l'agent.

Phases détaillées

Phase 1 : Exploration

L'agent pose des questions pour clarifier :

• Quel est le problème à résoudre ?
• Quelles sont les fonctionnalités essentielles ?
• Quel est le public cible ?
• Quelles contraintes techniques (langage, framework, plateforme) ?

Phase 2 : Planification

L'agent génère :

• Un fichier PLAN.md décrivant l'architecture et les étapes.
• Une liste de tâches dans TASKS.md.
• Des user stories dans STORIES.md.

Phase 3 : Implémentation

L'agent crée le code en suivant le plan, commit par commit, en produisant une fonctionnalité testable à chaque étape.

Phase 4 : Test

L'agent écrit des tests unitaires et d'intégration, les exécute et corrige les échecs jusqu'à ce que tous les tests passent.

Phase 5 : Vérification

L'agent vérifie que :

• Toutes les tâches sont marquées comme terminées.
• Tous les tests passent.
• La documentation est à jour.
• Un rapport de livraison (REPORT.md) est généré.

Dépannage

Si l'agent semble bloqué, vous pouvez lui demander de passer à la phase suivante ou de reformuler le plan. Utilisez des instructions claires et précises.

Licence

Ce projet est sous licence MIT.