ADHD PR 描述
此儲存庫的預設 PR 主體格式。 審查者應能一瞥即理解描述內容。差異已在 GitHub 上 — 請勿重複陳述檔案移動。
代理：在撰寫或改寫 Nakama PR 描述時（包括透過 ce-commit-push-pr）載入此技能。主體形狀由此提供；仍需從差異中收集真實聲明（結果、風險、你驗證的內容）。
形狀（必填）
## 摘要
<一行：誰做了什麼 → 結果。除非變更本身就是術語，否則避免術語迷霧。>
**Before：** <一行 — 舊行為或成本>
**After：** <一行 — 新行為；如有助於風險評估，請指名關鍵函式/路徑>
為什麼安全：
1. <理由>
2. <理由>
3. <理由> <!-- 最多 2–3 項；若無內容可說則刪除第 3 項 -->
僅在 <一個殘留風險或回滾觸發條件> 時才重新加入/跟進。
## 測試計劃
- [x] <已執行的命令>（<N> 次通過）
- [ ] <人類可在 <2 分鐘> 內完成的一次手動檢查>
測試計劃後可選（若工作流程預期 Compound Engineering 徽章則保留）：
---
[](https://github.com/EveryInc/compound-engineering-plugin)
規則
- 開頭 = 結果。 摘要第一行是新世界，而非「此 PR 移除了…」。
- Before/After = 兩行。 粗體標籤。不用段落包裹它們。
- 為什麼安全 = 編號，≤3。 主體中任何位置的總項目符號上限為 5；若超過，只保留能改變決策的項目。
- 一個殘留風險。 指出會讓你撤銷此變更的情況。若完全沒有則跳過。
- 無差異旅遊。 不要列出檔案、行數作為故事主體，除非那就是風險本身。
- 測試計劃 = 可執行。 偏好勾選的命令和通過次數；一個未勾選的手動探查。
- 標題維持慣例。
type(scope): imperative— 簡短。主體採用此形狀；標題不需要表情符號或論文。 - 使用
gh套用。 將主體寫入暫存檔；gh pr edit <n> --body-file …或gh pr create --body-file …。切勿使用--body "$(cat …)"。
黃金範例
比照此密度：
## 摘要
核准一個組織記憶提案 → 子彈進入 `MEMORY.md`。無 LLM 呼叫。
**Before：** 確定性合併，然後可選的模型重寫整個檔案。
**After：** 僅確定性合併（`applyApprovedOrgMemoryBullet`）。
為什麼安全：
1. 去重 + 取代已存在於該函式中
2. LLM 路徑已失敗關閉至確定性結果
3. −230 行，相同的核准結果
僅在矛盾的子彈開始存活於核准後時，才重新加入 LLM 重寫。
## 測試計劃
- [x] `bun test packages/agent/src`（80 次通過）
- [x] `bun test apps/server/src/services/org-memory-service.test.ts`（15 次通過）
- [ ] 核准一個待決提案（釘選 + 最近日誌）— 子彈如之前般落地
反模式
| 不要這樣做 | 請這樣做 |
|---|---|
| 多段落摘要 | 一行結果 + Before/After + 為什麼安全 |
| 「此 PR 旨在…」/「為了…」 | 以動詞或用戶動作開頭 |
在 Summary 下巢狀 ### | 僅扁平 ## 摘要 + ## 測試計劃 |
| 重複每個已刪除的檔案 | 僅殘留風險 |
| 模糊的「測試通過」 | 確切命令 + 通過次數 |
工作流程
- 閱讀 PR 差異 / 提交記錄（
gh pr view、git diff base...HEAD） - 命名：結果、before、after、≤3 為什麼安全、一個殘留風險
- 填寫模板 — 刪除差異已證明的任何句子
- 透過
--body-file套用 - 回覆 PR URL（加上「若需要調整標題請告知」僅在有用時）