plugins/tea-sdlc
2
0
Fork 0
Code Issues 3 Pull Requests Actions Releases Activity
67 Commits 1 Branch 0 Tags
4655a30f47b1cb22feb2d2e3bc4fac45f6b3463d
Commit Graph
67 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
jiantw83andClaude Opus 5 fd80d9772a test(issue-extract): 以模板變體覆蓋抽取契約 
解析是整條鏈的上游，解析錯則下游全錯，所以模板變體餵得比別處雜：缺段落、
段落在但列表是空的、checkbox 已勾與未勾、中英混排、編號清單、名詞表只有
表頭、body 全空、出現契約外的段落。

留言的部分驗兩件事：未整併則數只算沒有 +1 的，以及留言內容一個字都不得出現
在輸出裡——後者用整份 stdout 做子字串比對，比逐欄檢查更難繞過。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 05:00:27 +00:00
jiantw83andClaude Opus 5 6254a6b53d feat(issue-extract): 建立需求議題的抽取契約 
下游（分析、實作）唯一的議題讀取管道，存在的理由是「不必吞下整份議題全文」。
輸出契約上的十四個欄位，缺少的段落回傳空值。

只讀 body，不把留言內容納入輸出，但回報未整併的留言則數，好讓下游知道自己是
不是在拿過期的描述做事。已整併的留言由 sdlc-sync 打上 +1 reaction，而 Gitea
的留言物件不含 reaction，只能逐則再查一次——請求數會隨留言數增長，但這個數字
要準。

議題不存在與沒有讀取權分成兩個錯誤碼：前者是輸入錯，後者要去改權限，處置不同
就不該共用一個碼。

Closes #5

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 05:00:27 +00:00
jiantw83andClaude Opus 5 0bac5ee186 feat(議題解析): 把議題 body 的 markdown 解析抽成純函式 
段落切分、列表、兩欄表格三種解析，需求議題與工作包議題共用同一套，
所以獨立成一支不碰網路也不碰檔案系統的模組，而不是塞進 lib。

段落切分會追蹤圍欄狀態：mermaid 或程式碼區塊裡的井字號不得被當成標題，
否則流程圖一畫，後面的段落就全被切碎。

缺段落回傳空值而非報錯——缺段落是模板的正常變體，不是解析失敗。
名詞表以分隔列為界，之後才是資料列，避免把表頭當成一筆名詞。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 05:00:26 +00:00
admin 9c3ba425e0 Merge pull request 'feat/sdlc-plan-requirement-issue/main' (#21) from feat/sdlc-plan-requirement-issue/main into master 
Reviewed-on: #21
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-09-17 04:51:02 +00:00
jiantw83andClaude Opus 5 9b9ab33a53 test(issue-create): 覆蓋建立議題與試跑預覽的契約 
沿用既有接縫：子行程執行、stub server 錄下每一筆請求。涵蓋標籤名稱解析、
未知標籤中止、不碰 labels 的寫入端點、同標題不重建、前後空白視為同一顆，
以及寫入型腳本一樣跑滿前置檢查。

試跑的部分特別驗「預覽要忠實」：預覽的 body 必須看得出標籤會被貼上、標籤
錯字在試跑就該擋下、同名議題已存在時預覽不得預告要建立議題，且全程不發出
任何寫入請求。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:44:47 +00:00
jiantw83andClaude Opus 5 9e57a5db99 test(sdlc-plan): 釘住正本與模板的結構 
正本與模板是檔案而非程式，卻是本工作包實際交付的東西：模板段落順序決定下游
解析得到什麼，正本的平台中立性決定轉接檔能不能一份寫到底。以測試釘住段落
順序、佔位格式、description 前綴、平台專屬字樣的缺席、流程圖的上限，以及
模板不得寫死 mermaid 圍欄。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:44:47 +00:00
jiantw83andClaude Opus 5 3f4e1a683b feat(issue-create): 建立議題，標籤限既有、以標題查重 
標籤以名稱指定，送出前換成 repo 上既有標籤的 id；指到不存在的標籤即中止並列出
可選項目。本工具不具備建立標籤的能力，錯字當場講清楚，不悄悄少貼一個。

以標題查重，同名議題已存在就回傳既有那一顆並把 created 設為 false，讓中斷後
重跑不產生重複議題。先驗標籤再查重：參數打錯要立刻講。

--dry-run 不寫入，但會讀。要讓預覽忠實反映將送出的請求，就得先把標籤名稱換成
id、也得先查過重——否則預覽看起來會建一顆議題，實跑卻是 no-op，或反過來實跑
才爆標籤錯字。同名議題已存在時，預覽的 requests 為空陣列並附上既有議題編號。

body 由 --body-file 讀入後原樣送出，避免長 markdown 擠在命令列上。

Closes #4

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:44:46 +00:00
jiantw83andClaude Opus 5 453cf47188 feat(sdlc-plan): 新增需求議題模板與流程正本 
templates/requirement-issue.md 固定需求議題的九個段落與順序：總覽／背景／
目標／非目標／領域名詞表／流程圖／驗收標準／影響範圍／未決事項。段落順序即
下游 issue-extract 的解析依據，總覽段落預留總覽網頁的連結佔位。

流程圖段落只放佔位、不寫死 mermaid 圍欄：正本允許「乾脆不畫」，若圍欄寫死在
模板裡，不畫時就會在議題頁留下一塊渲染失敗的空 mermaid 區塊。圍欄改由填入的
內容自己帶。

prompts/sdlc-plan.md 是流程正本，平台中立 markdown，不含任何平台專屬語法，
description 以「僅由 /sdlc-plan 指令叫用。」起頭。正本交代：三種輸入來源、
一次問一題且不得替使用者編造、九個段落的填法、Mermaid flowchart 的 12 節點與
8 字上限、標籤只能從 labels-list 挑、寫入前先 --dry-run。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:44:46 +00:00
jiantw83andClaude Opus 5 b0bd061852 refactor(測試): 共用假 Gitea 的啟動與環境變數 
每支測試各自寫一次「啟動 stub、登記 close、組環境變數」已經重複三次，抽到
helpers 之後新增測試檔只要一行。各檔仍保留自己的預設路由，因為那是該檔的
情境設定，不該共用。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:44:45 +00:00
jiantw83andClaude Opus 5 4f542d9c86 refactor(標籤): 把列標籤抽到 lib，讓要貼標籤的腳本共用 
labels-list 與後續要挑標籤的腳本都要打同一個端點，抽成 lib.listLabels 之後
端點只寫在一個地方。順帶把「本專案不建立標籤，這是取得標籤的唯一途徑」寫進
函式註解，讓下一個要加功能的人先看到這條界線。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:44:45 +00:00
admin d417132b4e Merge pull request 'feat/script-contract-preflight/main' (#20) from feat/script-contract-preflight/main into master 
Reviewed-on: #20
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
 2026-09-17 04:32:55 +00:00
jiantw83andClaude Opus 5 4ae097f1e1 fix(腳本契約): 長輸出不再被截斷，查重翻頁加上上限 
process.stdout.write 之後立刻 process.exit 會截斷輸出——stdout 接到 pipe 時
寫入是非同步的。改為等 write 的 callback 回來再退出。實測舊寫法在約 83KB 處
被切斷，新增的回歸測試以 8000 筆標籤覆蓋這條路徑。

findIssueByTitle 的翻頁原本沒有上限，Gitea 若持續回滿一頁就會無限打下去。
加上 200 頁上限，超過即以 DEDUPE_LIMIT 報錯而非無聲回 null——無聲回 null 會
讓呼叫端把既有議題再建一次，正好是冪等查重要防的事。

parseFlags 取值時不再於三元運算式內遞增迴圈變數，改為獨立敘述。

測試工具的 maxBuffer 調高到 64MB：預設 1MB 會在長輸出時砍掉子行程，那是測試
工具的限制而非腳本的問題。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:26:51 +00:00
jiantw83andClaude Opus 5 28dec83498 test(腳本契約): 以子行程與 stub server 驗證契約與四層前置檢查 
測試一律以子行程執行腳本、比對 stdout 的單行 JSON 與 exit code，因為那正是
七個平台共用的實際呼叫方式，不會因內部重構而破碎。

Gitea 以本機 stub server 替身並錄下每一筆請求，藉此斷言「腳本到底發了哪些
請求」——包含 --dry-run 不得發出任何請求、前一層檢查沒過就不再往下打、
寫入權探針不得挾帶任何要寫入的欄位。git 則在 .tmp/ 下的臨時 repo 跑真實
指令，比 mock 可信且成本低。

lib-exports.test.js 是唯一直接 import lib 的例外：冪等查重與 git 執行點在
CLI 邊界上還沒有消費者，檔頭已註明等 #4 與 #10 落地後即可縮小或移除。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:26:51 +00:00
jiantw83andClaude Opus 5 48fd69cfde feat(腳本契約): 建立共用函式庫、四層前置檢查與 labels-list 
scripts/lib.js 立起所有腳本共用的地基：具名 flag 解析、單行 JSON 輸出
{ok, data, error:{code, message}}、Gitea API 與 git 各自唯一的出口、
四層前置檢查、依標題的冪等查重。

前置檢查依序為執行環境（git/tea 在 PATH 上、plugin 目錄完整）、Gitea 登入
有效、帳號對 issues unit 的寫入權、repo 已開啟時間追蹤；任一層不通過即帶著
可區分的錯誤碼中止，訊息一律指出該去哪裡改設定，前一層沒過就不再往下打。

issues unit 的寫入權採實測而非讀 permissions.push——Gitea 的 team unit 權限
可獨立於 repo 的 push 權限。探針打在不存在的議題 index 0：有寫入權會通過權限
中介層後回 404，沒有則直接 403，兩種結果都不改動任何東西。

認證預設沿用使用者既有的 tea login（讀 tea 的 config.yml），環境變數
TEA_SDLC_API_BASE / TEA_SDLC_TOKEN 只作為測試與 CI 的覆寫出口。

labels-list 為第一支腳本，刻意只讀不寫，呼應「不自動建立 Gitea 標籤」。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:26:50 +00:00
admin 6408b96fb9 Merge pull request 'chore/scaffold-tea-sdlc-skeleton/main' (#19) from chore/scaffold-tea-sdlc-skeleton/main into master 
Reviewed-on: #19
 2026-09-17 04:10:41 +00:00
jiantw83andClaude Opus 5 7a8222a053 chore(骨架): 把模板 scaffold 換成 tea-sdlc 骨架 
五份 manifest 的 name、description、homepage、repository 由 jsc-template
改指向 tea-sdlc，版本另起為 0.0.1；移除範例用的 skills/hello 並清掉
AGENTS.md 與 README.md 對它的引用。

建立後續工作包要落腳的四個目錄（prompts、scripts、templates、references）
並以 .gitkeep 納入版控；AGENTS.md 改寫為 tea-sdlc 的模組邊界與慣例，腳本
介面契約不複寫而指回議題 #1，避免正本分家。

新增 package.json 作為測試入口（node --test，Node 內建執行器，無任何相依
套件）；.gitignore 加入測試暫存目錄 .tmp/ 與 node_modules/。

Closes #2

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
 2026-09-17 04:06:09 +00:00
jiantw83 21f1103a9a Initial commit 2026-09-17 03:25:38 +00:00