Agentsmd Optimize

Verifica un CLAUDE.md/AGENTS.md, ne verifica le affermazioni rispetto al repo e applica le correzioni approvate

di majiayu000 · majiayu000/spellbook

Promosso ★ 9.2/10

Agentsmd Optimize — Verifica un CLAUDE.md/AGENTS.md, ne verifica le affermazioni rispetto al repo e applica le correzioni approvate

Cosa fa

Verifica un file di istruzioni CLAUDE.md o AGENTS.md esistente rispetto a cinque pattern di struttura, verifica ogni percorso e affermazione di comando rispetto al repo reale (ls, package.json/Makefile), quindi applica le correzioni approvate dall'utente in loco. Si attiva quando l'utente chiede di ottimizzare, pulire o correggere il proprio documento agente (frasi in inglese o cinese come "优化 CLAUDE.md"), o quando dice di applicare le correzioni dopo un audit. Segnala i file referenziati mancanti invece di inventarli e lascia intatte le regioni auto-generate.

Rapporto di test

Recuperato SKILL.md (prosa autonoma, nessun script) e installato in una HOME temporanea — si trova in ~/.claude/skills/agentsmd-optimize/SKILL.md, il frontmatter viene parsato con name+description, e un grep non ha trovato problemi di curl|sh/base64/esfiltrazione. Per il test di output ho costruito un CLAUDE.md disordinato (comandi sbagliati, una directory application/ inesistente, un riferimento routing-contract.md mancante) più un package.json reale; la pulizia della baseline ha mantenuto npm run start, yarn test, make build, la directory obsoleta e il riferimento rotto alla lettera, mentre seguendo la verifica del Passaggio 2 della skill (controlli ls + package.json) ha rilevato che nessuno esisteva e li ha corretti in npm run dev/npm test/npm run build, ha eliminato la directory obsoleta e ha segnalato il file mancante invece di inventarlo. Esistono due artefatti (BASELINE_CLAUDE.md vs SKILL_CLAUDE.md) e il diff mostra la differenza concreta di correttezza.

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

Installazione

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.

Comandi e prompt di esempio

  • /agentsmd-optimizeVerifica un CLAUDE.md/AGENTS.md, ne verifica le affermazioni rispetto al repo e applica le correzioni approvate

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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