Manuale/Andare oltre
Skill e modalità workflow
Una skill è una ricetta pronta per un tipo di lavoro — "rivedi questo codice", "pianifica questa funzione", "trova questo bug". moh carica una skill solo quando serve, e ognuna compare come un comando che inizia con lo slash.
Modalità workflow: le ricette incluse
moh include un set completo di skill per pianificare e consegnare il lavoro. Attivale con:
/workflow on
Compaiono allora nel menu /. Con /workflow off spariscono e moh si
comporta esattamente come prima — il comportamento di base non cambia mai.
| Comando | Serve a… |
|---|---|
/grilling | Farti fare domande su un'idea finché è chiara, prima che esista codice. |
/to-spec | Trasformare un'idea chiara in una specifica scritta. |
/to-tickets | Dividere una specifica in compiti piccoli e ordinati. |
/implement | Realizzare un compito, con i test — per esempio /implement #457 per una issue. |
/tdd | Lavorare partendo dai test: un test che fallisce, poi il codice che lo fa passare. |
/code-review | Ottenere una revisione attenta di una modifica. |
/diagnosing-bugs | Scovare un bug con metodo invece di tirare a indovinare. |
/report-bug, /triage | Descrivere bene un problema; smistare le issue in arrivo. |
/pr | Preparare una pull request. |
/retro | Rivedere cosa migliorare (vedi Retro). |
Il set comprende anche /prototype, /research, /handoff,
/wait-what, /to-questionnaire e altre; il workflow è un adattamento
del Matt Pocock agent workflow (piano, specifica, ticket, implementazione, revisione). Con la
modalità workflow attiva, ctrl+f apre il pannello frontier: cosa è
pronto per essere lavorato dopo.
Non sai quale? Chiedi
/ask-moh seguito da una domanda in parole semplici ti indica la skill o il comando
giusto — oppure risponde a domande su moh stesso usando questo manuale, dicendoti quale sezione
ha usato. Senza domanda, mostra una panoramica di quale flusso si adatta a quale situazione.
› /ask-moh come sposto questo lavoro sull'altro portatile? › /ask-moh ho un'idea vaga per una funzione, da dove parto?
Da sapere
moh porta il suo manuale dentro il programma. Ogni volta che gli chiedi delle sue funzioni, legge prima quel manuale e cita la pagina — e se nessuna pagina copre la domanda, lo dice invece di tirare a indovinare.
Scrivere le tue skill
Una skill è un breve file di testo con istruzioni. Metti le tue in ~/.moh/skills/
(solo per te) oppure in .moh/skills/ del progetto (per tutti quelli che ci lavorano;
vince la versione del progetto). Compare nel menu / come quelle incluse.
Una skill può ricevere argomenti, presi dal comando che scrivi:
› /releaser 1.2.3 draft=yes # dentro la skill: $1 è "1.2.3", ${draft:-no} è "yes"
Se dimentichi un argomento, moh lo precompila nel messaggio così puoi completarlo prima di inviare.
Scritto per moh 0.61. Dentro moh, ctrl+h apre il manuale incluso, aggiornato alla tua versione.