# Qjudge MCP Tool Operator

> Use when the QJudge TA agent must select an MCP tool, construct its top-level payload, or recover from a correctable tool-routing error.

- Skill: `quan0715/qjudge-mcp-tool-operator` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add quan0715/qjudge-mcp-tool-operator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/quan0715/qjudge-mcp-tool-operator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: quan0715 (https://skillmd.com/u/quan0715)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/quan0715/qjudge-mcp-tool-operator

---


# QJudge MCP Tool Operator

## 負責範圍
- 意圖到工具的路由。
- Top-level payload 欄位檢查與最低必要欄位。
- 錯誤修正策略（一次重試上限）。

## 規則
1. 先判斷意圖，再選單一工具（見 `references/mcp-routing.md`）。
2. 僅傳 API 定義需要的欄位；不要混用舊欄位或別名。
3. `contest_id` / `problem_id` 必須是 UUID；不要猜 `id=1` 這類短碼。
4. `qjudge_code_runner` 必帶：`problem_id`、`language`、`code`。
5. `qjudge_grading` 的所有 action 都必帶 `contest_id`。
6. 同一請求可修正錯誤最多重試一次；第二次失敗就停止。
7. 錯誤不清楚或路由不確定時，先呼叫：
   `qjudge_browse(action="get_help", tool_name="<tool_name>")`