Was macht Fortschrittsbericht?
Berichterstattung ist eine deterministische Projektion. Starten, behalten, benachrichtigen oder pollten Sie niemals einen Agenten, nur um ihn zu warten.
Erfassen Sie nur fehlende Zuweisungen, Entscheidungen oder Blocker-Fakten.
Führen Sie die CLI aus dem Repository-Root aus: progress steht unten für python <skill dir>/scripts/progress.py
(.claude/skills/progress-report, .agents/skills/progress-report oder $CLAUDE_PLUGIN_ROOT/skills/progress-report).
Geben Sie jedes Mal den vollständigen Befehl ein. Verben geben eine Zeile aus (refresh gibt nichts aus); leiten Sie sie weiter.
Wann verwenden
- Eine Plan-Datei (Markdown mit
- [ ]/- [x]Einträgen) steuert die Arbeit: Plan-Modus, kein Spec Kit erforderlich. - Ein Spec-Kit-Feature hat
specs/<feature>/tasks.md: Feature-Modus; Workflow-Dateien werden gesammelt, wenn vorhanden.
Plan-Modus Schnellstart
progress hooks install --host claude(odercodex; fügen Sie--scope userfür eine Plugin-Installation hinzu) einmalig, für Modell, Aufwand, Kontext und Kind-Agenten. Überspringen Sie es, und Aufgaben werden trotzdem verfolgt.progress init --plan docs/plan.mderstellt.progress/plan/(siehe--name,--dir) und gibtbind=<nonce>aus; der nächste Hook bindet (hooks installgibt einen aus, wenn ein Bericht existiert).- Markieren Sie Aufgaben in der Plan-Datei als erledigt; der Bericht folgt. Progress schreibt niemals in den Plan.
progress statusgibt den einzeiligen Status aus; die Ansicht ist.progress/plan/.view/index.html.
Elemente behalten eine geschriebene ID (T001); andere erhalten stabile P001... IDs. Bei nur einem aktiven Plan oder Feature ist kein Zielflag erforderlich; andernfalls übergeben Sie --plan NAME oder --feature DIR.
Verben
| Bedarf | Befehl |
|---|---|
| Bericht erstellen | progress init --plan PATH [--name N] [--dir D] oder progress init (Spec Kit) |
| Einzeiligen Status | progress status |
| Lane zuweisen | progress lane L1 --tasks P001-P004 --owner ID --harness H --model M --effort E |
| Lane schließen | progress lane L1 --close |
| Blocker | progress block P007 --by L2 (oder P003, ext:"text"); progress unblock B4 |
| Entscheidung | progress decide ask "Frage" --options a,b; progress decide made D2 b --by user |
| Notiz | progress note "Text" --target P005 |
| Export | progress export --format md |
| Hooks | `progress hooks install |
Regeln
- Erfassen Sie eine Lane, wenn Sie Arbeit zuweisen (
L#; Host-KinderC#erscheinen von selbst). Starts, Abschlüsse und Wiederholungen benötigen keinen Befehl. - Geben Sie niemals Geheimnisse, absolute Pfade oder Transkripttext in eine Notiz (maximal 200 Zeichen).
- Unbekannte Werte bleiben unbekannt. Schätzen Sie kein Modell, keinen Aufwand, keinen Kontext und keine Zeit.
- Fehler lesen sich als
progress: error CODE; beheben Sie die Ursache, wiederholen Sie es nicht in einer Schleife.
Details: references/verbs.md; Vertrag docs/contracts.md; Flags docs/commands.md.