AgentSkillsCN

dev:clarify

在第 2 阶段提出问题,以消除歧义

SKILL.md
--- frontmatter
name: dev:clarify
description: Poser questions pour lever ambiguités (Phase 2)
model: sonnet
allowed-tools: [AskUserQuestion, Read]
version: 1.0.0
license: MIT

Configuration de sortie

Instructions à Exécuter

IMPORTANT : Exécute ce workflow étape par étape :

IMPORTANT : Cette skill génère des questions structurées et nécessite un format de sortie spécifique.

Lis le frontmatter de cette skill. Si un champ output-style est présent, exécute immédiatement :

code
/output-style <valeur-du-champ>

Note : Une fois que le champ output-style sera supporté nativement par Claude Code, cette instruction pourra être supprimée.

Output-style requis : table-based

Objectif

Phase 2 du workflow de développement : identifier et résoudre toutes les ambiguités avant de designer l'architecture.

Instructions

1. Lire le contexte

  • Lire .claude/data/.dev-workflow-state.json pour la feature et les findings de l'exploration
  • Si le fichier n'existe pas ou phase 1 non complétée, rediriger vers /dev:explore

2. Analyser les zones d'ombre

Identifier les aspects sous-spécifiés dans les catégories suivantes :

Edge cases

  • Que se passe-t-il si X est vide/null ?
  • Comment gérer les cas limites ?

Gestion d'erreurs

  • Quelles erreurs peuvent survenir ?
  • Comment les communiquer à l'utilisateur ?

Points d'intégration

  • Comment cette feature interagit avec l'existant ?
  • Y a-t-il des dépendances circulaires à éviter ?

Rétrocompatibilité

  • Cette feature impacte-t-elle des fonctionnalités existantes ?
  • Y a-t-il des migrations de données nécessaires ?

Performance

  • Y a-t-il des contraintes de performance ?
  • Faut-il penser au caching ?

Sécurité

  • Quelles autorisations sont nécessaires ?
  • Y a-t-il des données sensibles à protéger ?

3. Présenter les questions

Utiliser AskUserQuestion pour présenter les questions de manière organisée

4. Attendre les réponses

⚠️ CRITIQUE : Ne PAS passer à la phase suivante avant d'avoir toutes les réponses.

5. Documenter les décisions

Mettre à jour le workflow state avec les réponses

Prochaine étape

code
✅ Clarifications complètes

Prochaine étape : /dev:design pour proposer des architectures

Règles

  • Ne PAS proposer d'architecture à ce stade
  • Ne PAS faire de suppositions - poser des questions
  • Documenter TOUTES les décisions prises