Leo
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>
69 lines
3.2 KiB
Markdown
69 lines
3.2 KiB
Markdown
# tasks-project-projection — Tasks
|
||
|
||
> 權威來源：此檔案是進度真相，不是 CLAUDE.md 或對話。
|
||
> 規則：動手前標 [🔄]，完成立刻標 [x]，不批次更新。
|
||
> 來源：issue #16；design.md 同目錄。
|
||
|
||
---
|
||
|
||
## Phase 1：投影 workflow + 本地觸發端（template 側，可獨立）
|
||
|
||
### Tasks
|
||
|
||
- [x] 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.}}`）。
|
||
|
||
- [x] 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 對話 + 一次性廣告 + 帶檔
|
||
|
||
- [x] 2.1 install.sh 加裝/init 對話指引 + 一次性廣告 + 隨 SDD 模組帶 workflow 檔
|
||
- 驗收：`bash -n` 過；下一步段有「問一句→查 arcrun 能力→有就設定/沒有就一次廣告」；帶檔 ≠ 啟用。
|
||
|
||
- [x] 2.2 update.sh 隨 SDD 模組 `add_if_missing` workflow 檔 + chmod
|
||
- 驗收：`bash -n` 過；覆蓋不會關掉誰的同步（啟用狀態存遠端）。
|
||
|
||
- [x] 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}}` 取法）確認。
|
||
|
||
- [!] 3.2 本地觸發掛載點 + id 回寫防迴圈定稿
|
||
- 阻擋：依賴 3.1 的真跑結果。
|
||
- 驗收：push 後本機觸發一次（非 cron/Actions）；回寫 `<!-- gh:id -->` 的 diff 不得再觸發一輪。
|
||
|
||
---
|
||
|
||
## 完成定義
|
||
|
||
整個 SDD 完成 = 以下全部達成：
|
||
- [x] Phase 1、2 所有 tasks 標 [x]（template 側 code-done）
|
||
- [x] `acr parts` 核實所有 component 存在 + `acr validate` 過（客觀證據）
|
||
- [!] Phase 3 端到端通過（待 leo21c）→ **未完成，不宣布 done**
|
||
- [ ] design.md 與實作一致（端到端驗後若 API 細節有出入需回頭更新 design.md）
|
||
|
||
---
|
||
|
||
## 狀態說明
|
||
|
||
| 標記 | 意義 |
|
||
|------|------|
|
||
| `[ ]` | 未開始 |
|
||
| `[🔄]` | 進行中（當前 session）|
|
||
| `[x]` | 完成（有驗收證據）|
|
||
| `[~]` | 暫緩（說明原因）|
|
||
| `[!]` | 阻擋中（說明阻擋原因）|
|