docs: /version, Live-Status, korrekte Serverparameter in Doku
- README: /version, /plan, /continue, /cancel in Kommando-Tabelle ergänzt - README: --test-cmd/--test-timeout für /optimize dokumentiert - README: Live-Aktivitätsstatus-Tabelle mit Beispielen - README: Serverparameter korrigiert: -c 262144, -n 16384, --cache-type q4_0 - README: VRAM-Tabelle auf q4_0-Basis aktualisiert (256K-Zeile ergänzt) - BEDIENUNGSANLEITUNG: neuer Abschnitt 9 "Versionsverwaltung: /version" - BEDIENUNGSANLEITUNG: Dialog-Beispiele + Manifest-Update-Logik erklärt - BEDIENUNGSANLEITUNG: Live-Status-Hinweis in /optimize-Ablauf integriert - BEDIENUNGSANLEITUNG: Versionsbeispiel in Typische Anwendungsfälle Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
e13e9382ff
commit
8aadb317e5
2 changed files with 129 additions and 19 deletions
|
|
@ -16,9 +16,10 @@ einfache Slash-Kommandos in der pi-Agent-Oberfläche.
|
|||
6. [Automatischer Workflow: /optimize](#6-automatischer-workflow-optimize)
|
||||
7. [Kleine Änderungen: /patch und /quick_check](#7-kleine-änderungen-patch-und-quick_check)
|
||||
8. [Dokumentation generieren: /update_doku](#8-dokumentation-generieren-update_doku)
|
||||
9. [TASK.md verstehen und nutzen](#9-taskmd-verstehen-und-nutzen)
|
||||
10. [Typische Anwendungsfälle](#10-typische-anwendungsfälle)
|
||||
11. [Fehlermeldungen und Lösungen](#11-fehlermeldungen-und-lösungen)
|
||||
9. [Versionsverwaltung: /version](#9-versionsverwaltung-version)
|
||||
10. [TASK.md verstehen und nutzen](#10-taskmd-verstehen-und-nutzen)
|
||||
11. [Typische Anwendungsfälle](#11-typische-anwendungsfälle)
|
||||
12. [Fehlermeldungen und Lösungen](#12-fehlermeldungen-und-lösungen)
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -303,8 +304,12 @@ Phase 4: Runde 2/3: Judge prüft...
|
|||
✓ PASS WITH CONCERNS nach Runde 2
|
||||
Finale ShipIt-Prüfung...
|
||||
→ SHIP
|
||||
[Dialog: Version → v0.1.0 (empfohlen)]
|
||||
```
|
||||
|
||||
Während des Ablaufs zeigt die Statuszeile immer die aktuelle Aktivität:
|
||||
`Coder implementiert…` → `Editiere src/main.rs…` → `Git-Commit…` → `Judge reviewt (Runde 1/3)…`
|
||||
|
||||
### Beispiel: mehr Runden
|
||||
|
||||
```
|
||||
|
|
@ -476,7 +481,79 @@ Führt nach SHIP automatisch `/update_doku` aus.
|
|||
|
||||
---
|
||||
|
||||
## 9. TASK.md verstehen und nutzen
|
||||
## 9. Versionsverwaltung: /version
|
||||
|
||||
pi_coder verwaltet Versionsnummern im SemVer-Format (`vMAJOR.MINOR.PATCH`) automatisch —
|
||||
basierend auf den Commit-Messages des generierten Codes.
|
||||
|
||||
### Wie Commit-Messages die Version bestimmen
|
||||
|
||||
Der Coder verwendet standardmäßig das Conventional-Commits-Format:
|
||||
|
||||
| Commit-Prefix | Beispiel | Bump-Typ |
|
||||
|---|---|---|
|
||||
| `feat!:` oder `BREAKING CHANGE` | `feat!: API komplett überarbeitet` | major (v1.0.0 → v2.0.0) |
|
||||
| `feat:` | `feat: CSV-Export hinzugefügt` | minor (v1.0.0 → v1.1.0) |
|
||||
| `fix:`, `chore:`, andere | `fix: Crash bei leerer Datei` | patch (v1.0.0 → v1.0.1) |
|
||||
|
||||
### Automatisch nach SHIP
|
||||
|
||||
Nach einem erfolgreichen SHIP-Verdikt in `/optimize` oder `/shipit` erscheint automatisch
|
||||
ein Dialog:
|
||||
|
||||
```
|
||||
┌─ Version ──────────────────────────────────────────────┐
|
||||
│ Aktuelle Version: v1.2.3. Commits seit letztem Tag: │
|
||||
│ minor-Bump erkannt. │
|
||||
│ │
|
||||
│ patch → v1.2.4 │
|
||||
│ minor → v1.3.0 (empfohlen) │
|
||||
│ major → v2.0.0 │
|
||||
│ Überspringen │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
Du kannst den empfohlenen Wert bestätigen oder manuell einen anderen wählen.
|
||||
|
||||
### Manuell aufrufen
|
||||
|
||||
```
|
||||
/version
|
||||
```
|
||||
|
||||
Nützlich wenn du den Tag nachträglich setzen möchtest oder nach manuellen Commits.
|
||||
|
||||
### Was passiert nach der Auswahl
|
||||
|
||||
1. Die Versionsnummer wird in die Projekt-Manifest-Datei geschrieben (falls vorhanden):
|
||||
- `package.json` → `npm version --no-git-tag-version X.Y.Z`
|
||||
- `Cargo.toml` → `version = "X.Y.Z"` in `[package]`
|
||||
- `pyproject.toml` → `version = "X.Y.Z"` in `[project]`
|
||||
- `VERSION` → Dateiinhalt `vX.Y.Z`
|
||||
2. Commit: `chore: bump version to vX.Y.Z`
|
||||
3. Git-Tag: `vX.Y.Z` wird gesetzt
|
||||
|
||||
Wenn keine der genannten Dateien vorhanden ist, wird nur der Git-Tag gesetzt.
|
||||
|
||||
### Erstes Mal — kein Tag vorhanden
|
||||
|
||||
```
|
||||
┌─ Version ──────────────────────────────────────────────┐
|
||||
│ Noch kein Versions-Tag vorhanden. │
|
||||
│ │
|
||||
│ patch → v0.0.1 │
|
||||
│ minor → v0.1.0 (empfohlen) │
|
||||
│ major → v1.0.0 │
|
||||
│ Überspringen │
|
||||
└─────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
Empfehlung: `v0.1.0` für ein frisches, funktionierendes Projekt; `v1.0.0` wenn es
|
||||
sofort produktionsreif ist.
|
||||
|
||||
---
|
||||
|
||||
## 10. TASK.md verstehen und nutzen
|
||||
|
||||
`TASK.md` ist die persistente Aufgabenbeschreibung im Projektverzeichnis. Sie wird von
|
||||
allen Kommandos als Referenz gelesen.
|
||||
|
|
@ -534,7 +611,7 @@ Die Checkboxen werden automatisch abgehakt:
|
|||
|
||||
---
|
||||
|
||||
## 10. Typische Anwendungsfälle
|
||||
## 11. Typische Anwendungsfälle
|
||||
|
||||
### Neues Rust-Programm von Null
|
||||
|
||||
|
|
@ -566,6 +643,17 @@ Die Checkboxen werden automatisch abgehakt:
|
|||
/quick_check
|
||||
```
|
||||
|
||||
### Versionsnummer nach der Entwicklung setzen
|
||||
|
||||
```bash
|
||||
# Nach SHIP: Dialog erscheint automatisch
|
||||
/optimize Neues Feature X --rounds 2
|
||||
# → SHIP → Dialog → "minor → v1.1.0" wählen → Tag gesetzt
|
||||
|
||||
# Oder manuell:
|
||||
/version
|
||||
```
|
||||
|
||||
### Kommentarlosen Legacy-Code dokumentieren
|
||||
|
||||
```bash
|
||||
|
|
@ -592,7 +680,7 @@ Die Checkboxen werden automatisch abgehakt:
|
|||
|
||||
---
|
||||
|
||||
## 11. Fehlermeldungen und Lösungen
|
||||
## 12. Fehlermeldungen und Lösungen
|
||||
|
||||
### "Modell-Datei nicht gefunden"
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue