菜单
臺科新生懶人包的貢獻流程。當使用者用自然語言說想改網站哪裡（錯字、用字、過期資訊、失效連結、內容補充、版面問題），或直接輸入 /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 兩個網址交給使用者。