plugins/sdlc
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat(交付與共識): 交付工作包獨立為 WP-01、新增交付內容型別與共識判定規則 #8

Merged
admin merged 7 commits from feat/deliver-package-and-consensus-rules into develop 2026-08-24 09:51:36 +00:00
Conversation 2 Commits 7 Files Changed 13
+299 -39
jiantw83 commented 2026-08-24 09:26:25 +00:00
Member
Copy Link
Copy Source

變更摘要

SDLC 兩項優化：規劃與分析要問到共識，交付／交接獨立成最優先的工作包。

一、持續提問到共識（新增 references/consensus.md，plan 與 analyze 共用，不各寫一份）

  • 一輪不算問完：每個回答都要生出下一個問題，從答案暴露的新未知往下推。
  • 共識需同時滿足兩個條件：沒有未知會改變產出，且使用者對讀回去的整理明確確認。
  • 每輪提問前攤開「已達成共識／尚未釐清／本輪要問」，讓共識可見。
  • 禁止用假設補洞、禁止把沉默或「都可以」當答案、禁止還有開著的項目就往下走。
  • 使用者不想決定時記成未決項（影響、預設處理、待決定者），不得靜默消失。

二、交付工作包獨立為 WP-01

  • WP-01 固定是交付／交接工作包，獨立成一包，不與實作合併；用到它規格的實作工作包相依於它，實作是候補。
  • 確實沒有可交接產出時（例如純內部重構），要先與使用者確認、頁面註明原因，才可以從 WP-01 開始編實作包——不得生出空洞的交付包。

三、交付內容開工前確認（新增 references/deliver-formats.md）

  • implement 領到交付工作包後、動第一個 todo 前，先問交付內容。預設選項固定兩個：API 文件、由使用者輸入。
  • API 文件必備：端點路徑、輸入參數（全部）、輸出參數（全部）、錯誤回應；每個參數要有名稱、型別、必填、範例、資料來源、狀態。
  • 範例資料真實優先，標 真實：{來源}；無來源才推理，標 推論：無來源。不得編造，個資只留格式。
  • 既有端點的新舊參數兩層標示都要：狀態欄（🆕 新增／⚠️ 變更／❌ 移除／既有留空），以及 diff 程式碼區塊上色。

影響範圍

  • analyze 的 WBS 編號語意改變：WP-01 保留給交付工作包。既有分析頁不受影響，下次更新時補欄即可。
  • implement 多一個步驟（交付內容確認），後續步驟重新編號為 7～10。
  • templates/analyze-page.md 新增「未決項」表與「交付／交付型別」欄。

重點檔案

檔案 變更
references/consensus.md 新增；提問與共識判定規則
references/deliver-formats.md 新增；交付內容型別與 API 文件規格
templates/deliver-page.md、templates/deliver-contents.md 交付頁改為 API 文件結構、加交付型別欄
templates/analyze-page.md WP-01 交付包、未決項表、交付與交付型別欄
skills/plan/SKILL.md、skills/analyze/SKILL.md 引用共識規則、WP-01 規則
skills/implement/SKILL.md 新增交付內容確認步驟、選包時交付優先

風險與注意事項

  • 相依：DELIVER 頁型需要 jsc-gitea 的 feat/deliver-wiki-page-type 先合併，否則 wiki-repo DELIVER 會被白名單擋掉。
  • wiki 會過濾 HTML 的 style 屬性，所以「明顯顏色」只能用 diff 區塊，規範已寫明不要用 HTML 上色。
  • 提問規則變嚴，規劃與分析的互動輪數會變多；這是刻意的。

驗證

STE100 lint 通過；四個 skill 的 description 都在 5 句以內；引用的 references 與 templates 檔案全部存在；用語已統一為「交付」，無「交接欄」殘留。

## 變更摘要 SDLC 兩項優化：規劃與分析要問到共識，交付／交接獨立成最優先的工作包。 **一、持續提問到共識**（新增 `references/consensus.md`，`plan` 與 `analyze` 共用，不各寫一份） - **一輪不算問完**：每個回答都要生出下一個問題，從答案暴露的新未知往下推。 - 共識需**同時**滿足兩個條件：沒有未知會改變產出，且使用者對讀回去的整理明確確認。 - 每輪提問前攤開「已達成共識／尚未釐清／本輪要問」，讓共識可見。 - 禁止用假設補洞、禁止把沉默或「都可以」當答案、禁止還有開著的項目就往下走。 - 使用者不想決定時記成**未決項**（影響、預設處理、待決定者），不得靜默消失。 **二、交付工作包獨立為 `WP-01`** - `WP-01` 固定是交付／交接工作包，獨立成一包，**不與實作合併**；用到它規格的實作工作包相依於它，實作是候補。 - 確實沒有可交接產出時（例如純內部重構），要先與使用者確認、頁面註明原因，才可以從 `WP-01` 開始編實作包——不得生出空洞的交付包。 **三、交付內容開工前確認**（新增 `references/deliver-formats.md`） - `implement` 領到交付工作包後、動第一個 todo 前，先問交付內容。預設選項固定兩個：**API 文件**、**由使用者輸入**。 - API 文件必備：端點路徑、輸入參數（**全部**）、輸出參數（**全部**）、錯誤回應；每個參數要有名稱、型別、必填、範例、資料來源、狀態。 - 範例資料真實優先，標 `真實：{來源}`；無來源才推理，標 `推論：無來源`。不得編造，個資只留格式。 - 既有端點的新舊參數**兩層標示都要**：狀態欄（🆕 新增／⚠️ 變更／❌ 移除／既有留空），以及 `diff` 程式碼區塊上色。 ## 影響範圍 - `analyze` 的 WBS 編號語意改變：`WP-01` 保留給交付工作包。既有分析頁不受影響，下次更新時補欄即可。 - `implement` 多一個步驟（交付內容確認），後續步驟重新編號為 7～10。 - `templates/analyze-page.md` 新增「未決項」表與「交付／交付型別」欄。 ## 重點檔案 | 檔案 | 變更 | | --- | --- | | `references/consensus.md` | 新增；提問與共識判定規則 | | `references/deliver-formats.md` | 新增；交付內容型別與 API 文件規格 | | `templates/deliver-page.md`、`templates/deliver-contents.md` | 交付頁改為 API 文件結構、加交付型別欄 | | `templates/analyze-page.md` | WP-01 交付包、未決項表、交付與交付型別欄 | | `skills/plan/SKILL.md`、`skills/analyze/SKILL.md` | 引用共識規則、WP-01 規則 | | `skills/implement/SKILL.md` | 新增交付內容確認步驟、選包時交付優先 | ## 風險與注意事項 - **相依**：`DELIVER` 頁型需要 `jsc-gitea` 的 `feat/deliver-wiki-page-type` 先合併，否則 `wiki-repo DELIVER` 會被白名單擋掉。 - wiki 會過濾 HTML 的 `style` 屬性，所以「明顯顏色」只能用 `diff` 區塊，規範已寫明不要用 HTML 上色。 - 提問規則變嚴，規劃與分析的互動輪數會變多；這是刻意的。 ## 驗證 STE100 lint 通過；四個 skill 的 description 都在 5 句以內；引用的 references 與 templates 檔案全部存在；用語已統一為「交付」，無「交接欄」殘留。
jiantw83 added 6 commits 2026-08-24 09:26:25 +00:00
Merge pull request 'feat(sdlc): 匯入 jsc-sdlc 技能組並統一 marketplace 為 jsc' (#2) from develop into master 1053e7d7e5 
Reviewed-on: #2
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
Merge pull request 'fix/sdlc-wiki-page-rules' (#3) from develop into master 033c05220e 
Reviewed-on: #3
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
Merge pull request '發佈 jsc-sdlc 0.0.5：階段閘門程式化、分支確認與交接優先' (#7) from develop into master 11a9287ae4 
Reviewed-on: #7
Reviewed-by: 系統管理員 <1+admin@noreply.localhost>
feat(交付與共識): 交付工作包獨立為 WP-01、新增交付內容型別與共識判定規則 62fd2a6022 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs(README): 補上交付頁型、共識規則與交付內容型別的說明 811eae8fd0 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
chore(plugin 版本): 三份 manifest 升版至 0.0.6 4b5385175b 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
jiantw83 added a new dependency 2026-08-24 09:26:37 +00:00
plugins/gitea#9 - feat(wiki): 頁型允許清單新增 DELIVER
admin approved these changes 2026-08-24 09:33:38 +00:00
Dismissed
jiantw83 added 1 commit 2026-08-24 09:37:14 +00:00
refactor(分支規則): 分支確認改用 sdlc 自帶的 references/branch.md，移除對 jsc-shared 的相依 b5f28e57f9 
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
admin approved these changes 2026-08-24 09:51:29 +00:00
admin merged commit b93d678b3c into develop 2026-08-24 09:51:36 +00:00
admin deleted branch feat/deliver-package-and-consensus-rules 2026-08-24 09:51:36 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
admin
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin (系統管理員) jiantw83 (Jeffery)
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Depends on
#9 feat(wiki): 頁型允許清單新增 DELIVER
plugins/gitea
Reference: plugins/sdlc#8