prep-repo

# Prep Repo > **English summary:** Prepare releases with scope-appropriate checks. Technical documents default to Traditional Chinese with an English summary for GitHub; explicit language requirements are acceptance criteria, while separate bilingual READMEs retain their languages. 先判斷這次要交付什麼，再檢查它能否安全、正確地公開。真正的機敏外洩、不可執行的安裝指引、錯誤的功能宣稱需要修；未約定的格式偏好不應讓已可交付的工作無限延長；使用者明確指定的語系／摘要格式屬於驗收要求，不能降級成可略過的修飾。 ## 範圍與分工 - 從使用者要求、repo 規範與實際檔案確認目標、visibility、交付物及已有授權。已講清楚的決定不重問；資訊確實不足才釐清。 - 先查 working tree、branch、remote、現行 README／安裝方式與發布流程，保留無關的 dirty changes。只修改此次授權的 repo／檔案；多 repo 任務各自核對範圍。 - 私庫與公開匯出分開處理；不要因為準備 OSS 就把私庫改 public、複製整條 private history，或把私人操作手冊當公開文件。 - 既有系統缺技術文件可用 `project-docs`（`doc-qa` plugin）；新功能設計走 `spec`，根因不明的 bug 走 `diagnose`。不要把簡單文件修正升級成整套工程流程。 ## 先分類，再修正 | 結果 | 判準 | 處理 | | --- | --- | --- | | 阻擋發布 | 具體機敏外洩、預定交付物無法安裝／使用、必要驗證失敗、重要功能或安全宣稱失實 | 提供證據、影響和最小修法，修正並驗證後才發布 | | 待確認／未驗證 | 疑似敏感值無法判定、缺少必要權限或環境、工具失敗／跳過 | 說明缺口；必要檢查未完成不能寫成通過 | | 一般改善 | 無功能影響的命名、badge、措辭或排版偏好 | 按範圍和成本調整，不當作新 gate | | 不適用 | 此交付物沒有該能力或契約 | 註明理由，不為填 checklist 新增能力 | 沿用使用者／repo 的嚴重度定義；沒有定義時不要把所有 blocker 都叫 P0。第一輪合併回報已知問題；修正後重驗受影響項與整體發布檔案邊界，不重跑沒有新理由的全部檢查，也不每輪追加無關修飾。遵守使用者指定的修正輪次與停止條件；沒有指定時，以能否提出有證據、不同於已失敗嘗試的最小修法決定是否繼續。反覆無進展就回報殘餘問題，不宣稱收斂。 ## 依交付物挑檢查 | 檢查面 | 要確認的事 | 不要機械套用的要求 | | --- | --- | --- | | README | 用途、成熟度、必要依賴、可重現的 quick start、限制與文件入口符合現況；重要目錄樹與實際檔案相符 | 標題可以是專案名稱；趣味標題、固定位置 badge 不是必要條件 | | 語言與導覽 | 技術文件預設正體中文（臺灣用語）；發布到 GitHub 的文件開頭放簡短英文摘要，正文用正體中文。私庫去敏匯出也沿用此規則。雙語 README 維持英文版／中文版內容同步與互連，本 repo 使用 `RE...