Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.3.3

Cline

Usa il workflow Cline manual-envelope verificato con fasi esplicite di ispezione, scrittura su singolo file e validazione.

Contenuto: completeWorkflow: verified with limitations

TCAF 0.3.3 supporta Cline tramite il workflow manual-envelope verificato. L’invocazione nativa runner-to-Cline è pianificata separatamente e non deve essere presentata come disponibile.

Seleziona Cline

python install.py --adapter cline

Oppure forza l’adapter per una singola esecuzione:

tcaf task --target <progetto> --request "<task>" --adapter cline

Esegui il comando fuori da Cline. Avvia un nuovo task Cline, incolla la Run Envelope senza modificarla e aggiungi esattamente un marcatore di trasporto.

Marcatori di trasporto esatti

TCAF CLINE STEP: INSPECT
TCAF CLINE STEP: WRITE <percorso-relativo-al-repository>
TCAF CLINE STEP: VALIDATE
  • INSPECT è in sola lettura e autorizza elenco, ricerca e ispezione dei file pertinenti.
  • WRITE <percorso-relativo-al-repository> autorizza al massimo una scrittura sul file indicato e una conferma della scrittura in quel task Cline.
  • VALIDATE è in sola lettura e serve a revisionare i file correnti e i controlli riportati dal developer.

Il marcatore può restringere la Run Envelope. Non può ampliare target, perimetro, permessi o output.

Un task per ogni scrittura

Usa un nuovo task Cline per ogni file autorizzato. Dopo la scrittura:

  1. revisiona il file reale;
  2. conferma se la modifica prevista è avvenuta;
  3. fermati prima di autorizzare il file successivo;
  4. apri un nuovo task Cline con un nuovo marcatore WRITE quando viene approvato un altro file.

Non interpretare un singolo marcatore come permesso di modificare una directory o l’intero workspace.

Gate di review

Cline dovrebbe ispezionare il progetto e presentare il Task Contract prima delle modifiche sostanziali. Il developer approva, corregge o rifiuta il contratto e può restringere la superficie di scrittura proposta.

Se il developer modifica manualmente dei file, Cline deve leggerne il contenuto corrente prima di proseguire.

Limitazioni dello strumento

Interfaccia, flusso di approvazione o esecuzione comandi di Cline possono talvolta impedire a un workflow valido di proseguire automaticamente.

Per impostazione predefinita TCAF non usa comandi terminale tramite Cline. L’agente dovrebbe normalmente riportare da uno a tre comandi esatti DEVELOPER_RUN o controlli manuali.

Se Cline rimane Pending dopo una scrittura approvata ma il file è cambiato, considera la scrittura eseguita, revisiona il file e non approvarla né ripeterla. Se il file non è cambiato, avvia un nuovo task Cline per lo stesso passaggio delimitato senza ampliare la richiesta.

Una verifica manuale accettata dal developer può costituire evidenza valida quando il task riguarda UI o comportamento dipendente dall’ambiente.

Perimetro verificato

Il percorso manual-envelope è stato esercitato con lavoro di progetto e approvazioni esplicite del developer. Lo stato resta verified-with-limitations perché comportamento e permessi dell’host possono variare.

L’invocazione nativa automatica di Cline dal runner TCAF resta planned ed è documentata separatamente.