issue 落地留底機制：收到交辦 issue 後用 API 拉進 repo 存底（防 issue tracker 失聯失憶） #1

New Issue

2026-06-30T14:13:02Z

Leo commented

2026-06-30 14:13:02 +00:00

背景

GitHub uncle6me-web 被 suspend 後，過去 arcrun/mira 交辦的 GitHub issue（#8/#11/#13…）全部失聯——那些 issue 是命令歷史/交辦決策的真相源。交辦現遷 Gitea issue，但 Gitea 同樣是單一外部點：哪天掛/搬/token 失效，同樣失憶會再發生（實證：2026-06-30 發 issue 時 Gitea API 多次 timeout）。

核心原則（對齊既有鐵律）

交辦歷史真相源該長在 repo 的 git 裡，隨 repo 走、clone 就在、不依賴 issue tracker 活著。
issue tracker = 對話/通知層；repo 內存底 = 真相源。
這是 HANDOFF.md 的原始精神；遷 issue 後真相源交給外部 tracker 是設計倒退。
對齊 D14 真相源不依賴外部 SaaS / 讀 repo 走 git / rule-must-be-readable。

要做什麼（leo 指定形狀：用 API 原樣拉下來存，不手動誊寫）

template 提供命令/腳本：收到交辦 issue #N 後用 Gitea REST API 拉 title/body/全部 comment，存成 repo 內檔案。
位置/格式（待 design 定）：docs/issues-log/ 或 .agents/issues/，每 issue 一檔 NNN-標題.md，含完整內文+comment+issue URL+拉取時間戳；更新策略要反映 issue 後續變動。
觸發：人/本機發起 refresh（守 flag 紅線，不輪詢）。
整合進 issue-handle skill：收到交辦 issue → 先存底 → 再處理 → 回報。存底是處理第一步。

為什麼放 template

全人共用能力（所有用 template 的 repo 都需交辦留底），非單 repo 特例 → 歸 template，裝 template 就有。

驗收

任一 repo 收到交辦 issue → repo 內出現對應存底檔，git 可追。
Gitea 離線時，clone 該 repo 仍讀得到完整交辦歷史。

交辦來源：InkStoneCo 總管。開在 Gitea（交辦真相源已遷 Gitea）。本 issue 本身就是該被留底的第一個案例。

## 背景 GitHub uncle6me-web 被 suspend 後，過去 arcrun/mira 交辦的 GitHub issue（#8/#11/#13…）全部失聯——那些 issue 是命令歷史/交辦決策的真相源。交辦現遷 Gitea issue，但 Gitea 同樣是單一外部點：哪天掛/搬/token 失效，同樣失憶會再發生（實證：2026-06-30 發 issue 時 Gitea API 多次 timeout）。 ## 核心原則（對齊既有鐵律） - 交辦歷史真相源該長在 repo 的 git 裡，隨 repo 走、clone 就在、不依賴 issue tracker 活著。 - issue tracker = 對話/通知層；repo 內存底 = 真相源。 - 這是 HANDOFF.md 的原始精神；遷 issue 後真相源交給外部 tracker 是設計倒退。 - 對齊 D14 真相源不依賴外部 SaaS / 讀 repo 走 git / rule-must-be-readable。 ## 要做什麼（leo 指定形狀：用 API 原樣拉下來存，不手動誊寫） 1. template 提供命令/腳本：收到交辦 issue #N 後用 Gitea REST API 拉 title/body/全部 comment，存成 repo 內檔案。 2. 位置/格式（待 design 定）：docs/issues-log/ 或 .agents/issues/，每 issue 一檔 NNN-標題.md，含完整內文+comment+issue URL+拉取時間戳；更新策略要反映 issue 後續變動。 3. 觸發：人/本機發起 refresh（守 flag 紅線，不輪詢）。 4. 整合進 issue-handle skill：收到交辦 issue → 先存底 → 再處理 → 回報。存底是處理第一步。 ## 為什麼放 template 全人共用能力（所有用 template 的 repo 都需交辦留底），非單 repo 特例 → 歸 template，裝 template 就有。 ## 驗收 - 任一 repo 收到交辦 issue → repo 內出現對應存底檔，git 可追。 - Gitea 離線時，clone 該 repo 仍讀得到完整交辦歷史。 --- 交辦來源：InkStoneCo 總管。開在 Gitea（交辦真相源已遷 Gitea）。本 issue 本身就是該被留底的第一個案例。

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Leo/system-dev-template#1