技能探索
這是什麼
尋找 SKILL.md、解析 frontmatter，並依平台與執行環境建立可用技能索引的程序。
白話解釋
想像一份只向符合條件的人顯示的職缺：標示「僅限芝加哥」的職位，不會出現在邁阿密求職者的搜尋結果中。技能探索會對所有已保存的技能做同樣的篩選：讀取每份技能宣告的需求，再判斷它此刻是否應該出現在這台機器上的代理面前。
為什麼重要
分散於內建、選用與外掛來源的技能，在使用前都要由 agent/skill_utils.py 走訪來源目錄、讀取各個 SKILL.md 的 frontmatter，再依目前工作階段實際執行的平台篩選。這能避免代理收到不適用於目前平台的指示。frontmatter 若格式錯誤，技能通常會在探索過程中直接消失，而不是明確拋出錯誤。
運作方式
agent/skill_utils.py 會先走訪本機技能目錄，再走訪 config.yaml 指定的外部目錄。iter_skill_index_files 使用 os.walk 掃描，但會略過版本控制、快取與相依套件資料夾，也會略過 references/、scripts/ 等漸進式揭露的支援資料夾，因此只有真正的技能根目錄會進入索引。找到 SKILL.md 後，parse_frontmatter 解析 YAML 標頭；skill_matches_platform_list 將宣告的 platforms 與目前作業系統比對，並特別讓 Termux/Android 符合標記為 linux 的技能；skill_matches_environment 則把 kanban、docker 等 environments 標記與實際偵測到的環境比對。技能若未宣告 platforms 或 environments，會自動通過對應檢查。
具體範例
使用者在 Windows 筆記型電腦安裝 Hermes，技能資料夾裡同時放入朋友以前寫的 iMessage 自動化技能。該技能的 SKILL.md 在 frontmatter 宣告 platforms: [macos]，探索程序讀取後發現平台不符，便不把它列入技能清單或斜線命令，也不顯示錯誤。另一份宣告 environments: [kanban] 的技能同樣保持隱藏；當某個工作階段啟用看板委派後，該工作階段下一次探索便會把它納入。
如何連結
「技能探索」屬於「技能」系列。最直接相關的概念包括：「技能」、「技能生命週期」、「代理執行環境」、「個人作業系統」。這些連結描述教學關係，不取代來源證據。
來源證據
agent/skill_utils.py#<file>— 結構性來源；只確認來源檔關聯，不單獨證明特定呼叫順序。
工作流程
- 目前尚無第一輪工作流程對應；此概念仍透過文章與來源證據出現在知識庫圖譜中。
相關文章
- 目前沒有文章以足夠頻率直接提及此概念名稱或別名，尚未達到提及探勘門檻。