feat(overview-artifact): 產生可預覽總覽與截圖 fallback #66

2026-09-18T08:02:10Z

jiantw83 commented

2026-09-18 08:02:10 +00:00

摘要

讓分析流程能從結構化資料產生可檢視的 HTML 總覽，並在平台 preview 不可用時產生 SVG/PNG 截圖附件；安裝後可驗證 AI Agent CLI 是否真的找到六個流程指令。

需求議題

略過工作包議題，依使用者指示直接建立 PR。

工作包議題

略過工作包議題，依使用者指示直接建立 PR。

變更內容

新增 scripts/overview-render.js，驗證結構化資料並產生 self-contained HTML、SVG 與 manifest。
新增 scripts/overview-capture.js，支援 Firefox、rsvg-convert、resvg 與自動 fallback。
新增 tea-sdlc sdlc-version 與 tea-sdlc verify。
新增 Claude、Codex、oh-my-pi、OpenCode 的本機 command registry 驗證；無安全 probe 的平台回報 not-supported。
修正 oh-my-pi adapter 落點為 ~/.omp/agent/commands/。
新增 artifact/runtime contract 與相關測試。
更新分析、計畫、實作流程及資產處理規則。

設計重點

JSON 是輸入正本；renderer 負責 schema 驗證與輸出；capture 僅負責將 SVG 或 preview 轉成 PNG。安裝驗證只做本機、非互動、無網路的 registry 檢查；找不到安全 probe 時明確標記 not-supported，不冒充成功。

解決的問題

修正 oh-my-pi 寫入錯誤目錄導致 OMP 找不到 /sdlc-* 的問題。安裝不再只確認 adapter 檔案存在，也會回報 runtime registry 找到的 commands 與 missing commands。

影響的功能

分析總覽產物改由 script 產生 HTML/SVG/manifest。install 成功條件增加 runtime registry 驗證；既有議題、工作包與 PR 流程不變。平台沒有安全 probe 時保留 adapter 並回報 not-supported。

測試結果

npm test
[INFO] tests 868
[INFO] pass 868
[INFO] fail 0

node bin/tea-sdlc.js sdlc-version
{"ok":true,"data":{"name":"tea-sdlc","version":"0.0.1","executable":null,"commands":["sdlc-analyze","sdlc-feat","sdlc-fix","sdlc-plan","sdlc-report","sdlc-sync"]}}

## 摘要讓分析流程能從結構化資料產生可檢視的 HTML 總覽，並在平台 preview 不可用時產生 SVG/PNG 截圖附件；安裝後可驗證 AI Agent CLI 是否真的找到六個流程指令。 ## 需求議題略過工作包議題，依使用者指示直接建立 PR。 ## 工作包議題略過工作包議題，依使用者指示直接建立 PR。 ## 變更內容 - 新增 `scripts/overview-render.js`，驗證結構化資料並產生 self-contained HTML、SVG 與 manifest。 - 新增 `scripts/overview-capture.js`，支援 Firefox、`rsvg-convert`、`resvg` 與自動 fallback。 - 新增 `tea-sdlc sdlc-version` 與 `tea-sdlc verify`。 - 新增 Claude、Codex、oh-my-pi、OpenCode 的本機 command registry 驗證；無安全 probe 的平台回報 `not-supported`。 - 修正 oh-my-pi adapter 落點為 `~/.omp/agent/commands/`。 - 新增 artifact/runtime contract 與相關測試。 - 更新分析、計畫、實作流程及資產處理規則。 ## 設計重點 JSON 是輸入正本；renderer 負責 schema 驗證與輸出；capture 僅負責將 SVG 或 preview 轉成 PNG。安裝驗證只做本機、非互動、無網路的 registry 檢查；找不到安全 probe 時明確標記 `not-supported`，不冒充成功。 ## 解決的問題修正 oh-my-pi 寫入錯誤目錄導致 OMP 找不到 `/sdlc-*` 的問題。安裝不再只確認 adapter 檔案存在，也會回報 runtime registry 找到的 commands 與 missing commands。 ## 影響的功能分析總覽產物改由 script 產生 HTML/SVG/manifest。`install` 成功條件增加 runtime registry 驗證；既有議題、工作包與 PR 流程不變。平台沒有安全 probe 時保留 adapter 並回報 `not-supported`。 ## 測試結果 ```text npm test [INFO] tests 868 [INFO] pass 868 [INFO] fail 0 node bin/tea-sdlc.js sdlc-version {"ok":true,"data":{"name":"tea-sdlc","version":"0.0.1","executable":null,"commands":["sdlc-analyze","sdlc-feat","sdlc-fix","sdlc-plan","sdlc-report","sdlc-sync"]}} ```

jiantw83 added 1 commit 2026-09-18 08:02:11 +00:00

feat(overview-artifact): 產生可預覽總覽與截圖 fallback 867a23497f

admin approved these changes 2026-09-18 08:03:01 +00:00

admin merged commit b35161248c into master

2026-09-18 08:03:06 +00:00

admin deleted branch feat/overview-html-capture/main

2026-09-18 08:03:06 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: plugins/tea-sdlc#66