Menu
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 com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação 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)