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.2 KiB
3.2 KiB
tasks-project-projection — Tasks
權威來源:此檔案是進度真相,不是 CLAUDE.md 或對話。 規則:動手前標 [🔄],完成立刻標 [x],不批次更新。 來源:issue #16;design.md 同目錄。
Phase 1:投影 workflow + 本地觸發端(template 側,可獨立)
Tasks
-
1.1 寫投影 workflow yaml(
template/system-dev/workflows/tasks-project-sync.yaml)- 驗收:
foreach增量 →switch動作 → 四動作(create/close/edit/archive)+ Projects v2;acr validate --offline過;每個 component 經acr parts核實存在。 - 注意(已踩坑):arcrun 沒有
github零件,打 API 一律component: http_request;credential 引用{{creds.github_token}}(非{{secret.}})。
- 驗收:
-
1.2 寫本地觸發端(
tasks-project-sync.local.sh)- 驗收:讀 tasks.md / git diff / 分類四動作 /
acr run -i餵增量 / 回寫 id 的骨架就位;薄殼、不自刻 parser(複雜分類交 CC)。 - 注意:arcrun 跑遠端 CF Workers 無本地 fs/git,這三件本來就歸本地端,非 arcrun 缺口。
- 驗收:讀 tasks.md / git diff / 分類四動作 /
Phase 2:裝/init 對話 + 一次性廣告 + 帶檔
-
2.1 install.sh 加裝/init 對話指引 + 一次性廣告 + 隨 SDD 模組帶 workflow 檔
- 驗收:
bash -n過;下一步段有「問一句→查 arcrun 能力→有就設定/沒有就一次廣告」;帶檔 ≠ 啟用。
- 驗收:
-
2.2 update.sh 隨 SDD 模組
add_if_missingworkflow 檔 + chmod- 驗收:
bash -n過;覆蓋不會關掉誰的同步(啟用狀態存遠端)。
- 驗收:
-
2.3 README(中英)標 optional 模組 + bump 1.13.0 + CHANGELOG
- 驗收:兩份 README 對稱;VERSION 兩檔同步 1.13.0;CHANGELOG 記 http_request 修正與核實紀律。
Phase 3:端到端驗證(待連 arcrun 後端的人)
前置條件:Phase 1、2 完成(已完成)
-
[!] 3.1
acr creds push(github_token)+acr push(部署 workflow)+acr run(真打通 GitHub)- 阻擋:本 repo 沒
.arcrun.yaml、沒連 arcrun 後端,跑不了端到端。待 leo21c(連了 arcrun 的環境)。 - 驗收:真建一個 issue + 投影進 Project 成功;Projects v2
addProjectV2ItemById的 content node id(非 issue number)實測確認;github API 回傳欄位形狀({{gh_create.node_id}}取法)確認。
- 阻擋:本 repo 沒
-
[!] 3.2 本地觸發掛載點 + id 回寫防迴圈定稿
- 阻擋:依賴 3.1 的真跑結果。
- 驗收:push 後本機觸發一次(非 cron/Actions);回寫
<!-- gh:id -->的 diff 不得再觸發一輪。
完成定義
整個 SDD 完成 = 以下全部達成:
- Phase 1、2 所有 tasks 標 [x](template 側 code-done)
acr parts核實所有 component 存在 +acr validate過(客觀證據)- [!] Phase 3 端到端通過(待 leo21c)→ 未完成,不宣布 done
- design.md 與實作一致(端到端驗後若 API 細節有出入需回頭更新 design.md)
狀態說明
| 標記 | 意義 |
|---|---|
[ ] |
未開始 |
[🔄] |
進行中(當前 session) |
[x] |
完成(有驗收證據) |
[~] |
暫緩(說明原因) |
[!] |
阻擋中(說明阻擋原因) |