2a8c259d08
🔴 修的病:這個框架 repo 自己的 5 份 SDD 全部被 .gitignore 擋在版控之外, 只活在一台硬碟上——clone 不到、雲端 CC 讀不到、沒備份。SDD 是進度真相源, 「框架 repo 沒吃自己的狗糧」。 依據 D22(已翻案):Gitea private 除機敏值外全 push,雲端工人靠 clone,docs 缺=斷糧; 只有 GitHub mirror 才嚴篩,而 docs 整包已在 github-publish-exclude.txt。 .gitignore 改法:整條擋 → 只擋子項(/*)+ 逐個放行真 SDD。 與 template/ 底下逐位元組相同的自裝副本(TEMPLATE-sdd/、SDD-LIFECYCLE.md)續擋。 新增 docs/3-specs/jdd-dual-profile/(status: draft,等 leo confirm 才升 active): JDD(PM 軌 root/journeys/角色權限/站號 sprint)與雙 profile 合成一卷, 33 條 task/6 phase,每條掛服務哪條 Gherkin(G1–G7)。 新增 hook 6 支、改既有 hook 1 支。**0 行實作**。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
3.1 KiB
3.1 KiB
cross-repo-signing — Design
狀態:已採納 建立:2026-06-26 | 最後更新:2026-06-26 負責人:leo(uncle6me-web) 來源:issue #12(InkStoneCo 總管)
一句話說明
所有 repo(mira / graph-plugin / ingest-plugin / Arcrun / template…)共用 uncle6me-web 一個 GitHub 帳號發 issue/comment,author 全顯示同一帳號、看不出來源;制度化一條鐵律——跨 repo 的 issue/comment 一律在開頭署名 [<本 repo> CC],靠內容層署名溯源。
背景與問題
- GitHub issue/comment 的 author = 發送帳號(gh token),沒有 per-repo 身份這設定。
git config user.name只影響 commit 作者,不影響 issue/comment author。- 給每個 repo 開獨立帳號 = 多帳號自動化 = 踩「避免被 flag」鐵律,不可(見 issue-handle skill 第 3 節)。
→ 身份只能在內容層自報(約定),不是平台層。
現狀:CC 們已部分自發(「## 回報(arcrun CC)」「## 回報(graph CC)」),但靠當次自律、不一致(總管自己也常漏署)。本 SDD 把它制度化:寫成鐵律、一處改全 repo 繼承。
範圍
包含(In Scope)
- 在 template 的 issue 處理指引(
template/.claude/commands/issue-handle.md)加一節「跨 repo 署名鐵律」。 - 因 issue-handle 是「讀/回/結案」的權威指引、所有 repo 透過 template 繼承,這是規則的正確落點。
不包含(Out of Scope)
- 不改 CLAUDE.md(導航牌,不增長;規則細節歸 skill 內文,與既有「採集規則放 skill」一致)。
- 不做任何平台層/自動化(不掛 hook、不改 gh 設定)——純內容約定。
- 不回改各下游 repo 的歷史 comment。
設計
新增第 4 節「跨 repo 署名(鐵律)」於 issue-handle skill:
跨 repo 的 issue/comment 一律在開頭署名
[<本 repo> CC],因所有 repo 共用同一帳號、author 看不出來源,靠內容署名溯源。
- 收件方 CC 回報:
[graph-plugin CC]/[mira CC]/[ingest CC]/[arcrun CC]…- 總管下令/追問:
[InkStoneCo 總管]- 署名放 comment 第一行或標題式開頭(既有「## 回報(graph CC)」即合格)。
放在第 2 節(發給別的 repo)之後、第 3 節(flag 界線)之前——順著「跨 repo 互動」的脈絡。原第 3、4 節順延。
並把第 1 節「讀/回/結案」的 comment 範例帶上署名,讓署名在最常用路徑就被看見(不只躲在後面的鐵律節)。
決策理由
- 落點選 issue-handle skill 而非 CLAUDE.md:CLAUDE.md 是導航牌、明令不增長;issue 互動規則屬 skill 內文,與「採集規則放 skill」同構。
- 內容層而非平台層:唯一不踩多帳號 flag 鐵律的解法。
- 署名格式
[<repo> CC]:沿用 CC 們已自發的形態,降低改變成本;總管用[InkStoneCo 總管]區隔下令角色。
升版
併入下一個 template 版本:1.11.0 → 1.12.0(規範新增、跨 repo 行為改變)。兩個 VERSION 同步。