القائمة
夜讀 Night Reader 的 Codebase Atlas — 導航地圖與變更紀律。在調查或編輯此專案程式碼前使用。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | night-reader-atlas |
| description | 夜讀 Night Reader 的 Codebase Atlas — 導航地圖與變更紀律。在調查或編輯此專案程式碼前使用。 |
自包含入口與路由器，供本專案日常工作使用。自帶紀律——無需另讀工作流程文件。
../../../docs/night_reader_index.md 一次，接著用一句白話確認本專案做什麼。從 atlas 加最少必要作碼回答；區分確認事實與假設/未知。絕不編輯——若需修正，在使用者同意後交給 Change。依問題性質套紀律：除錯=重現→排序假設→二分；review=對著 owning/boundary 模組讀 diff；開放設計問題=一次一題訪談、各附推薦答案，比對索引與 Architecture Decisions 表——標記任何與已記責任/邊界衝突或重開已錄決策的提案。
注意本專案特性：閱讀器 Reader V2 與 Source Manager 為重點回歸區；書源驗證涉 WebView/Cookie，易只真機復現，優先用 tool/ 腳本重現；後台 Isolate 不可執行 JS 規則。
判斷紀律層級並調整 effort：
docs/changes/planning/{{DATE}}-{{SLUG}}.md（{{DATE}} = 今日本地日期，ISO YYYY-MM-DD）。硬底線： 不可逆、跨模組、外部 API、遷移工作至少 T2。可接受「快一點/仔細一點」的白話覆寫，但永不低於底線。
Before / After gate（唯一確認介面）：
T1/T2 編輯任何檔案前等待明確確認。T0（無邏輯變、可逆、單檔）說一行 Before/After 後不等待直接做，做完回報——若 Before 有誤可逆還原。
Decision Gate —— 變更會改模組邊界、外部 API、不可逆或遷移，或有兩個以上可行方案時：先查提案是否與索引或 Architecture Decisions 表中已錄者衝突或重開——若是，點名並確認正在重開舊決策。然後給 Context / Options（A/B 含取捨）/ Recommendation，在 Before/After 前等待選擇。跨模組決策錄入索引的 Architecture Decisions 表；模組層錄入該模組 Known Risks。
編輯後依層級驗證；驗證結果一律入報告——不在失敗的 check 上宣稱完成。完成後把 plan 移到 docs/changes/completed/{{DATE}}/{{SLUG}}.md，並在當日 docs/changes/completed/{{DATE}}/summary.md（當日工作摘要）附一行。僅當模組邊界、歸屬或外部 API 變動才更新 atlas 文件——增量更新，不重掃。
驗證指令：flutter analyze、flutter test；書源相關變更用 tool/ 驗證腳本。schema 變更需 dart run build_runner build。本機不做 build；APK 建置與發布一律在 GitHub Actions。