h30190/2026_tut_interior_with_ai_course/course-submit

課程交件

把「commit 確定沒問題再 PR」這件事固化成流程。順序是刻意的：檢查沒過就不 commit，commit 沒成功就不 push。

這支 skill 只住在這個 repo，不安裝到 ~/.claude/skills——它只有上課會用到。

跑法

node scripts/交件.js "20260919 完成油漆用量計算機"        # 交件（不發 PR）
node scripts/交件.js "訊息" --pr                         # 交件並發 PR
node scripts/交件.js "訊息" --dry                        # 試跑，只看會做什麼
node scripts/檢查.js                                     # 只檢查不交
node scripts/測試.js                                     # 改過檢查邏輯後必跑

設定在 設定.json：repo 路徑、學號姓名、remote 名稱、日期資料夾清單。 換學期或換電腦只要改這一份。

全程只用指令

不用瀏覽器點按鈕。發 PR 走 gh pr create，需要：

winget install --id GitHub.cli    # 裝一次
gh auth login                     # 登入一次，要自己跑

gh auth login 涉及帳號認證，一律由本人執行。腳本只呼叫 gh pr create，不碰登入。

PR 標題取 commit 訊息的第一行，內文用整段訊息。 分支上已經有開著的 PR 時，新的 commit 會自動加進去，腳本會告訴你不用重開。

這個 repo 的特殊之處（最容易搞錯的一點）

`origin` 不是你的，是業師的主 repo。你的 fork 叫 fork。

推錯地方會被拒絕，檢查器會先擋下來。

檢查器擋什麼

檢查範圍＝未提交的變更 ∪ 上游還沒有的所有 commit，改名的新舊兩個路徑都算。 2026-10-03 王品洋交叉稽核實證：原本只看 git status，先手動 commit 或用 git mv 把別人的檔案搬進自己資料夾，都能繞過「只准動自己的資料夾」。

提醒（不擋）：分支落後上游、分支名不是 student/A14530068 開頭、沒有變更可交、有 commit 沒 push。

每一條防呆都有對應的失敗情境測試，測試.js 會建假的上游與 fork（本機 bare repo）實際觸發它們。 自報成功不算通過。

交件範圍

git add 的是 設定.json 裡列出的日期資料夾底下屬於你的那一層，只加實際存在的—— 沒上到的課還沒有資料夾，原本會讓整個 git add 失敗。commit 失敗時會把暫存撤回，不留半套狀態。

交件前如果上游有更新

檢查器會提醒落後幾筆。先同步再交比較不會有衝突：

git pull origin main

衝突了就停手找業師，不要硬解——這是課程 README 明寫的。

邊界

• 只動你自己的那一層。別人的資料夾、主 repo 的 README.md／LICENSE 一律不碰，檢查器會擋。
• 不自動 merge、不改 main、不碰 `gh auth login`。
• 交件前如果工作區有你不認得的檔案，先問清楚來源再交，不要照單全收。