Files

T

jiantw83andClaude Opus 5 9ed719a4d7 fix(pr-create): 錶沒在跑時 409 與 500 都不算失敗

Gitea 回「cannot stop a non-existent stopwatch」時用的狀態碼隨站台而異：這台回 409，
而腳本只認 500。結果是 PR 已經開出去了，卻以 exit 1 與 HTTP_ERROR 收場——照它自己
寫下的理由，那會讓人以為 PR 沒開成而重跑一次。三次重現（議題 #41、#50、#42）。

認的是「狀態碼在 409/500 這一組 **且** 訊息說的是碼錶」：只看訊息會把真的伺服器錯誤
一起吞掉，只看狀態碼會把別的衝突也當成沒錶。兩種狀態碼各一條測試，另加一條
「訊息對不上的 409 照常拋出」。

README 與 AGENTS.md 的「六個流程正本尚未到齊」也一併改掉——六份都在了，那句話會讓
使用者以為裝了也沒指令可用，在 AGENTS.md 裡還會誤導下一個 agent。並補一條測試把說法
與 prompts/ 的實際份數釘在一起，免得下次又走鐘。

議題 #54

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-09-17 17:46:43 +08:00

3.5 KiB

Raw Blame History

tea-sdlc — 以 tea 驅動 SDLC 全流程的跨平台指令組

本 repo 提供六個顯式指令（/sdlc-plan、/sdlc-analyze、/sdlc-feat、/sdlc-fix、/sdlc-sync、/sdlc-report），把軟體開發流程的各階段固定成可重複的步驟。流程正本只寫一份平台中立 markdown，由 scripts/install.js 產生 Claude Code、Codex、Antigravity、Copilot、Kiro、oh-my-pi、OpenCode 各自的薄轉接檔。

本 repo 以 npm 佈署：npm i -g <git url> 裝出 tea-sdlc 指令，tea-sdlc install 產生各平台轉接檔。轉接檔裡沒有路徑，只有一句 tea-sdlc prompt --name <指令名>，正本在哪由入口自己回推。

六個流程正本都到齊了；安裝器佈署的就是 prompts/ 裡的那六份。進度見議題 #1 底下的工作包。

模組邊界

改動時請先確認要動的東西屬於哪一層，不要讓職責外溢到相鄰目錄。

目錄	職責	邊界
`prompts/`	流程正本（`sdlc-{plan,analyze,feat,fix,sync,report}.md`），唯一的事實來源	平台中立 markdown，不含任何平台專屬語法
`scripts/`	所有副作用（Gitea API、git、檔案系統）的唯一出口	Node、零外部套件，僅用內建 `fetch` / `child_process` / `fs`
`templates/`	所有產出格式（議題、PR、報表、總覽網頁）	以 `{{變數}}` 佔位，不含邏輯。唯一例外是 `overview-artifact.html`：它是一份要在瀏覽器裡開的網頁，需要一段把 mermaid 圖畫出來的腳本
`references/`	規則正本（實作規範、註解格式對照表、可行性檢查清單）	由流程正本指名讀取，不自行散落於 prompts
`bin/tea-sdlc.js`	指令入口：取走子指令，其餘 argv 原樣交出去	不含任何平台目錄知識，也不自己動手做事
`scripts/install.js`	平台偵測與轉接檔產生／移除	唯一知道各平台目錄結構的地方
`skills/`	各助理原生 plugin 機制讀取的 skills	目前為空；指令以轉接檔形式佈署

慣例

零外部套件：package.json 不得出現 dependencies 或 devDependencies。測試用 Node 內建 node:test + node:assert。
契約以議題為正本：腳本的 flag 介面、JSON 輸出形狀、前置檢查與路徑定位規則，正本在議題 #1，實作時以該處為準；本檔不複寫，以免兩邊走鐘。
測試：npm test（等同 node --test）。測試產生的暫存一律寫到 .tmp/，該目錄已被 git 忽略，也不會被測試探索掃到。
不改目標專案：本 plugin 只讀目標專案的程式碼，不寫入目標專案的 CLAUDE.md 或任何設定檔。唯一的例外是 git 自己的內部中繼資料——git worktree add 一定會在目標 repo 的 .git/worktrees/ 底下寫東西，那是 git 的機制，無法避免，也不是專案的內容檔。
工作樹集中在家目錄：每顆工作包的工作樹開在 ~/.tea-sdlc/worktrees/{hash}，路徑由 owner/repo/分支名 純函式推導（scripts/lib.js 的 worktreePath），不查表也不寫狀態檔。不開在目標專案裡（會出現在它的 git status），也不開在它的兄弟目錄（那個目錄結構屬於使用者）。
不自動觸發：所有指令僅由使用者明確叫用；skill/command 的 description 統一以「僅由 /sdlc-xxx 指令叫用。」起頭。

3.5 KiB Raw Blame History Unescape Escape

tea-sdlc — 以 tea 驅動 SDLC 全流程的跨平台指令組

模組邊界

慣例

3.5 KiB

Raw Blame History