القائمة
臺科新生懶人包的貢獻流程。當使用者用自然語言說想改網站哪裡（錯字、用字、過期資訊、失效連結、內容補充、版面問題），或直接輸入 /rookie 加上敘述時使用。一律先開 Issue；使用者願意動手才開分支、改檔、建 PR 到 dev 並關聯 Issue，最後盯審查到 5/5。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/NTUST-OpenSource/freshman --skill rookieيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
| name | rookie |
| description | 臺科新生懶人包的貢獻流程。當使用者用自然語言說想改網站哪裡（錯字、用字、過期資訊、失效連結、內容補充、版面問題），或直接輸入 /rookie 加上敘述時使用。一律先開 Issue；使用者願意動手才開分支、改檔、建 PR 到 dev 並關聯 Issue，最後盯審查到 5/5。 |
使用者用中文說「哪一頁怎麼了」，照以下十步走完。repo NTUST-OpenSource/freshman。
GitHub 相關操作一律透過 pr.py（與本檔同目錄），它已處理好 base 分支、reviewer、審查狀態判定：
pr.py open --title T [--issue N] [--body B] [--label L] # 建 PR 到 dev 並回報實際結果
pr.py trigger <PR> # 沒在跑才要求一次審查
pr.py status <PR> [--watch] [--interval 秒] [--max 次] # 5/5 且零未解決留言才 exit 0
pr.py threads <PR> # 列出未解決留言與其 thread id
pr.py resolve <PR> --thread ID --reply "說明" # 回覆並標記 resolved
判讀規則沿用上游 greploop skill（`~/.claude/skills/greptile/greploop/`）的契約。
把描述對到實際檔案：
src/content/articles/<slug>.md，網址 /article/<slug>/ 最後一段即檔名calendar-sync skill；版面在 src/styles/、src/layouts/、src/components/；系別清單 src/lib/depts.mjs用字類問題先 grep -rn "台北" src/content/articles/ 確認影響範圍。專有名詞照抄原名（社團名「台灣科大佛學社」就是這樣註冊的）。對不到檔案就問使用者是哪一頁。
一律先開，不管使用者打算不打算自己修。標題寫具體問題，內文指出哪一篇、哪一段，知道正確答案就附上。
gh issue create --repo NTUST-OpenSource/freshman --title T --label L --body B
label 從現有這組挑：bug（錯字、用字、失效連結、過期資訊）、documentation（補內容、新文章）、enhancement（新功能、版面）、question（提問）、help wanted（知道有問題但不知正確答案）、good first issue（適合新手接手）。
記下 Issue 編號。
說不要，或使用者講不出正確答案，就把 Issue 網址給他，到此結束。說要才往下。
git fetch origin && git switch -c fix/dorm-taipei-typo origin/dev
分支名 <type>/<簡短英文說明>，type 與 commit 共用：feat、fix、docs、refactor、perf、chore、ci。沒有寫入權限先 gh repo fork NTUST-OpenSource/freshman --remote --remote-name fork。
把該檔 frontmatter 的 updated: 改成今天。寫作規範：
public/icons/ 的 SVG，圖片放 public/images/<slug>/ 並轉 WebP自訂語法見 docs/spec/SPEC.md，範例見 src/content/articles/prototype.md。
npm run build
動過 astro.config.mjs、src/plugins/ 或 src/content.config.ts 就先 rm -rf .astro node_modules/.astro node_modules/.vite。build 要綠燈才往下。
/code-review
有 finding 就修完再往下。判定為誤判的記下理由，步驟 10 遇到同一件事直接引用。
遵循 Conventional Commits，type(Scope): description，細節補 bullet。純英文，Scope 首字大寫，一件事一個 commit。
.claude/skills/rookie/pr.py open --issue 12 --label bug \
--title "fix(Content): use the standard 臺 form in the dorm address sample" \
--body "$(cat body.md)"
它會 push 當前分支、建 PR 到 dev、帶上 Closes #12、指定 reviewer，然後印出 PR 實際的 base、labels、reviewers 供核對。body 寫改了什麼、依據是什麼、驗證過什麼。
分數 5/5 且零未解決留言，兩個條件同時成立才算完成。 明確告訴使用者這件事。
.claude/skills/rookie/pr.py status 17 --watch
以 run_in_background 執行，PASS 時 exit 0。輸出的 check 是 head commit 上 Greptile check run 的狀態，completed 才會採計分數；score 為 none 代表這一版還沒審完，push 之後出現屬正常。
沒過就這樣處理：
pr.py threads 17 取得每一則未解決留言與其 thread id--watch 會接著印新分數pr.py resolve <PR> --thread ID --reply "說明" 回覆並收掉check 長時間停在 absent（例如審查工具是在這個 PR 開好之後才安裝的），跑 pr.py trigger <PR> 要求一次。
最後把 Issue 與 PR 兩個網址交給使用者。