如果你正在建置或管理一套 Agentic AI 工單系統，並且希望 Claude Code 能自動處理新進的問題——自動掃描工單、分析問題、修復程式碼、更新工單狀態——這篇文章將帶你走完完整的設定流程。

這不只是概念介紹，照著做完之後，你將擁有一個每 15 分鐘自動掃描工單端點、並主動處理待辦問題的自動化迴圈，完全不需要手動介入。

先釐清一件事：Claude Code 會自動掃描你的端點嗎？

簡短答案：不會，預設情況下不會。

開箱即用的 Claude Code 搭配 MCP，並不會在背景自動輪詢或定期掃描你的工單 API。你需要主動設定這個行為。好消息是，一旦你理解了以下三種方法的分工，整個流程其實非常直覺。

三種方法的分工：你實際上會用到什麼

整個工作流程的建置涉及三種方式的搭配使用——搞清楚每個任務對應哪種方式，是避免混亂的關鍵。

  • 終端機指令 — 用來將你的工單 API 連接為 MCP 伺服器
  • 建立檔案 — 用來定義一個可重複呼叫的工作流程（也就是你的「技能」）
  • 工作階段內指令 — 用來在 Claude Code 內部啟動定期掃描迴圈

三種方法你都會用到，但每種只需要設定一次。以下是完整的對應表：

任務 使用方式 需要提示 Claude？ 需要建立檔案？ 需要執行指令？
連接工單 API（MCP） 終端機 否 否 是 — claude mcp add
建立可重用工作流程 .claude/skills/ 資料夾內的檔案 否 是 — SKILL.md 否
啟動定期掃描 工作階段內指令 是（一次） 選用 是 — /loop

第一步：透過 MCP 連接你的工單系統

這個步驟完全在終端機中操作，不需要提示 Claude。你要做的是將你的工單 API 註冊為一個 MCP（Model Context Protocol）伺服器，讓 Claude Code 能夠將它作為一組可呼叫的工具來使用。

選項 A：使用 Fetch MCP 快速啟動

npx @modelcontextprotocol/server-fetch

選項 B：使用 OpenAPI MCP 進行更乾淨的整合

建立一個描述你工單 API 端點的 openapi.json 檔案，然後對它執行 OpenAPI MCP 伺服器。這能讓 Claude 獲得結構更清晰、更易操作的工具定義。

註冊你的伺服器

MCP 伺服器啟動後，將它加入 Claude Code：

claude mcp add ticket-dashboard http://localhost:PORT

用以下指令確認連線是否成功：

claude mcp list

第二步：建立可重用工作流程（SKILL.md）

這是整個設定中最關鍵的部分。與其每次都重新提示 Claude，你可以定義一個技能檔案，讓 Claude 在需要時隨時呼叫——也可以讓迴圈自動定期執行它。

建立檔案結構

在你的專案根目錄，建立以下路徑：

.claude/skills/fix-pending-ticket/SKILL.md

將以下內容貼入 SKILL.md

---
name: fix-pending-ticket
description: 掃描 AI 工單系統中的待辦工單，選出優先級最高的一張，分析問題、修復程式碼，並更新工單狀態與新增 AI 備註。
---

每次請嚴格按照以下流程執行：

1. 呼叫工單工具，列出待辦工單：
   - 使用 GET /api/tickets.php?status=pending（附上 X-API-Key 標頭）

2. 如果有待辦工單：
   - 選出優先級最高的一張（high > medium > low），若相同則選最舊的。
   - 取得該工單的完整詳細資訊。

3. 理解工單內容：
   - 閱讀標題、描述、優先級、project_id 以及所有備註。

4. 修復問題：
   - 全面搜尋程式碼庫。
   - 規劃修改方案。
   - 安全地進行修改（如可能，先建立新分支）。
   - 測試或建置以驗證結果。

5. 更新工單：
   - 開始時將狀態設為 "in_progress"。
   - 進行過程中以 author_type: "ai" 新增備註。
   - 完成後將狀態設為 "completed"，並新增包含變更摘要的最終備註。

6. 如果沒有待辦工單 → 回覆「目前沒有待辦工單。」並停止。

安全原則：在 feature 分支上工作，未經驗證不得推送。

儲存檔案後，重新啟動 Claude Code 或開啟新工作階段。Claude 會自動偵測到這個技能。之後你隨時可以輸入以下指令手動觸發：

/fix-pending-ticket

第三步：使用 /loop 啟用定期掃描

最後這個步驟在 Claude Code 的工作階段內執行。你只需觸發一次，它就會持續運行，直到你關閉終端機為止。

在你的專案目錄啟動 Claude Code

claude

啟動掃描迴圈

/loop 15m /fix-pending-ticket

或用自然語言描述：

/loop every 15 minutes run the fix-pending-ticket skill

Claude 現在會每 15 分鐘執行一次工作流程。你可以根據工單產生的頻率調整時間間隔，例如 10m、30m、1h 等。

使用前必須了解的限制

  • 迴圈只在終端機工作階段保持開啟、且電腦不進入睡眠的情況下運作
  • 關閉終端機後，迴圈會立即停止
  • 工作階段最長持續約 3 天後會自動過期
  • 若需要更長期、更穩定的排程，建議改用 Claude Code Desktop 的排程任務功能，或搭配外部 cron 工作呼叫無介面模式的 Claude

快速設定清單

  • ✅ 連接工單 API：claude mcp add ticket-dashboard <你的URL>
  • ✅ 建立 .claude/skills/fix-pending-ticket/SKILL.md，貼入上述工作流程內容
  • ✅ 開啟 Claude Code：claude
  • ✅ 先手動測試：/fix-pending-ticket
  • ✅ 確認無誤後啟動迴圈：/loop 15m /fix-pending-ticket

總結

這套設定的核心優勢在於職責分離：MCP 負責 API 連線，SKILL.md 定義要做什麼，/loop 指令決定什麼時候做。三者串聯之後，你就擁有了一個真正自主的 Agent，能夠持續監控工單佇列、採取行動，並回報結果——完全不需要你親自盯著它。

建議先手動測試技能幾次，再啟用迴圈。確認 Claude 讀取到正確的工單、做出正確的修改、並正確更新狀態之後，才放手讓它自動運行。扎實的前期驗證，是讓自動化真正可靠的關鍵。

標籤：