Skill: Feature-Konzept erstellen
Zweck
Ein Feature-Konzeptdokument erstellen, das die Feature-Idee vorstellt und das Problem erklärt, das es löst. Dies ist der erste Schritt im Feature-Vorschlagsprozess.
Wann verwenden
- Benutzer möchte ein neues Feature für crumbly, forester oder andere Forest-Crates vorschlagen
- Beginnen, eine Feature-Idee zu dokumentieren
- Das „Warum“ und „Was“ erklären, bevor die Anforderungen ausgearbeitet werden
Voraussetzungen
- Benutzer hat die Feature-Idee beschrieben
Vorgehen
0. Ideenschärfung anbieten (optional)
Fragen Sie den Benutzer:
Möchten Sie einen Ideenschärfungsprozess nutzen, um das Konzept klarer zu machen? Dabei werden Fragen nacheinander durchgearbeitet, um Unklarheiten und Designaspekte zu erkunden.
Falls ja, verwenden Sie den Skill idea-honing gemäß dem Protokoll in skills/README.md. Kehren Sie nach Abschluss der Ideenschärfung zu diesem Skill zurück.
1. Feature-Nummer ermitteln
Finden Sie die nächste verfügbare Feature-Nummer:
ls -1d ./docs/features/[0-9][0-9][0-9][0-9]-* 2>/dev/null | tail -1
Falls keine Features existieren, beginnen Sie mit 0001. Andernfalls erhöhen Sie die letzte Nummer um eins.
2. Feature-Namen erstellen
Arbeiten Sie mit dem Benutzer zusammen, um einen prägnanten, beschreibenden Namen zu finden:
- Kleinbuchstaben mit Bindestrichen verwenden
- Kurz halten (2-4 Wörter)
- Beschreibend sein
Beispiel: semantic-search, registry-management, skill-validation
3. Auf Ideenschärfungsdokument prüfen
ls ./planning/NNNN-feature-name/idea-honing.md 2>/dev/null
Falls vorhanden, beim Schreiben des Konzepts darauf Bezug nehmen. Die Fragen und Antworten liefern wertvolles Material für die Erzählung.
4. Feature-Verzeichnis erstellen
mkdir -p ./docs/features/NNNN-feature-name
Ersetzen Sie NNNN durch die vierstellige Nummer und feature-name durch den vereinbarten Namen.
5. Konzeptvorlage kopieren
cp ./docs/features/0000-templates/concept.md ./docs/features/NNNN-feature-name/
6. Konzeptdokument ausfüllen
Arbeiten Sie mit dem Benutzer zusammen, um concept.md als Erzählung zu vervollständigen:
Frontmatter
feature:aufNNNN-feature-namesetzenstatus:aufproposedsetzen- Optional
tracking-issue:hinzufügen, falls zutreffend
Problemabschnitt
- Ein Bild der aktuellen Situation zeichnen
- Den dadurch verursachten Schmerz beschreiben
- Erklären, warum dies wichtig ist
Lösungsabschnitt
- Beschreiben, was die Benutzer erleben werden
- Fokus auf „Was“ und „Warum“, nicht auf „Wie“
- Erzählend bleiben, keine Liste
Abschnitt „Wie es funktioniert“
- Die Geschichte der Nutzung des Features erzählen
- Natürlich durch den Arbeitsablauf gehen
- Echte Nutzung zeigen, keine abstrakten Schritte
Nutzenabschnitt
- Den gebotenen Wert erklären
- Auf das Problem zurückführen
- Zeigen, was möglich wird
Abschnitt „Technische Hinweise“
- Kurze Einschränkungen oder Überlegungen
- Kurz halten – Details kommen in design.md
7. Auf erzählerischen Fluss prüfen
Stellen Sie sicher, dass das Dokument:
- Wie eine Geschichte und nicht wie eine Spezifikation wirkt
- Aufzählungspunkte und nummerierte Listen vermeidet, wo möglich
- Fokus auf Benutzererfahrung und Wert legt
- Das „Warum“ vor dem „Was“ erklärt
Validierung
Überprüfen Sie, ob das Konzept korrekt erstellt wurde:
# Prüfen, ob das Verzeichnis existiert
ls -la ./docs/features/NNNN-feature-name/
# Prüfen, ob die Konzeptdatei existiert
ls ./docs/features/NNNN-feature-name/concept.md
# Prüfen, ob Inhalt vorhanden ist
cat ./docs/features/NNNN-feature-name/concept.md
Häufige Probleme
Zu technisch: Falls das Konzept wie ein Designdokument wirkt, Fokus auf Problem und Benutzererfahrung lenken.
Zu abstrakt: Falls das Konzept vage ist, mit dem Benutzer konkrete Beispiele für den Schmerzpunkt hinzufügen.
Zu listenlastig: Bei vielen Aufzählungspunkten in Erzählprosa umschreiben.
Nächste Schritte
Nach der Erstellung des Konzepts:
- Erzählung überprüfen und verfeinern
- Rückmeldung einholen, ob das Feature wertvoll ist
- Sobald das Konzept solide ist, mit den Anforderungen fortfahren, indem Sie den Skill
propose-feature-requirementsverwenden