universal-dev-standards 5.16.0 → 6.0.0

package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: brainstorm-assistant
 source: ../../../../skills/brainstorm-assistant/SKILL.md
-source_version: 3.0.0
+source_version: 4.0.0
 source_hash: 25e622a7d063
-translation_version: 3.0.0
-last_synced: 2026-06-01
+translation_version: 4.0.0
+last_synced: 2026-06-22
 status: current
 description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 ---
@@ -15,11 +15,13 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 
 在撰寫規格前進行結構化發想。以 2024–2026 年 AI 輔助發想研究為基礎，透過引導式腦力激盪，將模糊構想轉化為可執行的功能提案。
 
-> **Implements**: XSPEC-247 brainstorm v3 — Multi-Persona Ensemble + Multi-Critic Convergence
-> （取代 v2「認知科學升級」。）
+> **Implements**: XSPEC-296 腦力激盪品質標準（BQS v1）—— brainstorm v4，疊加於
+> XSPEC-247 brainstorm v3（Multi-Persona Ensemble + Multi-Critic Convergence）。
 
 **v3 的核心改動：** v3 把發散從「單一 AI 衝數量」改為 **persona 集成**（每個角色以思維鏈獨立推理）× **多樣性透鏡**；把收斂從「單一 AI 評分 + 單一反駁」改為**多評審面板** + **硬角色反駁**（Devil's Advocate + Steelman）。直接對應文獻最強結論：多 persona 勝過單一 pass，單一 LLM 評審既弱又易諂媚。
 
+**v4 的核心改動：** v3 提供了強健的*機制*，卻沒有可判定 pass/fail 的品質閘。v4 在其上疊加一道**時序化品質契約**——**腦力激盪品質標準（BQS v1）**——且不移除任何 v3 行為。BQS 是**四層 × 時間軸**結構：第 0 層宣告 explore/exploit 意圖；第 1 層（過程、leading、發散期全程可見）跑維度 **D1–D4**；第 2 層（產物、leading、收斂後僅施於 Top 3）跑 **D5–D8** 加 Seeds 欄與爭議區；第 3 層是不受治理的 **Judgment Override**。第一原理：**決策用 leading 訊號、校準用 lagging 訊號——兩者是時間前後，而非對錯取捨。** 硬序列閘禁止 D5–D8 在發散期被揭示或評分。詳見下方「BQS v1 — 品質契約」。
+
 ## 使用前先選模式
 
 使用前套用以下**客觀觸發條件**。預設為完整 v3，路由規則是跳過階段的快捷鍵，而非額外障礙。
@@ -40,10 +42,69 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 ```
 [Mode Selection] ─► PRE-FLIGHT ─► FRAME ─► DIVERGE ───────────► CONVERGE ──────────► OUTPUT
    客觀路由          防止錨定      定義問題   persona 集成+透鏡       多評審面板+硬角色反駁    輸出提案
+   ▲ 第 0 層 意圖                ▲ 第 1 層（D1–D4，leading）       ▲ 第 2 層（D5–D8，Top 3）   ▲ 第 3 層 override
 ```
 
 ---
 
+## BQS v1 — 品質契約
+
+> **第一原理：** 腦力激盪的產物是**假說，不是答案**。一個點子好不好在發想當下不可知，所以品質只能用 **leading** 訊號（過程＋認識論完整性）判；標準的正當性靠 **lagging** 訊號（事後結果）**校準**。決策用 leading、校準用 lagging，兩者是**時間**前後，不是對錯取捨。（此處修正任何「只用 leading 不用 lagging」的絕對說法。）
+
+BQS 是**四層 × 時間軸**契約。它是 v3 的**疊加**——所有 v3 旗標與機制都保留（見「向後相容」）。
+
+### 第 0 層 — 意圖（開場宣告）
+
+開場宣告本次 **explore/exploit 配比** 與賭注類型（漸進 vs barbell 長尾）。此層**調節維度權重**：偏 exploit 的工作階段，**D2（發散覆蓋）低分是正確的、不扣分**。
+
+### 第 1 層 — 過程（發散期 leading，全程可見）
+
+| 維度 | Oracle（怎麼判 fail）|
+|------|----------------------|
+| **D1 框架純度** | 問題內嵌特定方案或「像 X 給 Y」→fail；須 5-Whys 到根因 |
+| **D2 發散覆蓋** | 存活想法跨 <3 獨立 persona/透鏡→fail（受第 0 層權重調節）；連一輪零新增才算飽和 |
+| **D3 跨會話多樣性** | 種子是競品類比→fail；Top 全來自單一 lens→fail |
+| **D4 評估去偏** | 須 ≥3 評審 + 硬角色 Devil's Advocate + Steelman；**pass 須在獨立 context 執行**，否則標 `[degraded]` 不得標 pass |
+
+> **硬序列閘：** D5–D8 禁止在發散期揭示或評分；CONVERGE 的 critic 不得在**最後一個 persona** 產完前被呼叫。
+
+### 第 2 層 — 產物（收斂後 leading，僅施於 Top 3）
+
+> 評判維度限縮在**收斂後 × 僅 Top 3**，絕不在發散期對全部想法當硬閘（否則回溯污染發散、扼殺無證據的未來想法、製造填表劇場）。
+
+| 維度 | Oracle |
+|------|--------|
+| **D5 接地** | 「現狀/外部事實」主張無 file:line/來源→fail；「未來/假說」免接地、標 `[假說]`。**外部事實宣稱為跨級地板**（creative 級亦適用）|
+| **D6 淨值** | 入選想法未答「解誰問題／我們真有嗎／不做的代價」→fail；至少一個「不值得做」淘汰。**掛 lagging 登記欄**：此判斷事後拿什麼訊號驗證？ |
+| **D7 可證偽** | 二態：`[現可陳述證偽]` 或 `[需先做 X 才能定義證偽]`；後者**轉 next-step 餵 D8，不算 fail** |
+| **D8 可行動** | 無 next-step 裁決（含「暫不做」）→fail |
+| **＋Seeds 欄** | 殺想法時強制存「錯在哪、指向什麼真問題」；被殺 ≥1 則 Seeds ≥1（只檢查非空）|
+| **＋爭議區** | critic 方差 > 閾值的想法分流呈現，不按 mean 排序淘汰（守 barbell 長尾）|
+
+### 第 3 層 — 不可治理區（Judgment Override）
+
+明文留一塊 oracle 不進入的地：人類直覺「保留/斃掉」附一句理由即可，**凌駕聚合分數、不需過任何維度**。承認標準不完備，避免「為過維度而 brainstorm」。
+
+### 結構規則
+
+1. **Meta 停止規則：** 該層維度全綠 **且** 再跑一輪後 **Top 3 集合成員不變**（看集合成員、不看內部排序）→停。**硬上限 2 輪**。取代模糊的「不翻決策」。
+2. **判官≠產生者：** D2/D4/D5/D7 判定須獨立視角；單 context 自評只能 `[degraded]`，不得 pass。
+3. **校準回路（吃 lagging）：** v3 的三個工作階段自評指標收編為此回路 **lagging** 端——**Adoption Rate＝D6 滯後驗證、Diversity＝D2/D3 滯後觀測、Cognitive Load＝成本約束**；**禁兩套平行評估**。
+4. **BQS 自我演化（輕量）：** 版本化 + 證據清單 last-reviewed 逾期 flag；「定期對 BQS 自身 brainstorm」列可選。
+5. **最小充分原則：** 套用該 tier 所需的最少維度 + Top-3 限縮——認知經濟性的守門，不另設成本維度。
+
+### 分級（綁 v3 既有客觀觸發，非自評）
+
+| Tier（來自模式選擇觸發）| 套用維度 |
+|--------------------------|----------|
+| creative / `--quick` | D1–D3 ＋ D5 外部事實地板 |
+| default | D1–D5 + D8 |
+| strategic / architecture / business | 全層 |
+
+> 分級由**客觀模式選擇觸發表**（字數、旗標、是否有規格）決定，而非發起者自評。
+
+---
+
 ### Phase 0: PRE-FLIGHT | 防止 AI 錨定
 
 **本階段存在的原因：** 在 AI 生成任何內容之前先寫下自己的想法，能持續產出更多樣的結果。在 AI 情境下這**更**重要：設計固著研究顯示，流暢、高擬真的 AI 輸出反而**加深**固著（Wadinambiarachchi 等，CHI 2024）。
@@ -60,6 +121,8 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 
 > **反種子 guardrail（v3 新增）：** 不要用「像 X 但給 Y」的框架當種子（如「給醫生用的 Slack」）。這類產品類比種子會把 LLM 鎖進單一解空間、明顯降低想法多樣性。請捕捉底層**問題**，而非產品類比。
 
+> **BQS 第 0 層 — 意圖宣告（v4 新增）：** 在 FRAME 之前，宣告本次的 **explore/exploit 配比** 與賭注類型（漸進 vs barbell 長尾）。此宣告下游調節 D2 權重——偏 exploit 時低發散覆蓋是正確的、不扣分。未宣告時預設：偏 explore。
+
 **旗標：** `--skip-preflight` 跳過本階段並顯示一行警告：
 `⚠ Skipping Pre-flight may cause AI anchoring`
 
@@ -112,6 +175,8 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 
 「好點子在後半」（Nijstad）是**人類群體**現象，**未在 LLM 證實**（LLM 多為高原／枯竭）。故固定數量門檻降為**輔助提示**：若全組少於約 8 個相異想法，提示「繼續——加一個還沒用過的 persona 或透鏡」。真正的門檻是**多樣性**（覆蓋了幾個不同視角），而非數量。
 
+> **此處生效 BQS 第 1 層（D1–D4，leading，全程可見）：** 發散期只對 **D1（框架純度）、D2（發散覆蓋，依第 0 層加權）、D3（跨會話多樣性）、D4（評估去偏）** 評分與呈現。**硬序列閘：** 評判維度 **D5–D8 在最後一個 persona 產完前不得揭示或評分**——CONVERGE 的 critic 在發散完成前不被呼叫。
+
 #### 經典技法（仍保留）
 
 | 技法 | 使用時機 |
@@ -156,6 +221,19 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 
 **旗標：** `--no-rebuttal` 跳過此步驟；報告段落標注「Rebuttal: skipped」。
 
+> **BQS D4 — 判官≠產生者：** D4 唯有**評審/Devil's Advocate 在獨立 context 執行**（`--enhanced` 隔離 agent 宿主）才可 pass。baseline 單 context 下，面板是同 context 自評，標 `[degraded]`、**不得標 pass**——誠實但非獨立。不得把 baseline 跑當成 D4 pass 靜默通過。
+
+#### Step 3c: BQS 第 2 層——對 Top 3 的產物閘
+
+收斂後，**僅對 Top 3** 套用 **D5–D8**（絕不對全部發散想法）。對每個 Top-3 想法：
+
+- **D5 接地：** 將每個主張分流為 `[現狀/外部事實]`（需 file:line 或來源，否則 fail）vs `[未來/假說]`（免接地、標 `[假說]`）。**外部事實宣稱為跨級地板**——creative 級也須接地。
+- **D6 淨值：** 每個 Top-3 須答「解誰問題／我們真有嗎／不做的代價」；至少一個淘汰為「不值得做」；掛 **lagging 登記欄**（事後哪個訊號驗證）。
+- **D7 可證偽（二態）：** 標 `[現可陳述證偽]` **或** `[需先做 X 才能定義證偽]`。後者**轉 next-step 餵 D8——不算 fail**。
+- **D8 可行動：** 每個存活想法需 next-step 裁決（含明確「暫不做」）；無 → fail。
+
+> **Meta 停止規則（BQS 結構規則 1）：** 當套用的維度全綠 **且** 再跑一輪後 **Top 3 集合成員不變**（看集合成員、非內部排序）→停。**硬上限 2 輪。**
+
 ---
 
 ### Phase 4: OUTPUT | 輸出提案
@@ -178,8 +256,21 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 |---|------|---------|------|-------------|---------------|--------------|-----------|
 | 1 | ...  | Skeptic | Reversal | 4.0 | 4.5 | 4.0 | 4.2 |
 
-## Top 3 Recommendations
+## Top 3 Recommendations (BQS Layer 2 applied)
 1. **[Idea]** ✓ Passed rebuttal — [Why] — Persona: [..] — [User rebuttal response]
+   - D5 grounding: [current-state claims with file:line | future claims marked [hypothesis]]
+   - D6 net benefit: [whose problem / do we have it / cost of not doing] — lagging signal: [..]
+   - D7 falsifiability: [falsifiable now | need to do X first → next-step]
+   - D8 next-step: [action | defer]
+
+## Contested Zone (high critic-variance ideas)
+[Ideas whose critic variance exceeded threshold — surfaced, NOT eliminated by mean ranking (barbell long-tail)]
+
+## Seeds (from killed ideas)
+[For each killed idea: what was wrong, what real problem it points to. Non-empty if ≥1 idea was killed.]
+
+## Judgment Override (Layer 3, ungoverned)
+[Human keep/kill decisions that override the aggregate score, each with a one-line reason. Optional.]
 
 ## Diversity Note
 [How many distinct lenses/personas the surviving ideas span — flag if all from one cluster]
@@ -192,6 +283,8 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 - [ ] Proceed to `/sdd` if requirements are clear
 ```
 
+> **BQS 輸出新增（v4）：** **Seeds** 區（規則：被殺 ≥1 則非空）、**爭議區**（高方差想法不按 mean 淘汰）、**Judgment Override** 通道（人類裁決凌駕聚合分）為 BQS 第 2/3 層所要求。Top-3 區塊逐項記錄 D5–D8 狀態。
+
 ## 多樣性崩塌防護
 
 用單一 LLM 發想會降低**跨使用者的想法多樣性**，即使個人覺得更有創意（Anderson、Shah、Kreminski，2024；與廣為引用的 Doshi & Hauser，《Science Advances》2024 同向）。防範方式：
@@ -218,15 +311,17 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 | **Devil's Advocate + Steelman** | 硬角色反駁 |
 | **SCAMPER / Six Hats** | 經典發散（可當 persona） |
 
-## 工作階段自評
+## 校準回路——lagging 訊號（BQS）
 
-每次工作階段結束後記錄三個指標（1–5 分），追蹤長期改善。
+> **這是同一道 BQS 品質回路的 lagging 端——不是第二套平行評估系統。** 工作階段中由 BQS 第 0–2 層做 leading 決策；這三個指標事後校準標準。禁止在 BQS 之外另跑一套自評。
 
-| 指標 | 問題 |
-|------|------|
-| **Adoption Rate（採用率）** | 今天的想法我實際會用幾個？ |
-| **Diversity（多樣性）** | 存活想法跨越多個 persona／透鏡嗎？ |
-| **Cognitive Load（認知負擔）** | 這過程心智上有多累？（5 = 毫不費力） |
+每次工作階段結束後記錄三個指標（1–5 分），各自對應一個 BQS 維度作為其滯後驗證：
+
+| 指標 | 問題 | BQS 滯後角色 |
+|------|------|--------------|
+| **Adoption Rate（採用率）** | 今天的想法我實際會用幾個？ | **D6 淨值滯後驗證** |
+| **Diversity（多樣性）** | 存活想法跨越多個 persona／透鏡嗎？ | **D2/D3 滯後觀測** |
+| **Cognitive Load（認知負擔）** | 這過程心智上有多累？（5 = 毫不費力） | **成本約束** |
 
 收集 3 次工作階段資料再下結論。完整 A/B 實驗協議見 [guide.md](./guide.md)。
 
@@ -234,6 +329,7 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 
 | 旗標 | 說明 |
 |------|------|
+| `--intent explore\|exploit\|<比例>` | 宣告 BQS 第 0 層 explore/exploit 意圖（調節 D2 權重） |
 | `--personas "a,b,c"` | 覆寫預設 persona 組 |
 | `--lens analogical\|reversal\|morphological` | 指定主要多樣性透鏡 |
 | `--enhanced` | 平行 persona／評審 agent（不支援則退回） |
@@ -267,4 +363,4 @@ description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 
 ## AI 代理行為
 
-> 完整的 AI 行為定義請參閱對應的命令文件：[`/brainstorm`](../commands/brainstorm.md#ai-agent-behavior--ai-代理行為)
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/brainstorm`](../../../../skills/commands/brainstorm.md#ai-agent-behavior--ai-代理行為)

package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md

@@ -5,10 +5,10 @@ description: |
   使用時機：模糊想法、功能探索、問題再框架、創意發想。
   關鍵字：brainstorm, ideation, persona ensemble, multi-critic, HMW, SCAMPER, 腦力激盪, 發想, 創意。
 source: ../../../../skills/brainstorm-assistant/guide.md
-source_version: 3.0.0
+source_version: 4.0.0
 source_hash: 24f4fe4819a4
-translation_version: 3.0.0
-last_synced: 2026-06-01
+translation_version: 4.0.0
+last_synced: 2026-06-22
 status: current
 ---
 
@@ -16,8 +16,8 @@ status: current
 
 > **語言**: [English](../../../../skills/brainstorm-assistant/guide.md) | 繁體中文
 
-**版本**: 3.0.0
-**最後更新**: 2026-06-01
+**版本**: 4.0.0
+**最後更新**: 2026-06-22
 **適用範圍**: 所有軟體專案
 **Scope**: universal
 **類型**: 工具型 Skill（無對應核心標準）
@@ -49,6 +49,17 @@ v1 是泛用的 FRAME→DIVERGE→CONVERGE 流程。v2 加入了認知科學閘
 
 Pre-flight 階段被**保留並強化**（固著研究指出 AI 錨定確實存在、甚至可能更嚴重），而 10 個想法門檻與單一 AI 反駁則被**降級／硬化**，因為它們原本的人類群體證據無法乾淨地轉移到單一 LLM。
 
+### v4 改了什麼（BQS v1）
+
+v3 提供了強健的*機制*，卻沒有**可判定 pass/fail 的品質閘**——它唯一接近的工作階段自評是事後、自評、不卡關的。**v4 在 v3 上疊加腦力激盪品質標準（BQS v1），且不移除任何東西**（見「向後相容」）。BQS 是**四層 × 時間軸**品質契約：
+
+- **第 0 層 — 意圖**：宣告 explore/exploit 配比；調節維度權重。
+- **第 1 層 — 過程（發散期 leading、可見）**：維度 **D1 框架純度／D2 發散覆蓋／D3 跨會話多樣性／D4 評估去偏**，各有 oracle。**硬序列閘**禁止評判維度 D5–D8 在發散期被揭示或評分。
+- **第 2 層 — 產物（收斂後 leading、僅 Top 3）**：**D5 接地／D6 淨值／D7 可證偽／D8 可行動**，加 Seeds 欄與高方差想法的爭議區。
+- **第 3 層 — 不可治理**：Judgment Override，人類直覺凌駕聚合分數。
+
+第一原理被修正：**決策用 leading 訊號、校準用 lagging 訊號——兩者是時間前後，而非對錯取捨**（移除任何「只用 leading 不用 lagging」絕對說法）。核心主張：評判維度限縮在**收斂後 × 僅 Top 3**，絕不在發散期對全部想法當硬閘——否則回溯污染發散、扼殺無證據的未來想法、製造填表劇場。完整契約、oracle 與結構規則見 **SKILL.md →「BQS v1 — 品質契約」**。
+
 ---
 
 ## 認知科學依據 | Research Foundations
@@ -393,9 +404,11 @@ SKILL.md 的模式選擇表使用客觀觸發條件（字數、是否帶旗標
 
 ---
 
-## 自我評估框架 | Self-Evaluation Framework
+## 校準回路（BQS lagging 端）| Calibration Loop
+
+> **v4 中這三個指標是同一道 BQS 品質回路的 lagging 端，不是第二套平行評估系統。** 工作階段中由 BQS 第 0–2 層做 leading pass/fail 決策；這些指標事後校準標準。**採用率＝D6 淨值滯後驗證、多樣性＝D2/D3 滯後觀測、認知負擔＝成本約束。** 禁止在 BQS 之外另跑一套自評。
 
-每次工作階段後記錄三個指標，建立實證紀錄。不要以單次評估 v3 vs v2，至少收集 3 次可比較的工作階段。
+每次工作階段後記錄三個指標，建立實證紀錄。不要以單次評估跨版本，至少收集 3 次可比較的工作階段。
 
 ### 三個指標
 
@@ -528,6 +541,16 @@ Nemeth 的效應是關於*有利益關係的人之間的真實異議*。AI 按
 
 ---
 
+## 向後相容（v3 → v4）| Backward Compatibility
+
+BQS v1 是**疊加的品質契約**，不是打掉重練。v3 的一切都保留：
+
+- **所有旗標**：`--personas`、`--lens`、`--enhanced`、`--skip-preflight`、`--no-rebuttal`、`--quick`、`--technique` 行為與 v3 完全相同。v4 僅新增一個可選旗標 `--intent`，供第 0 層宣告。
+- **所有機制**：PRE-FLIGHT 防錨定、FRAME 5-Whys／HMW、persona 集成、多樣性透鏡、多評審面板、硬角色反駁（Devil's Advocate + Steelman）、多樣性崩塌護欄、Enhanced 層，皆不變。
+- **`--enhanced` 隔離 agent 宿主**正是讓 BQS **D4 pass**（判官≠產生者）的條件；baseline 單 context 標 `[degraded]`、不靜默通過。
+
+---
+
 ## 與 UDS 工作流的整合
 
 ### 對應到 `/requirement`
@@ -566,6 +589,7 @@ Nemeth 的效應是關於*有利益關係的人之間的真實異議*。AI 按
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 4.0.0 | 2026-06-22 | XSPEC-296：腦力激盪品質標準（BQS v1）——疊加於 v3 的四層 × 時間軸品質契約。第 0 層 explore/exploit 意圖（調節 D2 權重）；第 1 層過程 leading 維度 D1–D4 + 硬序列閘（發散期禁 D5–D8）；第 2 層產物 leading 維度 D5–D8 僅施於 Top 3，加 Seeds 欄與高方差爭議區；第 3 層 Judgment Override（凌駕聚合分）。D4 判官≠產生者（須獨立 context，否則 `[degraded]`）；D5 主張分流（外部事實跨級地板）；D7 二態證偽（「需先做 X」→next-step、不算 fail）；Meta 停止規則（Top-3 集合穩定 + 硬上限 2 輪）。工作階段自評重新定位為校準回路 lagging 端（Adoption→D6、Diversity→D2/D3、Cognitive Load→成本；禁兩套平行評估）。第一原理修正為「決策用 leading、校準用 lagging」。分級綁客觀模式選擇觸發。新增旗標 `--intent`。所有 v3 旗標／機制保留。 |
 | 3.0.0 | 2026-06-01 | XSPEC-247：DIVERGE 重新對齊到 persona 集成 + 多樣性透鏡（類比／反轉／形態學）；CONVERGE 重新對齊到多評審面板 + 硬角色反駁（Devil's Advocate + Steelman）；多樣性崩塌護欄；Enhanced 層級（平行 persona／評審代理、優雅退回）；認知科學依據以 6 項已驗證的 2024–2026 出處重建；效度說明重新評等（pre-flight 為低、Nijstad／Nemeth 降級）；新增旗標 `--personas`／`--lens`／`--enhanced`；反種子護欄 |
 | 2.1.0 | 2026-05-09 | XSPEC-196 Phase 2：模式選擇客觀路由；自我評估框架；A/B 實驗協議；研究效度說明；漸進採用協議 |
 | 2.0.0 | 2026-05-09 | XSPEC-196：Phase 0 Pre-flight（反錨定）、反駁輪、10 個想法最低門檻 + 語義批次化 |

package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md

@@ -12,6 +12,8 @@ description: "[UDS] 在提交程式碼前驗證品質關卡，確保程式碼庫
 
 > **語言**: [English](../../../../skills/checkin-assistant/SKILL.md) | 繁體中文
 
+> ⚠️ **狀態：參考用（非可執行流程）** — 簽入流程協調（關卡執行序列、abort 邏輯）已於 2026-04-28 移至 **adoption layer（XSPEC-095）**。此處保留品質關卡定義、檢查清單項、never-commit 規則供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。
+
 在提交程式碼前驗證品質關卡，確保程式碼庫的穩定性。
 
 ## 工作流程
@@ -56,7 +58,7 @@ description: "[UDS] 在提交程式碼前驗證品質關卡，確保程式碼庫
 > **品質關卡驗證完成。建議下一步：**
 > - 全部通過 ✅ → 執行 `/commit` 提交變更
 > - 有失敗項目 ❌ → 修復問題後重新執行 `/checkin`
-> - 需要程式碼審查 → 執行 `/review` 進行自我審查
+> - 需要程式碼審查 → 執行 `/code-review` 進行自我審查
 > - UDS 安裝有異常 → 執行 `/audit` 診斷問題
 
 ## 參考

package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md

@@ -57,6 +57,56 @@ BUILD ──► TEST ──► ANALYZE ──► DEPLOY ──► VERIFY
 | **GitLab CI** | `cache:` 關鍵字 | `parallel:` 關鍵字 | CI/CD Variables | 使用 `include:` 模組化 |
 | **Jenkins** | Stash/unstash | `parallel {}` 區塊 | Credentials plugin | 使用 shared libraries |
 
+## CI 作業編排模式
+
+反覆出現的 CI 作業編排模式（UDS #126）。每條原則平台無關；對照欄顯示各平台的寫法。
+
+### 觸發分離
+
+將重型慢速套件（完整 E2E）以**觸發條件**與每次變更的輕量檢查分離，使 runner 成本隨風險而非每次 push 成長。
+
+| 需求 | GitHub Actions | GitLab CI | Jenkins |
+|------|----------------|-----------|---------|
+| 重型套件排程觸發 | `on: schedule:` | `rules: if $CI_PIPELINE_SOURCE == "schedule"` | cron 觸發 |
+| 輕量檢查每次變更 | `on: pull_request` | `rules: if $CI_PIPELINE_SOURCE == "merge_request_event"` | SCM webhook |
+
+> ⚠️ 反模式：每次 push 跑完整 E2E。
+
+### 共享資源序列化
+
+當多個作業觸及同一個**有狀態共享資源**（單一測試環境 / runner / 部署目標）時，序列化以防並發污染。
+
+| 需求 | GitHub Actions | GitLab CI | Jenkins |
+|------|----------------|-----------|---------|
+| 互斥 | `concurrency: { group: … }` | `resource_group:` | `lock(resource: …)` |
+
+> ⚠️ 反模式：兩作業並行寫同一 DB/環境。
+
+### 變更偵測閘控
+
+當某範圍的 `HEAD` 自上次成功未變（或變更只觸及範圍外路徑）時，跳過 deploy/test 以節省 runner。**明確**定義「未變」（上次成功 SHA 或路徑過濾）。
+
+| 需求 | GitHub Actions | GitLab CI | Jenkins |
+|------|----------------|-----------|---------|
+| 範圍未變則跳過 | `paths:` / `dorny/paths-filter` | `rules: changes:` / SHA 比對 | `changeset` 條件 |
+
+> ⚠️ 反模式：文件-only commit 跑完整部署。
+
+### 諮詢 vs 閘控作業
+
+明確宣告每個作業是 **advisory**（回報但不擋合併）或 **gating**（擋合併）。混淆會在雜訊上卡關、或漏掉該擋的。（安全閘門是 Block/Warn/Log 特例——見 [`pipeline-security-gates`](../../../../core/pipeline-security-gates.md)。）
+
+| 需求 | GitHub Actions | GitLab CI | Jenkins |
+|------|----------------|-----------|---------|
+| Advisory（不擋） | `continue-on-error: true` | `allow_failure: true` | `catchError` → `unstable` |
+| Gating（擋合併） | required status check | 預設（無 `allow_failure`） | hard fail |
+
+> ⚠️ 反模式：把雜訊 lint 設硬閘，或把關鍵套件設 advisory。
+
+### 排錯：`npm ci` `EUSAGE`
+
+`npm ci` 需要 **committed** lockfile。若 `package-lock.json` 被 gitignore，CI 會以 `EUSAGE` 失敗。修法：commit lockfile，或 CI-only 安裝用 `npm install --no-audit --no-fund --ignore-scripts`（跳過 CI 不需要的 `prepare`/husky hook）。
+
 ## 使用方式
 
 - `/ci-cd` - 顯示完整管線指引

package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md

@@ -12,6 +12,8 @@ description: "[UDS] 使用標準化檢查清單執行系統性程式碼審查"
 
 > **語言**: [English](../../../../skills/code-review-assistant/SKILL.md) | 繁體中文
 
+> ⚠️ **狀態：參考用（非可執行流程）** — 程式碼審查流程協調（4 步驟序列、outcome gating）已於 2026-04-28 移至 **adoption layer（XSPEC-095）**。此處保留 8 大審查類別定義、BLOCKING/IMPORTANT/SUGGESTION/QUESTION/NOTE 前綴語意供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。
+
 使用標準化的檢查清單和評論前綴，執行系統性的程式碼審查。
 
 ## 工作流程
@@ -44,16 +46,16 @@ description: "[UDS] 使用標準化檢查清單執行系統性程式碼審查"
 
 ## 使用方式
 
-- `/review` - 審查目前分支的所有變更
-- `/review src/auth.js` - 審查特定檔案
-- `/review feature/login` - 審查特定分支
+- `/code-review` - 審查目前分支的所有變更
+- `/code-review src/auth.js` - 審查特定檔案
+- `/code-review feature/login` - 審查特定分支
 
 ## 下一步引導
 
-`/review` 完成後，AI 助手應建議：
+`/code-review` 完成後，AI 助手應建議：
 
 > **程式碼審查完成。建議下一步：**
-> - 有 ❗ BLOCKING 項目 → 修復後重新執行 `/review`
+> - 有 ❗ BLOCKING 項目 → 修復後重新執行 `/code-review`
 > - 全部通過 → 執行 `/checkin` 品質關卡
 > - 僅有 💡 SUGGESTION → 執行 `/commit` 提交變更
 > - 審查中發現規範不實用或缺失 → 執行 `/audit --report` 回報

package/bundled/locales/zh-TW/skills/commands/ac-coverage.md

@@ -89,7 +89,7 @@ argument-hint: "[規格檔案路徑 | spec file path]"
 
 ## 參考
 
-- [AC 覆蓋率助手技能](../ac-coverage-assistant/SKILL.md)
+- [AC 覆蓋率助手技能](../ac-coverage/SKILL.md)
 - [核心規範：驗收條件追蹤](../../core/acceptance-criteria-traceability.md)
 - 相關：[/coverage](./coverage.md)（程式碼層級覆蓋率）
 - 相關：[/checkin](./checkin.md)（品質關卡）

package/bundled/locales/zh-TW/skills/commands/atdd.md

@@ -35,7 +35,7 @@ status: experimental
 3. **追蹤階段轉換**隨著工作進展
 4. **在回應中顯示階段指示器**（🤝 工作坊、🧪 提煉、💻 開發、🎬 展示、✅ 完成）
 
-詳見 [methodology-system](../methodology-system/SKILL.md) 了解完整方法論追蹤。
+詳見 [methodology-system](../dev-methodology/SKILL.md) 了解完整方法論追蹤。
 
 ## ATDD 循環
 
@@ -163,5 +163,5 @@ ATDD Level (Business Acceptance)
 
 - 核心標準：[acceptance-test-driven-development.md](../../core/acceptance-test-driven-development.md)
 - Skill：[atdd-assistant](../atdd-assistant/SKILL.md)
-- 方法論：[atdd.methodology.yaml](../../methodologies/atdd.methodology.yaml)
-- 方法論系統：[methodology-system](../methodology-system/SKILL.md)
+- 方法論：[atdd.methodology.yaml](../../../../methodologies/atdd.methodology.yaml)
+- 方法論系統：[methodology-system](../dev-methodology/SKILL.md)

package/bundled/locales/zh-TW/skills/commands/bdd.md

@@ -31,7 +31,7 @@ status: experimental
 3. **追蹤階段轉換**隨著工作進展
 4. **在回應中顯示階段指示器**（🔍 探索、📝 制定、🤖 自動化、📚 活文件）
 
-詳見 [methodology-system](../methodology-system/SKILL.md) 了解完整方法論追蹤。
+詳見 [methodology-system](../dev-methodology/SKILL.md) 了解完整方法論追蹤。
 
 ## BDD 循環
 
@@ -139,4 +139,4 @@ BDD 最適合協作：
 ## 參考
 
 - 方法論: [bdd.methodology.yaml](../../../../methodologies/bdd.methodology.yaml)
-- 方法論系統: [methodology-system](../methodology-system/SKILL.md)
+- 方法論系統: [methodology-system](../dev-methodology/SKILL.md)

package/bundled/locales/zh-TW/skills/commands/brainstorm.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../../skills/commands/brainstorm.md
-source_version: 3.0.0
+source_version: 4.0.0
 source_hash: 3212203924de
-translation_version: 3.0.0
-last_synced: 2026-06-01
+translation_version: 4.0.0
+last_synced: 2026-06-22
 ---
 
 ---
@@ -31,13 +31,15 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
   防錨定        定義問題    persona 集成+透鏡     多評審面板+硬角色反駁   輸出提案
 ```
 
-| 階段 | 目標 | 關鍵技法（v3） |
-|------|------|---------------|
-| **PRE-FLIGHT** | 防止 AI 錨定 | 使用者先寫 3 個想法；無類比種子 |
-| **FRAME** | 清楚定義問題 | 5 Whys、HMW、Stakeholder Map |
-| **DIVERGE** | 逼出視角多樣性 | persona 集成 + 多樣性透鏡 |
-| **CONVERGE** | 降偏誤選擇 | 多評審面板 + Devil's Advocate／Steelman |
-| **OUTPUT** | 可執行的報告 | Brainstorm Report 範本 |
+| 階段 | 目標 | 關鍵技法（v3）+ BQS 閘（v4） |
+|------|------|-------------------------------|
+| **PRE-FLIGHT** | 防止 AI 錨定 | 使用者先寫 3 個想法；無類比種子；**BQS 第 0 層意圖（explore/exploit）** |
+| **FRAME** | 清楚定義問題 | 5 Whys、HMW、Stakeholder Map；**D1 框架純度** |
+| **DIVERGE** | 逼出視角多樣性 | persona 集成 + 多樣性透鏡；**BQS 第 1 層 D1–D4，硬閘隱藏 D5–D8** |
+| **CONVERGE** | 降偏誤選擇 | 多評審面板 + Devil's Advocate／Steelman；**BQS 第 2 層 D5–D8 施於 Top 3，D4 判官≠產生者** |
+| **OUTPUT** | 可執行的報告 | Brainstorm Report + Seeds + 爭議區 + **第 3 層 Judgment Override** |
+
+> **BQS v1（XSPEC-296）：** v4 在 v3 上疊加四層 × 時間軸品質契約。完整 oracle 與結構規則見 skill：[Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md#bqs-v1--品質契約)。
 
 ## 技法
 
@@ -100,34 +102,39 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
 | `/brainstorm "topic"` | 以指定主題啟動 PRE-FLIGHT，再進入 FRAME |
 | `/brainstorm --personas "a,b,c"` | 以自訂 persona 組進入 DIVERGE |
 | `/brainstorm --lens <name>` | 以指定多樣性透鏡為主進入 DIVERGE |
-| `/brainstorm --enhanced` | 若宿主支援子代理則平行跑 persona／評審，否則靜默退回 baseline |
+| `/brainstorm --enhanced` | 若宿主支援子代理則平行跑 persona／評審，否則靜默退回 baseline；此模式下 BQS D4 方可 pass |
+| `/brainstorm --intent exploit` | 以 exploit 意圖啟動（BQS 第 0 層），D2 低覆蓋不扣分 |
 
 ### 互動腳本
 
 #### PRE-FLIGHT Phase
 1. 請使用者先寫 問題（一句）＋3 個初始想法＋最不想要的解法類型
 2. 拒絕「像 X 但給 Y」種子，改寫為底層問題
+3. **BQS 第 0 層**：宣告本次 explore/exploit 配比與賭注類型（未宣告預設偏 explore）
 
 🛑 **STOP**: 收到三項輸入前不生成任何想法（`--skip-preflight` 例外，顯示錨定警告）
 
 #### FRAME Phase
 1. 釐清問題陳述（5 Whys 找根因）
 2. 重構為 HMW 問題；識別利害關係人
+3. **BQS D1 框架純度**：問題不得內嵌特定方案或「像 X 給 Y」，須到根因
 
 🛑 **STOP**: 問題定義後等待使用者確認
 
-#### DIVERGE Phase
+#### DIVERGE Phase（BQS 第 1 層 — D1–D4 leading，全程可見）
 1. 逐一以預設 persona（領域專家／懷疑者／跨域類比者／成本約束者／使用者代言）思維鏈生成想法
 2. **分支隔離**：生成各 persona 時不互相預覽，全部產完才一起呈現
 3. 至少套用一個多樣性透鏡（類比／假設反轉／形態矩陣）
-4. 以多樣性（覆蓋的 persona／透鏡數）而非數量為繼續門檻
+4. 以多樣性（覆蓋的 persona／透鏡數，D2/D3）而非數量為繼續門檻
+5. **硬序列閘**：D5–D8 在最後一個 persona 產完前**不得揭示或評分**；CONVERGE critic 不得提前呼叫
 
-#### CONVERGE Phase
+#### CONVERGE Phase（BQS 第 2 層 — D5–D8 僅施於 Top 3）
 1. 以 3 個獨立評審（工程可行性／使用者影響／策略一致）各自評分後聚合
-2. 對前 3 名跑硬角色 Devil's Advocate（論證會失敗）+ Steelman；使用者以 (a)修改／(b)反駁／(c)移除 回應
-3. 排序並標記通過反駁的想法
+2. 對前 3 名跑硬角色 Devil's Advocate（論證會失敗）+ Steelman；使用者以 (a)修改／(b)反駁／(c)移除 回應。**D4 判官≠產生者**：評審須在獨立 context（`--enhanced`）方可 pass，否則標 `[degraded]` 不得 pass
+3. **僅對 Top 3** 套用 D5 接地（外部事實需 file:line／來源、跨級地板；假說免接地）、D6 淨值（解誰問題／真有嗎／不做代價＋掛 lagging 欄）、D7 二態證偽（「需先做 X」轉 next-step、不算 fail）、D8 next-step 裁決
+4. **Meta 停止規則**：維度全綠且再跑一輪 Top 3 集合成員不變→停；硬上限 2 輪
 
-🛑 **STOP**: 展示 Brainstorm Report 後等待使用者決定下一步
+🛑 **STOP**: 展示 Brainstorm Report（含 Seeds／爭議區／Judgment Override）後等待使用者決定下一步
 
 ### 停止點
 
@@ -147,6 +154,8 @@ PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► C
 | 指定的 persona／透鏡不存在 | 列出可用選項供選擇 |
 | `--enhanced` 但宿主不支援子代理 | 靜默退回 baseline，照常進行 |
 | 前 3 名全來自同一 persona／透鏡 | 標示並在輸出前再跑一個透鏡 |
+| baseline 單 context 跑評審（無獨立 context） | BQS D4 標 `[degraded]`，不得標 pass |
+| 外部事實宣稱無 file:line／來源 | D5 接地 fail，要求補來源或改標 `[假說]` |
 
 ## 參考
 

package/bundled/locales/zh-TW/skills/commands/{review.md → code-review.md}

@@ -1,5 +1,5 @@
 ---
-source: ../../../../skills/commands/review.md
+source: ../../../../skills/commands/code-review.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-03-19
@@ -13,7 +13,7 @@ argument-hint: "[file path or branch | 檔案路徑或分支名稱]"
 
 # 程式碼審查助手
 
-> **Language**: [English](../../../../skills/commands/review.md) | 繁體中文
+> **Language**: [English](../../../../skills/commands/code-review.md) | 繁體中文
 
 執行系統性的程式碼審查，使用標準化的檢查清單和評論前綴。
 
@@ -47,9 +47,9 @@ argument-hint: "[file path or branch | 檔案路徑或分支名稱]"
 
 ## 使用方式
 
-- `/review` - 審查目前分支的所有變更
-- `/review src/auth.js` - 審查特定檔案
-- `/review feature/login` - 審查特定分支
+- `/code-review` - 審查目前分支的所有變更
+- `/code-review src/auth.js` - 審查特定檔案
+- `/code-review feature/login` - 審查特定分支
 
 ## 參考
 

package/bundled/locales/zh-TW/skills/commands/derive-all.md

@@ -57,6 +57,6 @@ SPEC-XXX.md ──► /derive-bdd ──► /derive-tdd ──► [/derive-atdd]
 
 ## 參考
 
-- 父命令：[/derive](../forward-derivation/SKILL.md)
+- 父命令：[/derive](../spec-derivation/SKILL.md)
 - 核心標準：[forward-derivation-standards.md](../../core/forward-derivation-standards.md)
 - 子命令：[/derive-bdd](./derive-bdd.md)、[/derive-tdd](./derive-tdd.md)、[/derive-atdd](./derive-atdd.md)

package/bundled/locales/zh-TW/skills/commands/derive-atdd.md

@@ -54,5 +54,5 @@ SPEC-XXX.md ──► Parse AC ──► Generate acceptance.md ──► Review
 
 ## 參考
 
-- 父命令：[/derive](../forward-derivation/SKILL.md)
+- 父命令：[/derive](../spec-derivation/SKILL.md)
 - 核心標準：[forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-TW/skills/commands/derive-bdd.md

@@ -31,10 +31,9 @@ SPEC-XXX.md ──► Parse AC ──► Generate .feature ──► Review
 ## 輸出格式
 
 ```gherkin
-@SPEC-001
 Feature: [Feature Name]
 
-  @AC-1
+  @SPEC-001 @AC-1
   Scenario: [AC-1 description]
     Given [context]
     When [action]
@@ -50,5 +49,5 @@ Feature: [Feature Name]
 
 ## 參考
 
-- 父指令：[/derive](../forward-derivation/SKILL.md)
+- 父指令：[/derive](../spec-derivation/SKILL.md)
 - 核心規範：[forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-TW/skills/commands/derive-tdd.md

@@ -51,5 +51,5 @@ describe('SPEC-001: [Feature Name]', () => {
 
 ## 參考
 
-- 父指令：[/derive](../forward-derivation/SKILL.md)
+- 父指令：[/derive](../spec-derivation/SKILL.md)
 - 核心規範：[forward-derivation-standards.md](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-TW/skills/commands/derive.md

@@ -75,5 +75,5 @@ argument-hint: "[all|bdd|tdd|atdd] <spec-file> [--lang <lang>] [--framework <fw>
 
 ## 參考
 
-*   [正向推演標準](../forward-derivation/SKILL.md)
+*   [正向推演標準](../spec-derivation/SKILL.md)
 *   [核心規範](../../core/forward-derivation-standards.md)

package/bundled/locales/zh-TW/skills/commands/dev-workflow.md

@@ -87,7 +87,7 @@ ls docs/specs/SPEC-*.md 2>/dev/null
 | **I. 規劃** | `/brainstorm` `/requirement` `/sdd` `/reverse` | 需求、規格、逆向工程 |
 | **II. 測試** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` | 先寫測試再寫程式 |
 | **III. 實作** | `/refactor` `/reverse` | 撰寫與改善程式碼 |
-| **IV. 品質** | `/checkin` `/review` | 提交前檢查與審查 |
+| **IV. 品質** | `/checkin` `/code-review` | 提交前檢查與審查 |
 | **V. 發布** | `/commit` `/changelog` `/release` | 版本、提交、發布 |
 | **VI. 文件** | `/docs` `/docgen` `/struct` | 文件與專案結構 |
 | **VII. 規範** | `/discover` `/guide` | 參考指南 |
@@ -116,5 +116,5 @@ ls docs/specs/SPEC-*.md 2>/dev/null
 ## 參考
 
 - [開發工作流程技能](../dev-workflow-guide/SKILL.md)
-- [詳細階段指南](../dev-workflow-guide/workflow-phases.md)
+- [詳細階段指南](../../../../skills/dev-workflow-guide/workflow-phases.md)
 - [每日工作流程指南](../../adoption/DAILY-WORKFLOW-GUIDE.md)