Menú
Audit commit history to find recurring fix patterns and update prevention skills. Use when analyzing what keeps breaking, updating review skills, or refreshing the fix-pattern audit doc.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Auto-guardrail for agent-authored changes. Use at the start of any coding session to prevent the most common agent mistakes in this repo.
Iterate on visualizer UI, workspace chrome, and CSS with fast feedback loops. Use when changing frontend components, styling, layout, or animation without needing the full MilkDrop runtime.
Modify the flagship visualizer runtime safely. Use when changing the shared runtime, loader, renderer, shell, controls, audio flows, capability checks, or canonical-route behavior.
Review changes to module loading, bootstrap, toy manifest, library resolution, or gamepad polling. Use when a PR touches src/js/bootstrap/, src/js/loader.ts, src/js/router.ts, src/js/toy-view.ts, src/data/toys.json, or gamepad polling code.
Review changes to renderer capability probing, fallback chains, timeout logic, or audio worklet initialization. Use when a PR touches src/js/core/renderer-*, src/js/core/audio-handler.ts, or src/js/milkdrop/runtime/backend-fallback.ts.
Review changes to WebGPU/WebGL dual-backend parity. Use when a PR touches feedback managers, renderer adapters, shader lowering, or any code that affects both WebGPU and WebGL rendering paths.
| name | audit-recurring-fixes |
| description | Audit commit history to find recurring fix patterns and update prevention skills. Use when analyzing what keeps breaking, updating review skills, or refreshing the fix-pattern audit doc. |
Use this skill when you need to understand what the codebase keeps getting wrong, update the prevention skills, or refresh the audit doc.
Fixes cluster in predictable categories. This skill turns commit archaeology into actionable prevention by:
# Last 300-400 commits, fix-focused
git log --oneline -400 > /tmp/all_commits.txt
git log --oneline --grep="fix" -i -300 > /tmp/fix_commits.txt
git log --oneline --grep="revert" -i -300 > /tmp/revert_commits.txt
Look for these recurring themes:
| Theme | Keywords in commit messages | Typical files |
|---|---|---|
| Parity drift | parity, blend, feedback, shader, wave, webgpu | feedback-manager-*, renderer-adapter*, compiler/gpu-descriptor-plan.ts |
| Fallback fragility | fallback, timeout, renderScale, capability, probe | renderer-setup.ts, renderer-capabilities.ts, render-service.ts, backend-fallback.ts |
| Test harness drift | test, expect, fixture, harness | tests/milkdrop-renderer-adapter.test.ts, tests/environment/* |
| UI/state races | toast, toggle, url, workspace, panel | frontend/App.tsx, frontend/workspace-hooks.ts, frontend/url-state.ts |
| Deploy/tooling | deploy, config, wrangler, ci | scripts/deploy-cloudflare.mjs, wrangler.toml |
git log --format="%H" -300 | while read h; do
git show --stat --oneline $h 2>/dev/null | grep -E "^\s+.*\|"
done | awk -F'|' '{print $1}' | sed 's/^[[:space:]]*//' | sort | uniq -c | sort -rn | head -20
High-churn + high-fix-density files are instability clusters.
If a new fix category is emerging or an existing one is growing:
Read the relevant review skill:
.agent/skills/review-webgpu-parity/SKILL.md.agent/skills/review-renderer-fallback/SKILL.md.agent/skills/review-test-harness/SKILL.md.agent/skills/review-workspace-ui-state/SKILL.mdAdd new checklist items or tighten existing ones based on the fresh fix patterns.
If a new category appears (e.g., "audio permission regressions"), create a new review skill following the pattern:
name and description frontmatterUpdate docs/RECURRING_FIX_PATTERNS_AUDIT_YYYY-MM.md with:
scripts/mcp-shared.ts (import, markdownSources, agentCapabilities)docs/agents/custom-capabilities.md (skills table)docs/agents/visualizer-workflows.md (review skills section)