df243cd953
Four memory docs (2 skills, 2 wrapper scripts) + MEMORY.md index lines; ask-minimax-usage.md gains both delegation targets. Records the gac v0.0.2.10 token-discovery gap (needs GITEA_TOKEN_FILE pointed at ai_admin/token; the wrapper defaults it). Claude-Session: https://claude.ai/code/session_01Ku87DDWwbJkTx6SuV3sQDc
2.4 KiB
2.4 KiB
Context Offloading with /ask-minimax
/ask-minimax delegates a task to a MiniMax M3 sub-session that reads and writes files directly. Only a short summary flows back — file contents never load into this session. Reach for it when the file payload dwarfs the answer payload.
Use it for
- Summarising large files (logs, dumps, generated reports >500 lines)
- Extracting specific facts from multiple files or long reference docs
- Generating big files (migrations, config bundles, fixtures, large docs) where the content does not need to flow back
- Format conversion of large files (CSV↔JSON, XML↔YAML, etc.)
- Bulk find-and-extract across many files where only the matches matter
- Broad read-only codebase exploration ("where does X live", "how is Y wired up") — use the specialised
/explore-minimaxskill, which enforces read-only, requiresfile:linecitations, and falls back to the Explore agent on failure - First-pass code review of agent-produced branches — use the specialised
/review-minimaxskill (findings file, credential gates, adjudicated in-session; pre-filter before/code-review, never final authority) - CI failure triage of failed Gitea Actions runs — use the specialised
/ci-triage-minimaxskill (gac log fetch + redaction; failing step/cause file; canonical aftergac tail --until run-completeexits 1)
Skip it for
- Iterative design or debugging — the main session needs the content in context
- Small files (under a few hundred lines) — overhead exceeds savings
- Tasks where you will immediately re-read the result to act on it
- Anything requiring tools MiniMax cannot use (web fetch, MCP, browser, agent dispatch)
- Architecture or quality-sensitive output — MiniMax is for grunt work, not nuanced reasoning
- Anything touching
secrets/,local_secrets/, or credential material — never hand secret-adjacent paths to a third-party model
How to delegate
Pass file paths, not file contents. If you read the input files yourself before invoking, you have already paid the token cost the skill exists to avoid.
Failure handling
MiniMax intermittently returns invalid system role and other transient errors. Retry once. If it fails again, fall back to a Claude subagent with the same brief — Sonnet for file-heavy grunt work, Opus for reasoning-grade consults. Never silently drop the task. Log new error shapes to the project's memory/gotchas-*.md.