quick-dev

Par chorus-aidlc · chorus

Workflow Tâche Rapide — ignore les étapes Idée→Proposition, crée les tâches directement, exécute et vérifie.

npx skills add https://github.com/chorus-aidlc/chorus --skill quick-dev

Quick Dev Skill

Contournez le pipeline AI-DLC complet (Idée → Élaboration → Proposition → Approbation) et créez des tâches directement. Idéal pour les petits travaux bien définis. L'objectif est que les agents enregistrent autonomiquement leur travail de développement et vérifient l'achèvement des tâches à travers des critères d'acceptation structurés.


Aperçu

Le flux AI-DLC standard assure la qualité par une planification structurée, mais ajoute une surcharge qui ralentit les petites tâches. Quick Dev offre une alternative légère :

[check admin role] → chorus_create_tasks → chorus_claim_task → in_progress → report → self-check AC → submit for verify → [self-verify if admin] → done

Utilisez Quick Dev quand :

  • Corrections de bugs avec étapes de reproduction claires
  • Petites fonctionnalités (< 2 story points)
  • Patches post-livraison et comblage de lacunes après l'achèvement des tâches d'une proposition
  • Tâches de prototype ou d'exploration
  • Hotfixes urgents qui ne peuvent pas attendre l'examen de la proposition

N'utilisez PAS Quick Dev quand :

  • La fonctionnalité nécessite un PRD ou un document de conception technique
  • Plusieurs tâches interdépendantes nécessitent une planification préalable
  • L'élaboration des stakeholders est nécessaire pour clarifier les exigences
  • Le travail impacte significativement l'architecture ou des composants partagés

Pour les travaux complexes, utilisez /idea + /proposal à la place.


Pré-vol : Vérification d'auto-vérification admin

Avant de créer des tâches, si chorus_checkin().agent.permissions.task inclut "admin", demandez à l'utilisateur :

« J'ai les privilèges d'admin. Après le développement, dois-je vérifier la tâche moi-même, ou la laisser à un autre admin pour vérification ? »

C'est important parce que les agents admin peuvent appeler chorus_admin_verify_task pour fermer la boucle autonomiquement. Si l'utilisateur approuve l'auto-vérification, vous pouvez compléter l'ensemble du cycle créer → développer → vérifier sans intervention humaine. Enregistrez la décision et appliquez-la à l'Étape 7.


Outils

Outil Objectif
chorus_create_tasks Créer une ou plusieurs tâches — omettez proposalUuid pour une Quick Task autonome, ou passez-le pour l'attacher à une proposition existante
chorus_update_task Éditer les champs de tâche (titre, description, priorité, AC, dépendances) ou changer le statut
chorus_claim_task Réclamer une tâche (open → assigned)
chorus_report_work Rapporter la progression avec mise à jour de statut optionnelle
chorus_report_criteria_self_check Auto-vérifier les critères d'acceptation avant de soumettre
chorus_submit_for_verify Soumettre pour vérification admin
chorus_admin_verify_task (admin seulement) Vérifier la tâche — utiliser quand l'auto-vérification est approuvée

Workflow

Étape 1 : Créer une Quick Task

acceptanceCriteriaItems est obligatoirechorus_create_tasks rejette toute tâche sans au moins un critère non vide (et rejette l'ensemble du lot si une tâche en manque). Ce sont aussi les fondements de l'auto-vérification à l'Étape 6. Écrivez des critères spécifiques et testables que vous pouvez vérifier objectivement après le développement. Les AC vagues comme « fonctionne correctement » vont à l'encontre de l'objectif ; préférez « retourne 200 sur GET /api/foo avec un token valide ».

chorus_create_tasks({
  projectUuid: "<project-uuid>",
  tasks: [{
    title: "Fix login redirect loop on Safari",
    description: "Safari loses session cookie after redirect...",
    priority: "high",
    storyPoints: 1,
    acceptanceCriteriaItems: [
      { description: "Login works on Safari 17+", required: true },
      { description: "Existing Chrome/Firefox behavior unchanged", required: true }
    ]
  }]
})

proposalUuid est optionnel :

  • Omettez pour les quick tasks autonomes (corrections de bugs, hotfixes, travail exploratoire)
  • Passez pour attacher la tâche à une proposition existante — utile pour le comblage de lacunes, les patches de suivi, ou la continuation du travail après la livraison des tâches initiales d'une proposition

Étape 2 : Réclamer la tâche

chorus_claim_task({ taskUuid: "<task-uuid>" })

Étape 3 : Éditer les détails (si nécessaire)

Utilisez chorus_update_task pour affiner la tâche après sa création. Les tâches ont toujours des AC (la création les demande), mais mettez-les à jour quand votre compréhension change pendant le développement. Passer acceptanceCriteriaItems remplace les critères de la tâche par l'ensemble fourni non vide ; omettez le champ pour les laisser inchangés (il ne peut pas être utilisé pour effacer les AC).

chorus_update_task({
  taskUuid: "<task-uuid>",
  description: "Updated with more details...",
  acceptanceCriteriaItems: [
    { description: "Login works on Safari 17+", required: true },
    { description: "Added CSRF token handling", required: true }
  ],
  addDependsOn: ["<other-task-uuid>"]
})

Étape 4 : Commencer le travail

chorus_update_task({ taskUuid: "<task-uuid>", status: "in_progress" })

Sub-agents : passez sessionUuid pour l'attribution :

chorus_update_task({ taskUuid: "<task-uuid>", status: "in_progress", sessionUuid: "<session-uuid>" })

Étape 5 : Rapporter la progression

chorus_report_work({
  taskUuid: "<task-uuid>",
  report: "Fixed Safari cookie issue:\n- Root cause: SameSite=Strict incompatible with redirect\n- Changed to SameSite=Lax\n- Commit: abc1234",
  sessionUuid: "<session-uuid>"
})

Étape 6 : Auto-vérifier les critères d'acceptation

chorus_report_criteria_self_check({
  taskUuid: "<task-uuid>",
  criteria: [
    { uuid: "<ac-uuid-1>", devStatus: "passed", devEvidence: "Tested on Safari 17.2" },
    { uuid: "<ac-uuid-2>", devStatus: "passed", devEvidence: "Chrome/Firefox regression tests pass" }
  ]
})

Étape 7 : Soumettre pour vérification (ou auto-vérifier)

chorus_submit_for_verify({
  taskUuid: "<task-uuid>",
  summary: "Fixed Safari login redirect loop. Changed SameSite cookie policy. All AC passed."
})

Auto-vérification admin : Si vous avez task: ["admin"] dans permissions et l'utilisateur a approuvé l'auto-vérification dans la vérification Pré-vol, vous pouvez vérifier la tâche vous-même immédiatement après la soumission :

chorus_admin_verify_task({ taskUuid: "<task-uuid>" })

Cela complète le cycle autonome complet : créer → développer → vérifier → fait.


Intégration des sessions

Les Quick Tasks fonctionnent avec les sub-agents Pi tout comme les tâches basées sur les propositions :

  • Team Lead : créez des quick tasks, puis assignez aux sub-agents via les UUIDs de tâche
  • Sub-agents : l'extension Chorus injecte automatiquement le contexte de session — passez simplement sessionUuid à chorus_update_task et chorus_report_work
  • Le cycle de vie de la session est entièrement automatisé par l'extension

Conseils

  • Gardez les Quick Tasks petites — si vous avez besoin de plus de 2-3 tâches, envisagez d'utiliser /proposal
  • Les critères d'acceptation sont obligatoires au moment de la créationchorus_create_tasks rejette les tâches sans eux. Ils sont votre contrat d'auto-vérification ; les AC spécifiques et testables permettent la vérification autonome et rendent l'ensemble du workflow autonome
  • Utilisez chorus_update_task pour affiner les tâches (y compris les AC) après la création plutôt que de les supprimer et recréer
  • Passez proposalUuid pour attacher les tâches de suivi ou de comblage de lacunes à une proposition existante — cela garde le travail connexe groupé dans le même contexte de projet et DAG
  • Les Quick Tasks apparaissent dans la même liste de tâches de projet et DAG que les tâches basées sur les propositions
  • Les agents admin peuvent exécuter l'ensemble du cycle de vie autonomiquement (créer → développer → auto-vérifier) — mais confirmez toujours avec l'utilisateur d'abord

Suivant

  • Pour les détails complets du cycle de vie des tâches, voir /develop
  • Pour la vérification admin, voir /review
  • Pour le flux de planification standard, voir /idea et /proposal
  • Pour l'aperçu de la plateforme, voir /chorus

Skills similaires