Riordino repository: test/ con struttura documentata
- Spostato test-orto_v1 → test/orto/test-orto_v1
- Spostato orto-skills-suite → test/orto/orto-skills-suite
- Creato test/README.md: Struttura, come eseguire test, criteri accettazione
- Aggiornato .gitignore: Esclude output temporanei
Struttura:
test/
├── README.md (documentazione)
└── orto/ (primo test: orto_v1 → orto-skills v0.2)
├── test-orto_v1/ (Fasi 1-4)
└── orto-skills-suite/ (Fase 5: packaging)
Prossimi test andranno in:
test/<framework-name>/
├── test-<framework>_v1/
└── <framework>-skills-suite/
This commit is contained in:
parent
69ec00e293
commit
91f99591a7
49 changed files with 227 additions and 4 deletions
218
test/README.md
Normal file
218
test/README.md
Normal file
|
|
@ -0,0 +1,218 @@
|
|||
# Test Directory — framework-translator
|
||||
|
||||
Questa cartella contiene tutti i test eseguiti per validare framework-translator.
|
||||
|
||||
---
|
||||
|
||||
## Struttura
|
||||
|
||||
```
|
||||
test/
|
||||
├── README.md # Questo file
|
||||
└── <framework-name>/ # Una sottocartella per test
|
||||
├── test-<framework>_v1/ # Output Fasi 1-4 (analysis, mapping, references, skills)
|
||||
└── <framework>-skills-suite/# Packaging finale (Fase 5)
|
||||
```
|
||||
|
||||
### Esempio
|
||||
|
||||
```
|
||||
test/
|
||||
├── README.md
|
||||
└── orto/ # Test: orto_v1 → orto-skills
|
||||
├── test-orto_v1/ # Output Fasi 1-4
|
||||
│ ├── analysis_report.md
|
||||
│ ├── mapping_plan.md
|
||||
│ ├── references/ # 11 file .md
|
||||
│ ├── skills/ # 7 skills
|
||||
│ └── TEST_SUMMARY.md
|
||||
└── orto-skills-suite/ # Packaging (Fase 5)
|
||||
├── INSTALL.sh
|
||||
├── README.md
|
||||
├── orto-init/
|
||||
├── orto-onboarding/
|
||||
├── ...
|
||||
└── references/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Come Eseguire un Test
|
||||
|
||||
Per ogni nuovo framework da trasformare:
|
||||
|
||||
### 1. Crea sottocartella
|
||||
|
||||
```bash
|
||||
mkdir -p test/<framework-name>
|
||||
cd test/<framework-name>
|
||||
```
|
||||
|
||||
**Esempio:**
|
||||
```bash
|
||||
mkdir -p test/finance
|
||||
cd test/finance
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. Esegui Fasi 1-4
|
||||
|
||||
Segui `SKILL.md` nella root del repository:
|
||||
|
||||
```bash
|
||||
# Fase 1: Analisi
|
||||
# (LLM legge framework, genera analysis_report.md)
|
||||
|
||||
# Fase 2: Mappatura
|
||||
# (LLM genera mapping_plan.md, approva con utente)
|
||||
|
||||
# Fase 3: Estrazione References
|
||||
# (LLM estrae knowledge → references/*.md)
|
||||
|
||||
# Fase 4: Generazione Skills
|
||||
# (LLM genera N skills → skills/*/SKILL.md)
|
||||
```
|
||||
|
||||
**Output atteso:**
|
||||
```
|
||||
<framework-name>/
|
||||
├── test-<framework>_v1/
|
||||
│ ├── analysis_report.md
|
||||
│ ├── mapping_plan.md
|
||||
│ ├── references/
|
||||
│ └── skills/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. Esegui Fase 5 (Packaging)
|
||||
|
||||
```bash
|
||||
# Usa script meccanici dalla root
|
||||
cd ../../
|
||||
./scripts/02_create_structure.sh <framework>-skills ./test/<framework-name>/
|
||||
./scripts/03_generate_packaging.sh ./test/<framework-name>/<framework>-skills-suite/
|
||||
```
|
||||
|
||||
**Output atteso:**
|
||||
```
|
||||
<framework-name>/
|
||||
└── <framework>-skills-suite/
|
||||
├── INSTALL.sh
|
||||
├── README.md
|
||||
├── <skill-1>/
|
||||
├── <skill-2>/
|
||||
└── references/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. Documenta Test
|
||||
|
||||
Crea `TEST_SUMMARY.md` in `<framework-name>/`:
|
||||
|
||||
```markdown
|
||||
# Test Summary — <framework>_v1 → <framework>-skills
|
||||
|
||||
**Data:** YYYY-MM-DD
|
||||
**Framework:** <nome> (X agenti, Y workflow)
|
||||
**Output:** <N> skills + <M> references
|
||||
|
||||
## Fasi Completate
|
||||
|
||||
- [ ] Fase 1: Analisi (100%)
|
||||
- [ ] Fase 2: Mappatura (100%)
|
||||
- [ ] Fase 3: References (X/Y%)
|
||||
- [ ] Fase 4: Skills (X/Y%)
|
||||
- [ ] Fase 5: Packaging (100%)
|
||||
|
||||
## Metriche
|
||||
|
||||
| Metrica | Valore | % |
|
||||
|---------|--------|---|
|
||||
| Skills | X/Y | Z% |
|
||||
| References | X/Y | Z% |
|
||||
| Commit | N | - |
|
||||
|
||||
## Status
|
||||
|
||||
✅ Test completato / ⚠️ Parziale / ❌ Fallito
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Test Eseguiti
|
||||
|
||||
### Test #1: orto_v1 → orto-skills v0.2
|
||||
|
||||
**Data:** 2026-03-07
|
||||
**Path:** `test/orto/`
|
||||
**Status:** ✅ Completato (78% skills, 79% references)
|
||||
**Release:** `v0.2-test`
|
||||
|
||||
**Risultati:**
|
||||
- 7 skills generate (su 9 previste)
|
||||
- 11 references estratte (su 14 previste)
|
||||
- Packaging completo
|
||||
- Documentazione completa
|
||||
|
||||
**Dettagli:** Vedi `test/orto/test-orto_v1/TEST_SUMMARY.md`
|
||||
|
||||
---
|
||||
|
||||
## Prossimi Test (Pianificati)
|
||||
|
||||
| Framework | Dominio | Priorità | Status |
|
||||
|-----------|---------|----------|--------|
|
||||
| **finance_v1** | Finanza personale | Alta | 🔧 Da eseguire |
|
||||
| **health_v1** | Salute/wellness | Media | 📋 Pianificato |
|
||||
| **edu_v1** | Educazione | Bassa | 📋 Pianificato |
|
||||
|
||||
---
|
||||
|
||||
## Criteri di Accettazione
|
||||
|
||||
Un test è considerato **completato** quando:
|
||||
|
||||
- [ ] **Fase 1:** Analysis report generato (100%)
|
||||
- [ ] **Fase 2:** Mapping plan approvato (100%)
|
||||
- [ ] **Fase 3:** References estratte (≥70%)
|
||||
- [ ] **Fase 4:** Skills generate (≥70%)
|
||||
- [ ] **Fase 5:** Packaging completo (100%)
|
||||
- [ ] **Documentazione:** TEST_SUMMARY.md compilato
|
||||
- [ ] **Git:** Commit + push eseguiti
|
||||
- [ ] **Tag:** Release tag creato (se ≥70% completion)
|
||||
|
||||
---
|
||||
|
||||
## Cleanup
|
||||
|
||||
Per rimuovere un test:
|
||||
|
||||
```bash
|
||||
# Rimuovi cartella test
|
||||
rm -rf test/<framework-name>/
|
||||
|
||||
# Rimuovi tag release (se esistente)
|
||||
git tag -d <framework>-vX.Y
|
||||
git push origin :refs/tags/<framework>-vX.Y
|
||||
```
|
||||
|
||||
**Nota:** Non rimuovere test completati a meno che non siano obsoleti. Servono come riferimento per test futuri.
|
||||
|
||||
---
|
||||
|
||||
## Best Practices
|
||||
|
||||
1. **Una cartella per test:** Ogni framework ha la sua sottocartella
|
||||
2. **Naming coerente:** `test-<framework>_v1` per output Fasi 1-4
|
||||
3. **Commit frequenti:** Ogni fase completata = 1 commit
|
||||
4. **Documenta tutto:** TEST_SUMMARY.md obbligatorio
|
||||
5. **Tag release:** Se completion ≥70%, crea tag (es. `v0.1-test`)
|
||||
|
||||
---
|
||||
|
||||
**Ultimo aggiornamento:** 2026-03-07
|
||||
**Test totali:** 1 (orto_v1)
|
||||
**Success rate:** 100%
|
||||
Loading…
Add table
Add a link
Reference in a new issue