explain-mr

替一份改動（工作區 diff、branch、MR／PR）排一條「從最外層入口一路往下讀」的閱讀路線，每站附可點的檔案:行號與這站要看什麼。使用者說「我要讀這次的修改」「從入口往下讀要怎麼讀」「帶我讀這個 diff」「這些改動要從哪裡開始看」時使用。

隔離工作流：從當前 HEAD 切 temp branch、在 repo root 外開 worktree（帶 .env、複製當前對話讓新視窗可 resume）、session 嚴格鎖定只在 worktree 內活動、結束時詢問是否 cherry-pick 回原 branch 再清理。使用者輸入…

任何最終會被人讀到的產出——程式碼註解、commit message、PR/MR 留言、設計文件、教學筆記、code review finding、session 回話——都要讓讀者只憑他手上真的有的東西讀懂。三條規則：① 只引用讀者手上有的東西（不准指…

把「只在本機／測試環境才要有」的 debug 改動（例如印出 req/res body）套進當前 repo，並單獨包成一個 temp commit，測完可以整包丟掉。也負責維護這份 debug 改動清單：使用者說「再加一個測試用改動」「記下這個 debug patch」時，把新的一筆寫進 catalog。觸發：套…

跟使用者在他的程式碼專案做「非瑣碎」開發時，AI 該採用的協作姿態。 當要實作新功能 / 模組、做建模・抽象・型別・分層・架構決策、改既有 code、或一起 review 設計時務必觸發—— 即使他只說「幫我做 X」「幫我看一下」沒提到「協作」「設計」。核心六件事： ① 先診斷對齊、不要急著產…

用 Jira Cloud REST API v3 查詢與操作 issue。當使用者提到 Jira、要建立 / 更新 / 查詢 issue、跑 JQL、加 comment、轉狀態（transition / 移到 Done / In Progress）、貼一個 Jira issue 連結或 issue key（如…

Daniel 的實用工具設定集——每個工具一份 reference 文件，內含完整設定步驟、原理解說與踩雷排查。當使用者想「設定／重建／排查」以下工具時觸發：claude-code-notifications（Claude Code 的 macOS 通知，含兩種：Stop 事件的「回覆完成通知」與…

用「從已知推導未知」的依賴關係優先教學法帶使用者學習任何新主題，並維護兩份 Markdown 檔：大綱檔（進度追蹤＋各階段追問清單）與 summary 檔（每階段完成後的完整知識筆記），隨進度持續更新。當使用者說「教我」「我想學」「幫我理解」某個概念或主題、想循序漸進地搞懂某個東西、或希望追蹤自己學到哪裡時，就使用這…

逐項 review 一份改動——本地 branch diff、GitHub PR、GitLab MR、或指定路徑皆可。先讀懂改動目的，再把 12 個面向（可讀性 / 註解 / DRY / 單一職責 / 耦合內聚 / 擴充性 / 函式控制流 / 型別與資料形狀 / 錯誤處理 / API 健壯性 /…

在 GitHub PR 或 GitLab MR 的指定程式碼行上發、改、刪 inline review comment。處理 commit SHA 取得、行號錨定（新增／刪除／未變動行各有規則）、以及「行號必須以整數送出」這個會讓留言被靜默降級成一般留言的踩雷點。

Code review 問題的呈現格式規範——每項含位置、問題、🗣️ 白話情境（用具體小例子演一遍怎麼踩到，以「預期 vs 實際」收尾）、建議解法。當要輸出 review 結果、寫 PR/MR 留言、或把技術問題解釋給非作者看時使用。

根據 git staged/unstaged changes 撰寫 commit 訊息並提交