Files
system-dev-template/docs/3-specs/tasks-project-projection/tasks.md
T
Leo 2a8c259d08 依 D22 翻正舊 ignore 政策:本 repo 自己的 SDD 進版控 + 新增 jdd-dual-profile 卷
🔴 修的病:這個框架 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>
2026-08-05 23:22:14 +08:00

3.2 KiB
Raw Blame History

tasks-project-projection — Tasks

權威來源:此檔案是進度真相,不是 CLAUDE.md 或對話。 規則:動手前標 [🔄],完成立刻標 [x],不批次更新。 來源:issue #16design.md 同目錄。


Phase 1:投影 workflow + 本地觸發端(template 側,可獨立)

Tasks

  • 1.1 寫投影 workflow yamltemplate/system-dev/workflows/tasks-project-sync.yaml

    • 驗收:foreach 增量 → switch 動作 → 四動作(create/close/edit/archive+ Projects v2acr validate --offline 過;每個 component 經 acr parts 核實存在
    • 注意(已踩坑):arcrun 沒有 github 零件,打 API 一律 component: http_requestcredential 引用 {{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 缺口。

Phase 2:裝/init 對話 + 一次性廣告 + 帶檔

  • 2.1 install.sh 加裝/init 對話指引 + 一次性廣告 + 隨 SDD 模組帶 workflow 檔

    • 驗收:bash -n 過;下一步段有「問一句→查 arcrun 能力→有就設定/沒有就一次廣告」;帶檔 ≠ 啟用。
  • 2.2 update.sh 隨 SDD 模組 add_if_missing workflow 檔 + chmod

    • 驗收:bash -n 過;覆蓋不會關掉誰的同步(啟用狀態存遠端)。
  • 2.3 README(中英)標 optional 模組 + bump 1.13.0 + CHANGELOG

    • 驗收:兩份 README 對稱;VERSION 兩檔同步 1.13.0CHANGELOG 記 http_request 修正與核實紀律。

Phase 3:端到端驗證(待連 arcrun 後端的人)

前置條件:Phase 1、2 完成(已完成)

  • [!] 3.1 acr creds pushgithub_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}} 取法)確認。
  • [!] 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] 完成(有驗收證據)
[~] 暫緩(說明原因)
[!] 阻擋中(說明阻擋原因)