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

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


Aperçu

Le flux AI-DLC standard garantit 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 :

vérifier la permission explicite task:admin → créer/revendiquer → implémenter → auto-vérification AC → soumettre → examen indépendant → vérifier ou transférer

Utilisez Quick Dev quand :

  • Corrections de bugs avec étapes de reproduction claires
  • Petites fonctionnalités (< 2 story points)
  • Correctifs post-livraison et comblage de lacunes après l'achèvement des tâches d'une proposition
  • Tâches prototype ou exploratoires
  • 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 en amont
  • Une élaboration par les parties prenantes est nécessaire pour clarifier les exigences
  • Le travail impacte significativement l'architecture ou les composants partagés

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


Pré-vol : Vérification des permissions

Appelez chorus_checkin et inspectez les permissions effectives de l'agent actif. Définissez canVerifyTask à true uniquement quand chorus_checkin().agent.permissions.task contient explicitement "admin" (la permission task:admin).

Ne déduisez jamais l'autorité de vérification du nom de l'agent, de sa persona, de son étiquette preset/rôle, de sa propriété de tâche ou de la disponibilité des outils. Ne demandez pas s'il faut auto-vérifier : la permission explicite détermine le chemin terminal.


Outils

Outil Objectif
chorus_create_tasks Créer une ou plusieurs tâche(s) — omettez proposalUuid pour une Quick Task autonome, ou transmettez-le pour l'attacher à une proposition existante
chorus_update_task Modifier les champs de la tâche (titre, description, priorité, AC, dépendances) ou changer le statut
chorus_claim_task Revendiquer une tâche (open → assigned)
chorus_report_work Signaler la progression avec mise à jour de statut optionnelle
chorus_report_criteria_self_check Auto-vérifier les critères d'acceptation avant soumission
chorus_submit_for_verify Soumettre pour vérification admin
chorus_admin_verify_task (admin uniquement) Vérifier la tâche — utilisez 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 le lot entier si une tâche en manque). Ce sont aussi les fondations de l'auto-vérification à l'étape 6. Écrivez des critères spécifiques et testables que vous pouvez objectivement vérifier après le développement. Les AC vagues comme « fonctionne correctement » vont à l'encontre du but ; 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-le pour les quick tasks autonomes (corrections de bugs, hotfixes, travaux exploratoires)
  • Transmettez-le pour attacher la tâche à une proposition existante — utile pour le comblage de lacunes, les correctifs de suivi, ou la continuation du travail après la livraison des tâches initiales d'une proposition

Étape 2 : Revendiquer la tâche

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

Étape 3 : Modifier 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 exige), mais mettez-les à jour quand votre compréhension change pendant le développement. Transmettre 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 à travailler

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

Sub-agents : transmettez sessionUuid pour l'attribution :

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

Étape 5 : Signaler 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 et lancer un examen indépendant

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

La soumission n'est pas une vérification finale. Lancez l'agent task-reviewer requis avec subagent_spawn comme décrit dans /skill:develop, attendez-le, et lisez le plus récent commentaire Task VERDICT:. PASS et PASS WITH NOTES continuent. Sur FAIL, ne vérifiez ni ne transférez : corrigez tous les BLOCKER non résolus, répétez l'auto-vérification et la soumission des AC, puis lancez un examen indépendant frais.

Étape 8 : Vérification consciente des permissions

Avec task:admin explicite, après la réussite de chaque auto-vérification des AC requises et aucun BLOCKER non résolu dans l'examen indépendant, vérifiez et continuez de manière autonome :

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

Sans task:admin explicite, n'appelez pas l'outil admin. Publiez un commentaire riche en preuves sur la tâche contenant les résultats des AC, les preuves de test, le dernier verdict d'examen indépendant, et l'action exactement demandée. @mentionnez la personne responsable (préférez chorus_checkin().agent.owner) pour effectuer la vérification admin, puis terminez le tour actuel.

Ce transfert s'applique dans les sessions interactives et daemon headless. N'utilisez pas d'invite interactive, ne scrutez pas la réponse humaine, et ne vous fiez pas uniquement aux notifications génériques.


Intégration de session

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-les aux sub-agents via les UUID de tâche
  • Sub-agents : l'extension Chorus injecte automatiquement le contexte de session — transmettez juste 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. Ce sont votre contrat d'auto-vérification ; des 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
  • Transmettez proposalUuid pour attacher des tâches de suivi ou de comblage de lacunes à une proposition existante — cela garde le travail connexe regroupé 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 avec task:admin explicite continuent de manière autonome après la réussite des AC et de l'examen indépendant ; tous les autres utilisent le transfert humain asynchrone riche en preuves

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 un aperçu de la plateforme, voir /chorus

Skills similaires