Qi Layer

Écrire et maintenir AGENTS.md et .context/CONTEXT.md comme docs de codebase en couches

par haowjy · haowjy/creative-writing-skills

Testé · Fonctionne ★ 8.8/10

Qi Layer — Écrire et maintenir AGENTS.md et .context/CONTEXT.md comme docs de codebase en couches

Ce que fait

Une compétence de guidance pour l'authoring de la paire de documentation locale au code AGENTS.md et .context/CONTEXT.md, utilisant quatre principes (compression fractale, résumé hiérarchique, déduplication LCA, divulgation progressive) plus des tests explicites pour ce qui appartient à chaque niveau. Se déclenche lorsque vous écrivez, élaguez ou maintenez ces documents d'intention orientés agent pour une codebase — pas pour les docstrings, les READMEs ou les commentaires au niveau du code. Elle pousse les détails de référence dans .context/ et maintient AGENTS.md à la racine axé sur les connaissances critiques pour la décision.

Rapport de test

SKILL.md (HTTP 200) et resources/references.md (200) récupérés ; les deux compétences sœurs référencées knowledge-layers et llm-writing se résolvent (200). Le frontmatter est parsé avec name+description ; aucun script, aucun curl|sh, aucune exfiltration — references.md ne cite que deux URL externes comme sources de conception. Test de sortie : j'ai écrit un AGENTS.md pour un module de limite de débit à fenêtre glissante échantillon, à la fois sans et avec la compétence. La base a narré le code fichier par fichier et contenait une section de statut "TODO"/"in-memory" (exactement la fuite de session signalée par la compétence) ; la version de la compétence a plutôt commencé par des pièges critiques pour la décision que la base n'avait jamais mentionnés ("la limite globale effective est max_hits × workers", "peek consomme deux slots", "un False signifie ralentir, pas réessayer") et a déplacé les détails de l'algorithme/Redis/O(n) dans .context/CONTEXT.md. Jugements de déclenchement : 3 formulations d'authoring/élagage le chargent, les formulations de docstring et d'installation de README ne le font pas correctement (5/5).

Testé le: 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.

Commandes et exemples de prompts

/qi-layerÉcrire et maintenir AGENTS.md et .context/CONTEXT.md comme docs de codebase en couches

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →