Doc Writing
Trasforma un manifest di route scansionato in documentazione API Markdown raggruppata e templatizzata per uno stadio di pipeline.
Promosso
Cosa fa
Genera documentazione API Markdown raggruppata a partire da un manifest di route JSON (method/path/file/line/middleware/type), compilando un template fisso endpoint-doc.md con tabelle di parametri e risposte e un'icona di lucchetto per l'autenticazione. Costruito come stadio 2 di una pipeline didattica a 3 stadi (route-scanner a doc-writer a quality-checker) da un repo-corso su Claude Code, quindi si attiva specificamente quando un manifest di route esiste già, non per richieste generiche del tipo 'scrivi la mia documentazione'.
Rapporto di test
Gli ho dato in pasto un manifest di 3 route su 2 file sorgente: ha correttamente suddiviso l'output in products-api.md e categories-api.md seguendo il template endpoint-doc.md incluso (con un vero indicatore 🔒 di autenticazione e tabelle di parametri/risposte) più un manifest files_generated leggibile da macchina per lo stadio successivo della pipeline — un tentativo di base ha prodotto un unico file piatto, non raggruppato, senza manifest.
Testato il: 2026-07-13 · Claude Code 2.x (agent harness)
Installazione
git clone https://github.com/huangjia2019/claude-code-engineering cd claude-code-engineering mkdir -p ~/.claude/skills cp -r 04-Skills/projects/08-skill-pipeline/.claude/skills/doc-writing ~/.claude/skills/doc-writing
Comandi e prompt di esempio
/doc-writingTrasforma un manifest di route scansionato in documentazione API Markdown raggruppata e templatizzata per uno stadio di pipeline.
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
Generate Markdown API docs from this route manifest JSON we scannedFill in the endpoint doc template with params and response tables for these routesWrite grouped API reference docs from the scanned route list with auth icons