Qi Layer

AGENTS.md und .context/CONTEXT.md als geschichtete Codebasis-Dokumente schreiben und pflegen

von haowjy · haowjy/creative-writing-skills

Getestet · Funktioniert ★ 8.8/10

Qi Layer — AGENTS.md und .context/CONTEXT.md als geschichtete Codebasis-Dokumente schreiben und pflegen

Was es kann

Eine Anleitungs-Skill zum Erstellen des Code-lokalen Dokumentationspaares AGENTS.md und .context/CONTEXT.md, unter Verwendung von vier Prinzipien (fraktale Kompression, hierarchische Zusammenfassung, LCA-Deduplizierung, progressive Offenlegung) plus expliziten Tests dafür, was auf jeder Ebene gehört. Wird ausgelöst, wenn Sie diese agentenorientierten Intent-Dokumente für eine Codebasis schreiben, kürzen oder pflegen – nicht für Docstrings, READMEs oder Code-Level-Kommentare. Sie verschiebt Referenzdetails in .context/ und hält die Root-AGENTS.md auf entscheidungsrelevantes Wissen fokussiert.

Testbericht

SKILL.md (HTTP 200) und resources/references.md (200) abgerufen; beide referenzierten Schwester-Skills knowledge-layers und llm-writing lösen auf (200). Frontmatter wird mit name+description geparst; keine Skripte, kein curl|sh, keine Exfiltration – references.md zitiert nur zwei externe URLs als Designquellen. Ausgabetest: Eine AGENTS.md für ein Beispiel-Sliding-Window-Rate-Limit-Modul wurde sowohl ohne als auch mit dem Skill geschrieben. Die Baseline erzählte den Code Datei für Datei und enthielt einen "TODO"/"in-memory"-Statusabschnitt (genau das Session-Bleed, das der Skill kennzeichnet); die Skill-Version führte stattdessen mit entscheidungsrelevanten "Footguns", die die Baseline nie erwähnte ("effective global limit is max_hits × workers", "peek consumes two slots", "a False means slow down, not try again") und verschob Algorithmus-/Redis-/O(n)-Details in .context/CONTEXT.md. Trigger-Bewertungen: 3 Authoring-/Trimming-Phrasierungen laden es, Docstring- und README-Installations-Phrasierungen tun dies korrekt nicht (5/5).

Getestet am: 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.

Befehle & Beispiel-Prompts

/qi-layerAGENTS.md und .context/CONTEXT.md als geschichtete Codebasis-Dokumente schreiben und pflegen

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →