修復身份驗證競爭條件

osop_version: "1.0"
id: "claude-code-fix-auth-bug"
name:"修復身份驗證競爭條件"
description:"Claude Code 使用子代理探索與協調修復方式，對 token 刷新競爭條件進行除錯與修正。"
version: "1.0.0"
tags: [claude-code, debugging, sub-agent, auth]

nodes:
  - id: "user_report"
    type: "human"
    subtype: "input"
    name: "使用者回報錯誤"
    description: "使用者回報生產環境中 auth token 刷新偶發性失敗的問題。"

  - id: "coordinator"
    type: "agent"
    subtype: "coordinator"
    name: "規劃調查方向"
    description: "主代理規劃除錯策略，並同步派出 3 個探索子代理進行並行分析。"
    spawn_policy:
      max_children: 5
      child_tools: ["Read", "Grep", "Glob", "Bash"]
      can_spawn_children: false

  - id: "explore_auth"
    type: "agent"
    subtype: "explore"
    name: "探索身份驗證模組"
    description: "子代理讀取身份驗證相關檔案，了解 token 刷新流程。"
    parent: "coordinator"

  - id: "explore_tests"
    type: "agent"
    subtype: "explore"
    name: "探索測試覆蓋範圍"
    description: "子代理檢查身份驗證模組現有的測試覆蓋情況。"
    parent: "coordinator"

  - id: "explore_logs"
    type: "agent"
    subtype: "explore"
    name: "搜尋錯誤模式"
    description: "子代理搜尋 git 歷史紀錄與錯誤日誌，尋找相關問題的線索。"
    parent: "coordinator"

  - id: "synthesize"
    type: "agent"
    subtype: "llm"
    name: "綜合分析與決策"
    description: "主代理整合所有子代理的發現，識別根本原因並制定修復策略。"

  - id: "write_fix"
    type: "mcp"
    subtype: "tool"
    name: "撰寫修復程式碼"
    description: "加入 mutex 鎖以防止 token 刷新並發呼叫。"

  - id: "write_test"
    type: "mcp"
    subtype: "tool"
    name: "撰寫迴歸測試"
    description: "新增並發刷新情境的測試案例。"

  - id: "run_tests"
    type: "cicd"
    subtype: "test"
    name: "執行測試套件"
    description: "執行完整測試套件，確認修復未破壞現有功能。"

  - id: "user_review"
    type: "human"
    subtype: "review"
    name: "使用者審查變更"
    description: "使用者在提交前審查修復內容與測試案例。"

edges:
  - from: "user_report"
    to: "coordinator"
  - from: "coordinator"
    to: "explore_auth"
    mode: "spawn"
  - from: "coordinator"
    to: "explore_tests"
    mode: "spawn"
  - from: "coordinator"
    to: "explore_logs"
    mode: "spawn"
  - from: "explore_auth"
    to: "synthesize"
  - from: "explore_tests"
    to: "synthesize"
  - from: "explore_logs"
    to: "synthesize"
  - from: "synthesize"
    to: "write_fix"
  - from: "write_fix"
    to: "write_test"
  - from: "write_test"
    to: "run_tests"
  - from: "run_tests"
    to: "user_review"
  - from: "run_tests"
    to: "write_fix"
    mode: "fallback"
    label: "Tests failed, revise fix"