Qi Layer

Pisanie i utrzymywanie AGENTS.md i .context/CONTEXT.md jako warstwowych dokumentów bazy kodu

Autor: haowjy · haowjy/creative-writing-skills

Testowano · Działa ★ 8.8/10

Qi Layer — Pisanie i utrzymywanie AGENTS.md i .context/CONTEXT.md jako warstwowych dokumentów bazy kodu

Co robi ten skill

Umiejętność prowadzenia do tworzenia lokalnej pary dokumentacji kodu AGENTS.md i .context/CONTEXT.MD, wykorzystując cztery zasady (kompresja fraktalna, hierarchiczne podsumowanie, deduplikacja LCA, progresywne ujawnianie) plus jawne testy, co należy do każdego poziomu. Uruchamia się, gdy piszesz, przycinasz lub utrzymujesz te dokumenty intencji skierowane do agentów dla bazy kodu — nie dla docstrings, READMEs ani komentarzy na poziomie kodu. Przesuwa szczegóły referencyjne do .context/ i utrzymuje główny AGENTS.md skupiony na wiedzy krytycznej dla decyzji.

Raport z testu

Pobrano SKILL.md (HTTP 200) i resources/references.md (200); oba odwołania do umiejętności siostrzanych knowledge-layers i llm-writing rozwiązują się (200). Frontmatter parsowany z name+description; brak skryptów, brak curl|sh, brak eksfiltracji — references.md cytuje tylko dwa zewnętrzne adresy URL jako źródła projektu. Test wyjścia: napisałem AGENTS.md dla przykładowego modułu sliding-window rate-limit zarówno bez, jak i z umiejętnością. Linia bazowa opowiadała o pliku kodu plik po pliku i zawierała sekcję statusu „TODO”/„in-memory” (dokładnie to, co umiejętność oznacza jako session-bleed); wersja umiejętności zamiast tego zaczęła od krytycznych dla decyzji pułapek, których linia bazowa nigdy nie wspominała („effective global limit is max_hits × workers”, „peek consumes two slots”, „a False means slow down, not try again”) i przeniosła szczegóły algorytmu/Redis/O(n) do .context/CONTEXT.md. Ocena wyzwalaczy: 3 frazy dotyczące tworzenia/przycinania ładują ją, frazy docstring i README-install prawidłowo nie (5/5).

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

Instalacja

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.

Komendy i przykładowe prompty

/qi-layerPisanie i utrzymywanie AGENTS.md i .context/CONTEXT.md jako warstwowych dokumentów bazy kodu

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →