前言¶
選課季常見情況是：必修課、選修、實驗課分散在不同星期和節次，人工對照教務截圖或 Excel 很容易漏掉「同一上午有兩門課重疊半小時」這類問題。自己寫腳本要處理時間區間、星期、單雙週等格式，維護成本也不低。
下面介紹 SkillHub 社區 Skill「課程表衝突檢測」（座標 @user_70c2f807/course-schedule-conflict-detector）。它通過標準 SKILL.md 約束 Agent 的輸入收集、逐對比對和報告輸出，把課表衝突檢測和可視化說明固化成可複用流程；它不接入教務系統，也不做學分或選課推薦。
這是什麼¶
「課程表衝突檢測」是面向教育場景的 Agent Skill，當前版本 1.0.1，來源爲 community，發佈者爲 user_70c2f807，分類爲 education。平臺標籤標明 requires_api_key=false，安裝後無需額外 API Key。
Skill 在對話中於用戶提到課程衝突、選課衝突、課表檢測，或英文表述 course conflict、schedule conflict、class overlap 等場景下觸發；明確不用於課程推薦、選課建議、學分計算。
官方頁面與安裝入口：
- SkillHub：https://www.skillhub.cn/skills/user_70c2f807/course-schedule-conflict-detector
- API 元數據地址：https://api.skillhub.cn/user_70c2f807/course-schedule-conflict-detector
（SkillHub 頁面顯示評分 100000，下載 990 次；與腳本抓取資料一致。）
核心功能¶
以下能力均來自 Skill 包內 SKILL.md 的說明：
- 衝突檢測：對任意數量課程做時間區間逐對比較，識別同一星期、同一時段的重疊，並計算重疊時長（分鐘）。
- 嚴重程度排序：按衝突輕重排序，便於先處理影響面大的重疊。
- 周課表總覽：以表格形式展示一週課表，標註衝突位置。
- 調整與組合建議：在全局無新衝突的前提下，給出可調方向；支持窮舉無衝突組合、或爲新增選修尋找空閒窗口。
- 結構化報告：固定輸出課表衝突檢測報告模板，包含課程總數、衝突處數、衝突詳情、調整建議與空閒時段說明。
Skill 強調只分析時間維度，不評價課程質量，不存儲課表，不連接學校教務系統。
安裝與啓用¶
方式一：SkillHub CLI（推薦）¶
先確認本機已安裝 skillhub（安裝方式見 https://skillhub.cn/install/skillhub.md ）。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。
skillhub install course-schedule-conflict-detector --namespace user_70c2f807 --dir <你的 Agent skills 目錄>
常用目錄示例（與官方安裝文檔一致）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝完成後按所用客戶端要求重啓或刷新 Agent，使 Skill 被加載。
方式二：讓 AI 按官方提示安裝¶
SkillHub 頁面提供的安裝提示爲：根據 https://skillhub.cn/install/skillhub.md，安裝 @user_70c2f807/course-schedule-conflict-detector。適合尚未配置 CLI、但已在 Cursor 等環境中與 Agent 對話的場景。
典型用法¶
Skill 要求用戶提供儘量完整的課程信息：課程名稱 + 星期 + 起止時間；若有單週/雙週或前八週等限制，需一併說明。
示例 1：基礎衝突檢測
用戶輸入：
高數 週一三五 8:00-9:30，英語 週一三 9:00-10:30，物理 週二四 10:00-11:30
Agent 按 Skill 流程統一時間格式、逐對比較後，應指出例如高數與英語在週一、週三 9:00–9:30 存在 30 分鐘重疊，並生成周課表表格與衝突詳情塊。
示例 2：加課找空檔
用戶說明已選課程並詢問「加一門選修哪個時段不衝突」時，Skill 要求分析空閒時段並列出可插入的時間窗口；替代時段是否可選，需用戶自行在選課系統覈實。
示例 3：信息不全時的處理
僅提供一門課、或時間格式混亂時，Skill 規定應提示補充完整課表或統一爲「課程名 星期X 8:00-9:30」一類格式，而不是給出不可靠的衝突結論。
輸出結構遵循 Skill 中的「課表衝突檢測報告」章節：總覽表、分條衝突說明（含重疊分鐘與影響天數）、調整方案與空閒時段列表。
適用場景與注意¶
適合誰
- 大學生、研究生在選課窗口需要快速覈對多門課是否撞車。
- 教務助理、輔導員在幫學生改選時，需要把文本課表整理成可讀衝突報告。
- 已在 Cursor / Claude Code 等環境使用 Skills、希望用自然語言驅動檢測而非自寫腳本的用戶。
限制與坑
| 點 | 說明 |
|---|---|
| 輸入完整性 | 缺課程或缺時間會直接導致漏檢；實驗課、體育課同樣要列入。 |
| 無系統對接 | 不能導入教務後臺，也不能代選課；只能基於用戶粘貼的文本分析。 |
| 替代方案 | Skill 給出的調課建議需在選課系統中確認班次是否開放。 |
| 考試安排 | 不適用考試時間衝突，需聯繫教務。 |
| 周次複雜 | 單雙週、分段周次需用戶標註，否則可能誤判。 |
最佳實踐上，Skill 建議先固定必修課再排選修，連續課之間預留換教室緩衝，並標明哪些課不可動以便建議更貼合實際。
結尾¶
「課程表衝突檢測」把課表衝突檢測、量化重疊、表格化周視圖和可調方案寫進 Agent 工作流，適合選課階段用對話完成排查。安裝與詳情以 SkillHub 爲準：https://www.skillhub.cn/skills/user_70c2f807/course-schedule-conflict-detector
