Doc Cleanup

Dvoufázový audit zastaralosti Markdownu: diagnóza podložená důkazy, úpravy pouze po schválení

od aka-luan · aka-luan/doc-cleanup

Otestováno · Funguje ★ 9.6/10

Doc Cleanup — Dvoufázový audit zastaralosti Markdownu: diagnóza podložená důkazy, úpravy pouze po schválení

Co umí

Audituje Markdown repozitáře na zastaralost kontextu – dokončené kontrolní seznamy stále napsané jako instrukce, dodané plány stále napsané jako záměr, zastaralé počty, mrtvé cesty a protichůdné zdroje pravdy – a vyžaduje důkazy z repozitáře pro každé zjištění před navržením opravy. Nejprve spustí diagnose-and-report a zastaví se pro schválení, poté provede s archive-and-rewrite playbookem a link/diff ověřovacím průchodem. Spouští se na požadavky na kontrolu, čištění nebo ověření faktů v projektové dokumentaci, CLAUDE.md nebo AGENTS.md.

Testovací report

Nasměroval jsem ji na vstupní dokumentaci a složku docs/ živého repozitáře Astro katalogu. Bez dovednosti jsem vytvořil čtyři dojmy ("čísla vypadají zastarale", "existuje duplicitní soubor protokolu"); s ní třináct zjištění, z nichž každé přežilo provedenou kontrolu — README tvrdí 64 dovedností, kde skills.json obsahuje 2433, tvrdí 12 kategorií v jednom odstavci a 8 v jiném, a jeho spouštěcí kontrolní seznam vám stále říká, abyste zapojili newsletter endpoint, vyměnili mailto buy button za Gumroad a vygenerovali OG image, které byly všechny dodány dávno. Nejhorší jednotlivý zásah, který zachytila, je řádek README tvrdící, že testovací data jsou vzorový materiál, což je v rozporu s verdikty 1320 pass / 715 setup / 290 queue / 108 fails v datové sadě. Také označila osamocený docs-internal-test-protocol.md – 56 řádků se odchýlilo od živého protokolu, nulové příchozí reference – který vynechává bezpečnostní bránu a říká agentovi, aby hodnotil instalace stahováním souborů namísto jejich spouštění. Čistý Markdown, žádné skripty a diagnostický průchod skutečně nechal pracovní strom nedotčený.

Testováno: 2026-08-10 · Claude Code 2.x (agent harness)

Instalace

git clone https://github.com/aka-luan/doc-cleanup.git
mkdir -p ~/.claude/skills
cd doc-cleanup && cp -r skills/doc-cleanup ~/.claude/skills/doc-cleanup

Příkazy a ukázkové prompty

  • /doc-cleanupDvoufázový audit zastaralosti Markdownu: diagnóza podložená důkazy, úpravy pouze po schválení

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • Audit our docs folder for stale instructions and dead paths
  • Check README.md for finished checklists still written as todos
  • Find contradicting sources of truth across our markdown docs