調查工作流程技能
自動化針對客戶問題的完整 TAM 調查流程。
使用方式
/investigate <客戶名稱> <問題描述>
範例：
/investigate LSEG "webhook 逾時錯誤"/investigate "Network International" "BeyondTrust 外掛程式驗證"/investigate Roche "排程器未觸發工作"
此技能的功能
執行 CLAUDE.md 中定義的完整調查工作流程：
- 尋找客戶檔案 - 定位並讀取客戶環境詳細資訊
- 搜尋知識庫 - 尋找相近的調查案例與最佳實踐
- 檢查文件 - 驗證該行為是否已記載
- 在程式碼中驗證 - 搜尋產品原始碼以了解實際行為
- 檢查外部追蹤系統 - 透過 GitHub Issues 和 Jira 搜尋已知錯誤/開發狀態
- 建議測試環境 - 根據問題類型推薦合適的沙箱
- 總結調查結果 - 提供結構化摘要與參考資料
- 記錄調查 - 使用範本在
investigations/中建立新的調查檔案
指示
當此技能被呼叫時，請依循下列步驟：
步驟 1：提取參數
從引數中識別：
customer_name：客戶/公司名稱issue_keywords：描述問題的關鍵術語（錯誤訊息、功能、元件）
步驟 2：尋找客戶檔案
Grep pattern="<customer_name>" path="customers/" output_mode="files_with_matches"
如果找到：
Read客戶檔案- 記錄：環境（雲端/本地部署）、Rundeck 版本、規模、過去問題
- 儲存客戶上下文以供後續使用
如果找不到：
- 記錄：「找不到客戶檔案 - 可能是潛在客戶或初次接觸」
- 繼續調查
步驟 3：搜尋知識庫
相近的調查案例：
Grep pattern="<issue_keywords>" glob="investigations/**/*.md" output_mode="content" -C 3
相關的最佳實踐：
Grep pattern="<issue_keywords>" glob="best-practices/**/*.md" output_mode="content" -C 2
對於每個結果：
- 記錄檔案路徑、日期（若為調查案例則從檔名取得）以及主要發現
- 判斷是否為完全相符或類似模式
- 提取解決方案或替代方案
步驟 4：檢查文件
Grep pattern="<issue_keywords>" path="repositories/docs/" output_mode="content" -C 2
判斷：
- 這是已記載的行為嗎？
- 是否有組態選項或已知限制？
- 文件內容是否符合客戶預期？
步驟 5：驗證產品程式碼
Grep pattern="<相關類別或方法>" path="repositories/rundeckpro/" output_mode="content" head_limit=50
尋找：
- 實際的實作行為
- 預設值或常數
- 錯誤訊息來源
- 版本特定邏輯
步驟 6：檢查外部追蹤系統
GitHub 社群問題（透過 Runlayer 連接器）：
透過 Runlayer 連接器查詢 GitHub。呼叫 search_tools 定位 GitHub issue-search 工具，然後 execute_tool 在 rundeck/rundeck 和 rundeckpro/rundeckpro 中搜尋 <issue_keywords>，範圍包含已開啟和已關閉的問題（各限制約 10 筆）。不要使用 gh 進行 shell 操作。
Jira 開發追蹤（透過 Runlayer 連接器）：
透過 Runlayer 連接器查詢 Jira。呼叫 search_tools 定位 Jira issue-search 工具，然後使用傳回的 tool_name 和引數執行 execute_tool，搜尋專案 RUN 中與 <issue_keywords> 相關的問題，並依更新日期排序（等效 JQL：project=RUN AND text~"<issue_keywords>" ORDER BY updated DESC）。不要直接呼叫 mcp__atlassian__* 工具。
對於每個相關結果：
- 記錄問題編號、狀態與摘要
- 檢查是否已在特定版本中修正
- 記錄提到的任何替代方案
步驟 7：建議測試環境
僅在沙箱環境可用時執行此步驟。如果不可用，請記錄：「沒有可用的沙箱環境 - 建議使用本機 WAR 進行快速重現」。 根據問題特性建議沙箱：
決策邏輯：
分析可用的沙箱環境並建議最合適的。
參考：Read .claude/memory/sandbox-environments.md 以取得連線詳細資訊（如有需要）
請勿在此技能中連線至沙箱 - 僅提供建議。
步驟 8：產生結構化摘要
以以下格式提供調查結果：
# 調查摘要：<客戶名稱> - <問題描述>
## 客戶上下文
- **檔案：** [已找到/未找到]
- **環境：** [雲端/本地部署、版本、規模]
- **過往問題：** [相關歷史記錄（若有的話）]
## 知識庫發現
### 相近調查案例
- [investigation-file.md](path) - <簡短摘要>
- [狀態：已解決/替代方案/進行中]
### 相關最佳實踐
- [best-practice-file.md](path) - <簡短摘要>
## 文件狀態
- **已記載：** [是/否/部分]
- **參考資料：** [檔案路徑與行號]
- **關鍵細節：** [相關組態、限制或指導]
## 程式碼分析
- **元件：** [類別/方法名稱]
- **行為：** [實際實作行為]
- **來源：** [file_path:line_number]
## 外部追蹤系統狀態
### GitHub Issues
- rundeck/rundeck#<number> - <摘要> [狀態]
- rundeckpro/rundeckpro#<number> - <摘要> [狀態]
### Jira Issues
- RUN-<number> - <摘要> [狀態、修正版本（如適用）]
## 建議測試環境
**環境：** [AWS EKS / AWS EC2 / 本機 WAR / PDT-RDTAM]
**原因：** [資料庫類型 / 問題特性 / 測試需求]
**連線：** 請參閱 .claude/memory/sandbox-environments.md
## 後續步驟
1. [立即行動項目]
2. [測試建議]
3. [客戶溝通指引]
## 相關資源
- 客戶檔案：[路徑（若存在）]
- 調查案例：[相關檔案列表]
- 最佳實踐：[適用的指南列表]
- 文件：[關鍵文件頁面]
品質指引
力求詳盡但簡潔：
- 不要包含所有搜尋結果 - 優先呈現相關發現
- 所有參考資料請標示檔案路徑（例如
investigations/2026-03-15-issue.md:45） - 清楚標示未知項目（「未找到類似案例」而非模糊陳述）
提供可操作見解：
- 不要僅列舉發現 - 應綜合歸納模式
- 若多個調查案例都顯示相同的解決方案，請重點強調
- 若文件與程式碼衝突，請明確標示
考慮客戶上下文：
- 根據客戶環境（雲端 vs 本地部署、版本）調整建議
- 若有相關模式，可參考其過往問題
- 調整測試環境建議以符合其設定
錯誤處理
若找不到客戶：
- 在沒有客戶上下文的情況下繼續調查
- 記錄：「若為重複接觸，建議建立客戶檔案」
若無知識庫結果：
- 嘗試使用更廣泛的搜尋詞
- 記錄：「新問題 - 解決後建議記錄為調查案例」
若外部追蹤系統無法使用：
- 記錄工具失敗
- 使用可用資訊繼續
- 建議手動檢查：「GitHub 搜尋失敗 - 請手動檢查 rundeck/rundeck 問題」
若問題描述不明確：
- 盡力使用可用關鍵詞
- 記錄：「問題描述不明確 - 搜尋範圍涵蓋：[列出使用的詞彙]」
- 建議：「使用具體的錯誤訊息或元件名稱來縮小搜尋範圍」
步驟 9：記錄調查
在完成調查並呈現摘要後，建立新的調查檔案來記錄發現：
建立檔案：
investigations/YYYY-MM-DD-簡短-連字號-分隔-描述.md
使用範本： Read investigations/TEMPLATE.md 以取得結構
填入內容：
- 標題： 問題的簡短描述
- 日期： 今天的日期（YYYY-MM-DD 格式）
- 客戶： 調查中的客戶名稱
- 產品領域： 相關元件（webhook、工作、節點等）
- 標籤： 從相近調查案例中發現的標籤，加上問題特定標籤
- 問題陳述： 使用者提供的問題描述
- 環境詳細資訊： 來自客戶檔案（若找到）
- 調查步驟： 已執行的搜尋步驟摘要
- 根本原因： 若在調查過程中識別出來
- 解決方案/解決方法： 若在知識庫或文件中找到
- 相關文件： 搜尋過程中發現的參考資料
- 程式碼/文件參考： 來自搜尋結果的檔案路徑與行號
- 備註/學習： 調查過程中的任何模式或見解
建立檔案後：
- 使用新的條目更新
investigations/INDEX.md：- 新增至適當的分類區段
- 新增至時間順序表格
- 在「依標籤快速搜尋」區段新增標籤
- 更新「最後更新」日期
備註
- 調查會在知識庫中建立永久記錄
- 平均執行時間：30-60 秒搜尋 + 2-3 分鐘文件記錄
- 所有發現皆為研究性質 - 仍需在建議環境中進行實際測試
- 若需策略定位建議，請另行呼叫
Read .claude/memory/tam-advisory-philosophy.md - 文件記錄可確保知識被捕捉並可供未來調查搜尋使用