Agentsmd Optimize

Audituje CLAUDE.md/AGENTS.md, ověřuje jeho tvrzení proti repozitáři a aplikuje schválené opravy

od majiayu000 · majiayu000/spellbook

Otestováno · Funguje ★ 9.2/10

Agentsmd Optimize — Audituje CLAUDE.md/AGENTS.md, ověřuje jeho tvrzení proti repozitáři a aplikuje schválené opravy

Co umí

Audituje existující soubor instrukcí CLAUDE.md nebo AGENTS.md proti pěti strukturním vzorům, ověřuje každou cestu a tvrzení o příkazu proti skutečnému repozitáři (ls, package.json/Makefile), poté aplikuje opravy schválené uživatelem přímo na místě. Spouští se, když uživatel požádá o optimalizaci, vyčištění nebo opravu svého dokumentu agenta (anglické nebo čínské fráze jako "优化 CLAUDE.md"), nebo když řekne, aby se opravy aplikovaly po auditu. Označuje chybějící odkazované soubory namísto jejich vymýšlení a ponechává automaticky generované oblasti nedotčené.

Testovací report

Načten SKILL.md (soběstačná próza, žádné skripty) a nainstalován do dočasného HOME — umístí se na ~/.claude/skills/agentsmd-optimize/SKILL.md, frontmatter se parsuje s name+description a grep nenašel žádné curl|sh/base64/exfiltration problémy. Pro výstupní test jsem vytvořil nepořádný CLAUDE.md (špatné příkazy, neexistující adresář application/, chybějící odkaz routing-contract.md) plus skutečný package.json; základní vyčištění ponechalo npm run start, yarn test, make build, zastaralý adresář a poškozený odkaz doslova, zatímco ověření Step 2 dovednosti (kontroly ls + package.json) zjistilo, že žádné neexistují a opravilo je na npm run dev/npm test/npm run build, odstranilo zastaralý adresář a označilo chybějící soubor namísto jeho vymýšlení. Existují dva artefakty (BASELINE_CLAUDE.md vs SKILL_CLAUDE.md) a rozdíl ukazuje konkrétní rozdíl v správnosti.

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

Instalace

git clone --depth 1 https://github.com/majiayu000/spellbook.git /tmp/agentsmd-optimize-src
mkdir -p ~/.claude/skills
cp -R /tmp/agentsmd-optimize-src/skills/agentsmd-optimize ~/.claude/skills/agentsmd-optimize
# Single self-contained SKILL.md, no external deps or scripts.
# Sibling skill referenced in the body: skills/agentsmd-audit (audit-only). Copy it too if you want both.
# Rule codes it cites (SEC-13, W-17, U-32) are the author's own global ruleset, not required to use the skill.

Příkazy a ukázkové prompty

  • /agentsmd-optimizeAudituje CLAUDE.md/AGENTS.md, ověřuje jeho tvrzení proti repozitáři a aplikuje schválené opravy

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

  • Optimize my CLAUDE.md instruction file
  • Score my AGENTS.md against best practices
  • Apply the recommended fixes to my agent doc