Qi Layer

Skriv och underhåll AGENTS.md och .context/CONTEXT.md som lagerdelade kodbasdokument

av haowjy · haowjy/creative-writing-skills

Testad · Fungerar ★ 8.8/10

Qi Layer — Skriv och underhåll AGENTS.md och .context/CONTEXT.md som lagerdelade kodbasdokument

Vad den gör

En vägledningsfärdighet för att författa det kodlokala dokumentationsparet AGENTS.md och .context/CONTEXT.md, med fyra principer (fractal compression, hierarchical summarization, LCA deduplication, progressive disclosure) plus explicita tester för vad som hör hemma på varje nivå. Utlöses när du skriver, trimmar eller underhåller dessa agent-riktade intent-dokument för en kodbas — inte för docstrings, READMEs eller kommentarer på kodnivå. Den flyttar referensdetaljer ner i .context/ och håller rot-AGENTS.md fokuserad på beslutskritisk kunskap.

Testrapport

Hämtade SKILL.md (HTTP 200) och resources/references.md (200); båda refererade syskonfärdigheterna knowledge-layers och llm-writing löser (200). Frontmatter parsas med name+description; inga skript, ingen curl|sh, ingen exfiltration — references.md citerar endast två externa URL:er som designkällor. Utdata-test: skrev en AGENTS.md för en exempelmodul för sliding-window rate-limit både utan och med färdigheten. Baslinjen berättade om koden fil för fil och hade en "TODO"/"in-memory" statussektion (exakt den session-bleed som färdigheten flaggar); färdighetsversionen ledde istället med beslutskritiska footguns som baslinjen aldrig angav ("effective global limit is max_hits × workers", "peek consumes two slots", "a False means slow down, not try again") och flyttade algoritm/Redis/O(n)-detaljer till .context/CONTEXT.md. Trigger-bedömningar: 3 författnings-/trimningsfraseringar laddar den, docstring- och README-installationsfraseringar gör det korrekt inte (5/5).

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

Installation

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.

Kommandon och exempelprompter

/qi-layerSkriv och underhåll AGENTS.md och .context/CONTEXT.md som lagerdelade kodbasdokument

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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

Läs hela rapporten →