Qi Layer

Scrive e mantiene AGENTS.md e .context/CONTEXT.md come documenti di codebase a strati

di haowjy · haowjy/creative-writing-skills

Promosso ★ 8.8/10

Qi Layer — Scrive e mantiene AGENTS.md e .context/CONTEXT.md come documenti di codebase a strati

Cosa fa

Una skill di guida per la creazione della coppia di documentazione locale al codice AGENTS.md e .context/CONTEXT.md, utilizzando quattro principi (compressione frattale, riassunto gerarchico, deduplicazione LCA, divulgazione progressiva) più test espliciti per ciò che appartiene a ogni livello. Si attiva quando si scrivono, si tagliano o si mantengono questi documenti di intenti rivolti all'agente per una codebase — non per docstring, README o commenti a livello di codice. Spinge i dettagli di riferimento in .context/ e mantiene AGENTS.md radice focalizzato sulla conoscenza critica per le decisioni.

Rapporto di test

SKILL.md recuperato (HTTP 200) e resources/references.md (200); entrambe le skill sorelle referenziate knowledge-layers e llm-writing si risolvono (200). Il frontmatter viene analizzato con name+description; nessuno script, nessun curl|sh, nessuna esfiltrazione — references.md cita solo due URL esterni come fonti di design. Test di output: ho scritto un AGENTS.md per un modulo di rate-limit a finestra scorrevole sia senza che con la skill. La baseline ha narrato il codice file per file e conteneva una sezione di stato "TODO"/"in-memory" (esattamente il session-bleed che la skill segnala); la versione della skill invece ha iniziato con punti critici per le decisioni che la baseline non ha dichiarato ("effective global limit is max_hits × workers", "peek consumes two slots", "a False means slow down, not try again") e ha spostato i dettagli di algoritmo/Redis/O(n) in .context/CONTEXT.md. Giudizi trigger: 3 frasi di authoring/trimming lo caricano, le frasi di docstring e README-install correttamente no (5/5).

Testato il: 2026-07-31 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/haowjy/creative-writing-skills.git /tmp/qi-layer-src
mkdir -p ~/.claude/skills
cp -R /tmp/qi-layer-src/cw/skills/qi-layer ~/.claude/skills/qi-layer
# SKILL.md lands at ~/.claude/skills/qi-layer/SKILL.md ; bundled resources/references.md comes with it.
# Soft deps: SKILL.md body says "Load /knowledge-layers" and "/llm-writing". Those are sibling
# skills in the same repo (cw/skills/knowledge-layers, cw/skills/llm-writing). The core guidance
# is fully inline and works standalone; install those two the same way if you want the extras.
# No API keys, no build step, no scripts to run.

Comandi e prompt di esempio

/qi-layerScrive e mantiene AGENTS.md e .context/CONTEXT.md come documenti di codebase a strati

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

Explore this codebase using AGENTS.md as context
Update CONTEXT.md after this change
Keep this intent doc concise before committing

Rapporto completo →