universal-dev-standards 5.15.1 → 5.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +31 -0
- package/bundled/ai/standards/forward-derivation-standards.ai.yaml +23 -0
- package/bundled/ai/standards/knowledge-graph-memory.ai.yaml +1 -1
- package/bundled/core/acceptance-criteria-traceability.md +46 -0
- package/bundled/core/forward-derivation-standards.md +19 -0
- package/bundled/core/knowledge-graph-memory.md +2 -2
- package/bundled/locales/zh-CN/CHANGELOG.md +13 -3
- package/bundled/locales/zh-CN/README.md +1 -1
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +46 -0
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +19 -0
- package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md +194 -0
- package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +135 -40
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +217 -63
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +599 -0
- package/bundled/locales/zh-CN/skills/commands/brainstorm.md +92 -25
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +78 -16
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +85 -26
- package/bundled/locales/zh-CN/skills/deploy-assistant/SKILL.md +189 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +110 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/guide.md +255 -0
- package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +70 -11
- package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md +209 -0
- package/bundled/locales/zh-CN/skills/knowledge-graph/SKILL.md +58 -0
- package/bundled/locales/zh-CN/skills/knowledge-graph/guide.md +74 -0
- package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +125 -8
- package/bundled/locales/zh-CN/skills/observability-assistant/guide.md +188 -0
- package/bundled/locales/zh-CN/skills/orchestrate/SKILL.md +173 -0
- package/bundled/locales/zh-CN/skills/plan/SKILL.md +240 -0
- package/bundled/locales/zh-CN/skills/push/SKILL.md +242 -0
- package/bundled/locales/zh-CN/skills/retrospective-assistant/SKILL.md +104 -36
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +88 -32
- package/bundled/locales/zh-CN/skills/runbook-assistant/guide.md +216 -0
- package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md +149 -0
- package/bundled/locales/zh-CN/skills/slo-assistant/guide.md +188 -0
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +86 -0
- package/bundled/locales/zh-CN/skills/spec-derivation/guide.md +476 -0
- package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +155 -81
- package/bundled/locales/zh-CN/skills/sweep/SKILL.md +151 -0
- package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +207 -110
- package/bundled/locales/zh-TW/CHANGELOG.md +13 -3
- package/bundled/locales/zh-TW/README.md +1 -1
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +46 -0
- package/bundled/locales/zh-TW/core/browser-compatibility-standards.md +222 -5
- package/bundled/locales/zh-TW/core/contract-testing-standards.md +184 -5
- package/bundled/locales/zh-TW/core/cross-flow-regression.md +192 -5
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +19 -0
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -2
- package/bundled/locales/zh-TW/core/release-readiness-gate.md +186 -5
- package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +21 -42
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +212 -59
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +266 -579
- package/bundled/locales/zh-TW/skills/commands/brainstorm.md +91 -26
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +77 -15
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +75 -16
- package/bundled/locales/zh-TW/skills/dev-methodology/guide.md +255 -0
- package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +125 -64
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +5 -5
- package/bundled/locales/zh-TW/skills/knowledge-graph/guide.md +74 -0
- package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +128 -11
- package/bundled/locales/zh-TW/skills/observability-assistant/guide.md +188 -0
- package/bundled/locales/zh-TW/skills/orchestrate/SKILL.md +3 -2
- package/bundled/locales/zh-TW/skills/plan/SKILL.md +3 -2
- package/bundled/locales/zh-TW/skills/push/SKILL.md +3 -2
- package/bundled/locales/zh-TW/skills/retrospective-assistant/SKILL.md +94 -28
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +84 -28
- package/bundled/locales/zh-TW/skills/runbook-assistant/guide.md +216 -0
- package/bundled/locales/zh-TW/skills/slo-assistant/guide.md +188 -0
- package/bundled/locales/zh-TW/skills/spec-derivation/guide.md +476 -0
- package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +148 -77
- package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +141 -44
- package/bundled/skills/brainstorm-assistant/SKILL.md +142 -106
- package/bundled/skills/brainstorm-assistant/guide.md +256 -661
- package/bundled/skills/commands/brainstorm.md +51 -30
- package/bundled/skills/knowledge-graph/SKILL.md +5 -5
- package/bundled/skills/knowledge-graph/guide.md +4 -4
- package/package.json +2 -2
- package/src/commands/check.js +11 -2
- package/src/lint/i18n.js +109 -23
- package/standards-registry.json +4 -4
- package/bundled/locales/zh-TW/docs/SKILL-FALLBACK-GUIDE.md +0 -407
|
@@ -10,48 +10,50 @@ argument-hint: "[problem or feature idea | 問題或功能構想]"
|
|
|
10
10
|
|
|
11
11
|
> **Language**: English | [繁體中文](../../locales/zh-TW/skills/brainstorm-assistant/SKILL.md)
|
|
12
12
|
|
|
13
|
-
Structured ideation before specification writing. Transform vague ideas into actionable feature proposals through guided brainstorming — grounded in
|
|
13
|
+
Structured ideation before specification writing. Transform vague ideas into actionable feature proposals through guided brainstorming — grounded in 2024–2026 research on AI-assisted ideation.
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
在撰寫規格前進行結構化發想。以 2024–2026 年 AI 輔助發想研究為基礎,透過引導式腦力激盪,將模糊構想轉化為可執行的功能提案。
|
|
16
16
|
|
|
17
|
-
> **Implements**: XSPEC-
|
|
17
|
+
> **Implements**: XSPEC-247 brainstorm v3 — Multi-Persona Ensemble + Multi-Critic Convergence
|
|
18
|
+
> (supersedes the v2 "cognitive science upgrade").
|
|
19
|
+
|
|
20
|
+
**What changed in v3 | v3 的核心改動:** Divergence is no longer a single AI voice racing to a count — it is a **persona ensemble** (each role reasons via chain-of-thought, in isolation) crossed with **diversity lenses**. Convergence is no longer one AI scorer plus one devil's-advocate — it is a **multi-critic panel** plus a **hard-role rebuttal** (Devil's Advocate + Steelman). This directly targets the strongest finding in the literature: multiple personas beat a single pass, and a single LLM critic is weak and prone to sycophancy.
|
|
21
|
+
|
|
22
|
+
v3 把發散從「單一 AI 衝數量」改為**persona 集成**(每個角色以思維鏈獨立推理)× **多樣性透鏡**;把收斂從「單一 AI 評分 + 單一反駁」改為**多評審面板** + **硬角色反駁**(Devil's Advocate + Steelman)。直接對應文獻最強結論:多 persona 勝過單一 pass,單一 LLM 評審既弱又易諂媚。
|
|
18
23
|
|
|
19
24
|
## Mode Selection | 使用前先選模式
|
|
20
25
|
|
|
21
|
-
Apply these **objective triggers** before starting. Default is full
|
|
26
|
+
Apply these **objective triggers** before starting. Default is full v3 — routing rules are shortcuts to skip phases, not barriers to add.
|
|
22
27
|
|
|
23
|
-
使用前套用以下**客觀觸發條件**。預設為完整
|
|
28
|
+
使用前套用以下**客觀觸發條件**。預設為完整 v3,路由規則是跳過階段的快捷鍵,而非額外障礙。
|
|
24
29
|
|
|
25
30
|
| Condition | Recommended Mode | Command |
|
|
26
31
|
|-----------|-----------------|---------|
|
|
27
|
-
| Problem description < 20 words **or** topic feels vague | Full
|
|
28
|
-
| Strategic question (career, architecture, business model) | Full
|
|
32
|
+
| Problem description < 20 words **or** topic feels vague | Full v3 (default) | `/brainstorm [topic]` |
|
|
33
|
+
| Strategic question (career, architecture, business model) | Full v3 with rebuttal | `/brainstorm [topic]` |
|
|
34
|
+
| Host supports parallel subagents and you want maximum diversity | Full v3 + Enhanced tier | `/brainstorm --enhanced [topic]` |
|
|
29
35
|
| Creative-only (naming, tagline, marketing copy) | Lite — skip rebuttal | `/brainstorm --no-rebuttal [topic]` |
|
|
30
36
|
| Time-constrained or execution-type (write code, fix copy) | Quick mode | `/brainstorm --quick [topic]` |
|
|
31
37
|
| Already have an SDD spec for this topic | Skip pre-flight | `/brainstorm --skip-preflight [topic]` |
|
|
32
38
|
|
|
33
|
-
> **Rule of thumb:** If you are unsure which row applies, use full
|
|
39
|
+
> **Rule of thumb:** If you are unsure which row applies, use full v3. The cognitive overhead of deciding is higher than just running the full flow.
|
|
34
40
|
>
|
|
35
|
-
> **判斷原則:** 不確定適用哪一行時,直接用完整
|
|
41
|
+
> **判斷原則:** 不確定適用哪一行時,直接用完整 v3。判斷本身的認知成本高於直接跑完整流程。
|
|
36
42
|
|
|
37
43
|
## Workflow | 工作流程
|
|
38
44
|
|
|
39
45
|
```
|
|
40
|
-
[Mode Selection]
|
|
41
|
-
客觀路由 防止錨定
|
|
46
|
+
[Mode Selection] ─► PRE-FLIGHT ─► FRAME ─► DIVERGE ───────────► CONVERGE ──────────► OUTPUT
|
|
47
|
+
客觀路由 防止錨定 定義問題 persona 集成+透鏡 多評審面板+硬角色反駁 輸出提案
|
|
42
48
|
```
|
|
43
49
|
|
|
44
50
|
---
|
|
45
51
|
|
|
46
|
-
### Phase 0: PRE-FLIGHT | 防止 AI
|
|
52
|
+
### Phase 0: PRE-FLIGHT | 防止 AI 錨定
|
|
47
53
|
|
|
48
|
-
**Why this phase exists:**
|
|
49
|
-
AI output first anchors your thinking to the AI's training-data centre. Writing
|
|
50
|
-
your own ideas *before* the AI generates anything consistently produces more
|
|
51
|
-
diverse and higher-quality results.
|
|
54
|
+
**Why this phase exists:** Independent ideas written *before* the AI generates anything consistently produce more diverse results. In AI-assisted contexts this matters *more*, not less: research on design fixation shows that AI output — being fluent and high-fidelity — **deepens** fixation rather than relieving it (Wadinambiarachchi et al., CHI 2024).
|
|
52
55
|
|
|
53
|
-
**本階段存在的原因:**
|
|
54
|
-
AI 的訓練資料中心。在 AI 生成任何內容之前先寫下自己的想法,能持續產出更多樣、更高品質的結果。
|
|
56
|
+
**本階段存在的原因:** 在 AI 生成任何內容之前先寫下自己的想法,能持續產出更多樣的結果。在 AI 情境下這**更**重要:設計固著研究顯示,流暢、高擬真的 AI 輸出反而**加深**固著(Wadinambiarachchi 等,CHI 2024)。
|
|
55
57
|
|
|
56
58
|
**Before the AI generates any content**, the user completes three items:
|
|
57
59
|
|
|
@@ -63,12 +65,13 @@ AI 的訓練資料中心。在 AI 生成任何內容之前先寫下自己的想
|
|
|
63
65
|
| 2 | Three initial ideas (any format, any quality) | 3 個初始想法(任意形式、不限品質) |
|
|
64
66
|
| 3 | "Solution types I do NOT want" (N/A allowed) | 「我最不想要的解法類型」(可填 N/A) |
|
|
65
67
|
|
|
66
|
-
**After the user submits**, the AI reads all three inputs and proceeds to FRAME.
|
|
67
|
-
The AI's first DIVERGE batch MUST be labelled "Exploring directions you haven't
|
|
68
|
-
mentioned" and MUST NOT duplicate any of the user's three submitted ideas.
|
|
68
|
+
**After the user submits**, the AI reads all three inputs and proceeds to FRAME. The AI's first DIVERGE output MUST explore directions the user did not mention and MUST NOT duplicate the user's three ideas.
|
|
69
69
|
|
|
70
|
-
**使用者提交後**,AI 讀取全部三項輸入再進入 FRAME。AI 的第一批 DIVERGE
|
|
71
|
-
|
|
70
|
+
**使用者提交後**,AI 讀取全部三項輸入再進入 FRAME。AI 的第一批 DIVERGE 輸出必須探索使用者未提及的方向,且不得重複使用者已提交的想法。
|
|
71
|
+
|
|
72
|
+
> **Anti-seed guardrail (new in v3):** Do NOT accept or generate a "like X but for Y" framing as the seed (e.g. "Slack but for doctors"). Such analogical seeds lock the LLM into one solution space and measurably reduce idea variety. Capture the underlying *problem*, not a product analogy.
|
|
73
|
+
>
|
|
74
|
+
> **反種子 guardrail(v3 新增):** 不要用「像 X 但給 Y」的框架當種子(如「給醫生用的 Slack」)。這類產品類比種子會把 LLM 鎖進單一解空間、明顯降低想法多樣性。請捕捉底層**問題**,而非產品類比。
|
|
72
75
|
|
|
73
76
|
**Flag:** `--skip-preflight` bypasses this phase with a one-line warning:
|
|
74
77
|
`⚠ Skipping Pre-flight may cause AI anchoring`
|
|
@@ -90,105 +93,113 @@ Define the problem space clearly before generating ideas.
|
|
|
90
93
|
|
|
91
94
|
---
|
|
92
95
|
|
|
93
|
-
### Phase 2: DIVERGE |
|
|
96
|
+
### Phase 2: DIVERGE | 發散思考(v3:persona 集成 + 多樣性透鏡)
|
|
97
|
+
|
|
98
|
+
> **Core mechanism in v3:** a **persona ensemble**, each persona reasoning via **chain-of-thought** in **isolation**, crossed with **diversity lenses**. Meincke, Mollick & Terwiesch (2024) found that chain-of-thought + personas produces the highest idea diversity of any prompting strategy — close to human groups. A raw idea count is a weak proxy; structurally forcing distinct viewpoints is the real lever.
|
|
99
|
+
>
|
|
100
|
+
> **v3 核心機制:** **persona 集成**——每個 persona 以**思維鏈**在**隔離**狀態下推理——再乘上**多樣性透鏡**。Meincke、Mollick、Terwiesch(2024)發現「思維鏈 + persona」的想法多樣性高於所有受測提示策略,接近人類團體。光衝數量是弱代理;結構性逼出不同視角才是真正槓桿。
|
|
101
|
+
|
|
102
|
+
#### Step 2a — Persona ensemble | persona 集成
|
|
94
103
|
|
|
95
|
-
Generate ideas
|
|
96
|
-
required before CONVERGE unlocks. The "Enter CONVERGE" option is hidden until
|
|
97
|
-
this gate is met.
|
|
104
|
+
Generate ideas through a default ensemble of personas. Each persona reasons **step by step (chain-of-thought)** and produces 2–4 ideas **from its own lens only**. The user may add, drop, or rename personas via `--personas`.
|
|
98
105
|
|
|
99
|
-
|
|
100
|
-
選項不顯示。
|
|
106
|
+
透過預設 persona 組生成想法。每個 persona **逐步推理(思維鏈)**,**只從自己的視角**產出 2–4 個想法。使用者可用 `--personas` 增減或改名。
|
|
101
107
|
|
|
102
|
-
|
|
108
|
+
| Default persona | Lens it argues from | 視角 |
|
|
109
|
+
|-----------------|---------------------|------|
|
|
110
|
+
| **Domain expert** | What does best-practice in this domain demand? | 領域最佳實務要求什麼? |
|
|
111
|
+
| **Skeptic / risk** | Where does this break? What fails first? | 哪裡會壞?什麼先失敗? |
|
|
112
|
+
| **Cross-domain analogist** | How do biology / other fields solve an analogous problem? | 生物/他領域如何解類似問題? |
|
|
113
|
+
| **Cost / constraint** | What is the cheapest, smallest thing that works? | 最便宜最小可行解是什麼? |
|
|
114
|
+
| **End-user advocate** | What does the actual user feel and need? | 真實使用者的感受與需求? |
|
|
103
115
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
116
|
+
> **Branch isolation:** In baseline mode, generate each persona's ideas **without showing it the other personas' output** — this prevents intra-session anchoring. Present all personas' ideas together only *after* every persona has produced its set. (In the Enhanced tier, run personas as parallel isolated agents — see "Enhanced Tier" below.)
|
|
117
|
+
>
|
|
118
|
+
> **分支隔離:** baseline 模式下,生成每個 persona 的想法時**不讓它看到其他 persona 的輸出**,以防止 session 內錨定。等所有 persona 都產完才一起呈現。(Enhanced 層以平行隔離 agent 跑——見下方「Enhanced Tier」。)
|
|
119
|
+
|
|
120
|
+
#### Step 2b — Diversity lenses | 多樣性透鏡
|
|
107
121
|
|
|
108
|
-
|
|
122
|
+
Apply at least one lens across the ensemble to push past the "obvious answer zone." Connecting disparate concepts measurably increases originality (Mehrotra, Parab & Gulwani, 2024).
|
|
109
123
|
|
|
110
|
-
|
|
124
|
+
在 persona 組上至少套用一個透鏡,以突破「顯而易見答案區」。連結異域概念能可量測地提升原創性(Mehrotra、Parab、Gulwani,2024)。
|
|
111
125
|
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
126
|
+
| Lens | Prompt pattern | 透鏡 |
|
|
127
|
+
|------|----------------|------|
|
|
128
|
+
| **Analogical / cross-domain** | "Find a system in [biology / logistics / games] that solves an analogous problem. What can we borrow?" | 類比/跨域:借用他領域結構 |
|
|
129
|
+
| **Assumption reversal** | "List what everyone assumes must be true, then invert each one." | 假設反轉:列出共識假設並逐一反轉 |
|
|
130
|
+
| **Morphological matrix** | "Build a 3-axis matrix (e.g. User × Trigger × Constraint); fill rare combinations." | 形態矩陣:系統性填補罕見組合 |
|
|
115
131
|
|
|
116
|
-
|
|
132
|
+
Force `--lens analogical|reversal|morphological` to make a specific lens the primary one.
|
|
117
133
|
|
|
118
|
-
####
|
|
134
|
+
#### Step 2c — Continue nudge (auxiliary) | 繼續發散提示(輔助)
|
|
119
135
|
|
|
120
|
-
-
|
|
121
|
-
- At 10+ ideas: unlock CONVERGE; no upper limit on continuing
|
|
136
|
+
The "best ideas appear in the second half" pattern (Nijstad) is a **human-group** finding and is **not confirmed for LLMs** (which tend to plateau / exhaust). So a fixed idea-count gate is demoted to an **auxiliary nudge**: if fewer than ~8 distinct ideas exist across the ensemble, prompt "Continue — add a persona or lens you haven't used." Diversity (distinct lenses covered), not raw count, is the gate.
|
|
122
137
|
|
|
123
|
-
|
|
138
|
+
「好點子在後半」(Nijstad)是**人類群體**現象,**未在 LLM 證實**(LLM 多為高原/枯竭)。故固定數量門檻降為**輔助提示**:若全組少於約 8 個相異想法,提示「繼續——加一個還沒用過的 persona 或透鏡」。真正的門檻是**多樣性**(覆蓋了幾個不同視角),而非數量。
|
|
124
139
|
|
|
125
|
-
####
|
|
140
|
+
#### Classic techniques (still available) | 經典技法(仍保留)
|
|
126
141
|
|
|
127
142
|
| Technique | When to Use | 使用時機 |
|
|
128
143
|
|-----------|-------------|----------|
|
|
129
144
|
| **HMW Questions** | Default starting point | 預設起點 |
|
|
130
145
|
| **SCAMPER** | Improving existing features | 改善現有功能 |
|
|
131
|
-
| **Six Thinking Hats** | Need multiple perspectives |
|
|
146
|
+
| **Six Thinking Hats** | Need multiple perspectives (works well as personas) | 需要多角度(很適合當 persona) |
|
|
132
147
|
|
|
133
148
|
---
|
|
134
149
|
|
|
135
|
-
### Phase 3: CONVERGE |
|
|
150
|
+
### Phase 3: CONVERGE | 收斂(v3:多評審面板 + 硬角色反駁)
|
|
151
|
+
|
|
152
|
+
> **Core mechanism in v3:** a **multi-critic panel** replaces the single weighted scorer. A single LLM is a weak, biased evaluator (Li et al., 2025: LLMs are strong at generation/refinement but weak at evaluation — keep the human as final arbiter). Three independent critic lenses score each idea; their scores are aggregated.
|
|
153
|
+
>
|
|
154
|
+
> **v3 核心機制:** **多評審面板**取代單一加權評分者。單一 LLM 是弱且有偏的評估者(Li 等,2025:LLM 強於生成/精煉、弱於評估——人類保留最終裁決權)。三個獨立評審透鏡各自評分後聚合。
|
|
136
155
|
|
|
137
|
-
|
|
156
|
+
#### Step 3a: Multi-critic panel | 多評審面板
|
|
138
157
|
|
|
139
|
-
|
|
158
|
+
Run **three independent critics**, each scoring every idea 1–5 on its own lens. Aggregate (mean) to reduce single-critic bias. Each critic uses the weighted formula below.
|
|
140
159
|
|
|
141
|
-
|
|
160
|
+
跑**三個獨立評審**,各自以自己的透鏡對每個想法打 1–5 分;取平均聚合以降低單評審偏誤。每位評審皆套用下方加權公式。
|
|
142
161
|
|
|
143
|
-
|
|
|
144
|
-
|
|
145
|
-
|
|
|
146
|
-
|
|
|
147
|
-
|
|
|
148
|
-
|
|
162
|
+
| Critic lens | Weighted criteria it owns | 評審透鏡 |
|
|
163
|
+
|-------------|---------------------------|----------|
|
|
164
|
+
| **Engineering feasibility** | Feasibility 50% · Effort 50% | 工程可行性 |
|
|
165
|
+
| **User impact** | Impact 70% · Alignment 30% | 使用者影響 |
|
|
166
|
+
| **Strategic alignment** | Alignment 60% · Impact 40% | 策略一致性 |
|
|
167
|
+
|
|
168
|
+
Per-criterion guide (1–5): Feasibility (5=trivial … 1=near-impossible); Impact (5=transformative … 1=negligible); Effort (5=hours … 1=quarters, inverted so lower effort scores higher); Alignment (5=core mission … 1=off-mission).
|
|
169
|
+
|
|
170
|
+
> **Optional — RICE / ICE (product features):** for prioritising shippable features, score `RICE = (Reach × Impact × Confidence) / Effort` or the lighter `ICE = Impact × Confidence × Ease`. Let engineers — not the LLM — estimate Effort; the LLM lacks codebase knowledge. RICE favours incremental wins, so don't use it alone for strategic bets.
|
|
171
|
+
>
|
|
172
|
+
> **可選——RICE / ICE(產品功能):** 排序可出貨功能時用 `RICE =(Reach × Impact × Confidence)/ Effort` 或較輕的 `ICE = Impact × Confidence × Ease`。Effort 交由工程師估、不要讓 LLM 估(它無程式庫知識)。RICE 偏好漸進式勝利,別單獨用於策略性押注。
|
|
149
173
|
|
|
150
|
-
#### Step 3b: Rebuttal Round |
|
|
174
|
+
#### Step 3b: Hard-role Rebuttal Round | 硬角色反駁輪
|
|
151
175
|
|
|
152
|
-
|
|
153
|
-
produce more and better ideas than groups following "no-criticism" rules.
|
|
154
|
-
Challenging the top ideas before committing prevents selecting ideas that merely
|
|
155
|
-
*sound* good under positive-only evaluation.
|
|
176
|
+
A soft "please critique this" instruction yields mostly agreement (sycophancy). v3 assigns **hard roles**: for each of the **top 3 ideas**, run a **Devil's Advocate** ("Your job is to argue this idea WILL fail") and a **Steelman** ("State the strongest charitable version of the counterargument"). Together they stress-test resilience rather than merely poke.
|
|
156
177
|
|
|
157
|
-
|
|
158
|
-
產出更多更好的想法。在確定前挑戰最佳想法,能防止選出只是在正向評估下「聽起來不錯」的方案。
|
|
178
|
+
軟性「請批評一下」只會得到附和(諂媚)。v3 指派**硬角色**:對**前三名想法**各跑一個 **Devil's Advocate**(「你的任務是論證此案會失敗」)與一個 **Steelman**(「說出反方最強而善意的版本」)。兩者一起壓力測試韌性,而非只是戳。
|
|
159
179
|
|
|
160
|
-
|
|
161
|
-
counterarguments** in the format: "This idea will fail in [context] because
|
|
162
|
-
[reason]." Vague concerns ("this might be hard") are not acceptable.
|
|
180
|
+
Each counterargument must take the form: "This idea will fail in [specific context] because [specific reason]." Vague concerns ("this might be hard") are rejected.
|
|
163
181
|
|
|
164
|
-
|
|
165
|
-
因為 [原因]。」模糊的顧慮(「這可能有點困難」)不可接受。
|
|
182
|
+
每個反對理由須為:「在 [具體情境] 下,此想法會失敗,因為 [具體原因]。」模糊顧慮(「這可能有點難」)不接受。
|
|
166
183
|
|
|
167
|
-
The user **must** respond to each
|
|
184
|
+
The user **must** respond to each before advancing:
|
|
168
185
|
|
|
169
|
-
|
|
186
|
+
使用者必須對每個給出回應才能繼續:
|
|
170
187
|
|
|
171
188
|
| Option | Action | 說明 |
|
|
172
189
|
|--------|--------|------|
|
|
173
190
|
| (a) | Accept criticism → provide modified version | 接受批評 → 提供修改版本 |
|
|
174
|
-
| (b) | Disagree → provide reason to retain | 不同意 →
|
|
191
|
+
| (b) | Disagree → provide specific reason to retain | 不同意 → 給具體保留理由 |
|
|
175
192
|
| (c) | Criticism valid → remove from ranking | 批評成立 → 從排名移除 |
|
|
176
193
|
|
|
177
|
-
**Flag:** `--no-rebuttal` skips this step; report section marked
|
|
178
|
-
"Rebuttal: skipped".
|
|
194
|
+
**Flag:** `--no-rebuttal` skips this step; report section marked "Rebuttal: skipped".
|
|
179
195
|
|
|
180
196
|
---
|
|
181
197
|
|
|
182
198
|
### Phase 4: OUTPUT | 輸出提案
|
|
183
199
|
|
|
184
|
-
Produce a Brainstorm Report ready for `/requirement` or `/sdd`.
|
|
200
|
+
Produce a Brainstorm Report ready for `/requirement` or `/sdd`. Each surviving idea is marked `✓ Passed rebuttal` with a one-line summary of the user's response, its originating persona/lens, and its aggregated critic score.
|
|
185
201
|
|
|
186
|
-
產生可直接對接 `/requirement` 或 `/sdd`
|
|
187
|
-
|
|
188
|
-
Each idea that passed the rebuttal round is marked `✓ Passed rebuttal` with a
|
|
189
|
-
one-line summary of the user's response.
|
|
190
|
-
|
|
191
|
-
通過反駁輪的想法標記 `✓ Passed rebuttal` 及使用者回應摘要一行。
|
|
202
|
+
產生可直接對接 `/requirement` 或 `/sdd` 的腦力激盪報告。每個存活想法標記 `✓ Passed rebuttal`、使用者回應摘要、來源 persona/透鏡、以及聚合評審分數。
|
|
192
203
|
|
|
193
204
|
## Output Format | 輸出格式
|
|
194
205
|
|
|
@@ -196,51 +207,73 @@ one-line summary of the user's response.
|
|
|
196
207
|
# Brainstorm Report: [Topic]
|
|
197
208
|
|
|
198
209
|
## Problem Statement
|
|
199
|
-
[Refined problem from FRAME
|
|
210
|
+
[Refined problem + root cause from FRAME]
|
|
200
211
|
|
|
201
212
|
## HMW Questions
|
|
202
213
|
1. How might we ...?
|
|
203
|
-
2. How might we ...?
|
|
204
|
-
3. How might we ...?
|
|
205
214
|
|
|
206
215
|
## Ideas Generated
|
|
207
|
-
| # | Idea |
|
|
208
|
-
|
|
209
|
-
| 1 | ... |
|
|
210
|
-
| 2 | ... | B2 | HMW | 3/5 | 4/5 | 3.5 |
|
|
216
|
+
| # | Idea | Persona | Lens | Critic-Feas | Critic-Impact | Critic-Align | Agg. Score |
|
|
217
|
+
|---|------|---------|------|-------------|---------------|--------------|-----------|
|
|
218
|
+
| 1 | ... | Skeptic | Reversal | 4.0 | 4.5 | 4.0 | 4.2 |
|
|
211
219
|
|
|
212
220
|
## Top 3 Recommendations
|
|
213
|
-
1. **[Idea
|
|
214
|
-
|
|
215
|
-
|
|
221
|
+
1. **[Idea]** ✓ Passed rebuttal — [Why] — Persona: [..] — [User rebuttal response]
|
|
222
|
+
|
|
223
|
+
## Diversity Note
|
|
224
|
+
[How many distinct lenses/personas the surviving ideas span — flag if all from one cluster]
|
|
225
|
+
|
|
226
|
+
## Discarded Ideas (with reasons)
|
|
227
|
+
| Idea | Reason |
|
|
216
228
|
|
|
217
229
|
## Next Steps
|
|
218
230
|
- [ ] Proceed to `/requirement` with top idea
|
|
219
231
|
- [ ] Proceed to `/sdd` if requirements are clear
|
|
220
|
-
- [ ] Need further exploration of idea #N
|
|
221
232
|
```
|
|
222
233
|
|
|
234
|
+
## Diversity-Collapse Guardrail | 多樣性崩塌防護
|
|
235
|
+
|
|
236
|
+
Using a single LLM for ideation reduces the **diversity of ideas across users**, even when each individual feels more creative (Anderson, Shah & Kreminski, 2024; corroborated by the widely-cited Doshi & Hauser, *Science Advances* 2024). Guard against it:
|
|
237
|
+
|
|
238
|
+
用單一 LLM 發想會降低**跨使用者的想法多樣性**,即使個人覺得更有創意(Anderson、Shah、Kreminski,2024;與廣為引用的 Doshi & Hauser,《Science Advances》2024 同向)。防範方式:
|
|
239
|
+
|
|
240
|
+
- **Never seed** with a competitor or product analogy ("like X but for Y"). | 絕不用競品/產品類比當種子。
|
|
241
|
+
- **Vary the lens**, not just the wording — reword ≠ diversify. | 變的是透鏡而非措辭——換句話不等於多樣化。
|
|
242
|
+
- If the surviving Top 3 all came from one persona/lens, **flag it** and run one more lens before OUTPUT. | 若前三名全來自同一 persona/透鏡,**標示**並在輸出前再跑一個透鏡。
|
|
243
|
+
|
|
244
|
+
## Enhanced Tier — Parallel Personas | 強化層——平行 persona
|
|
245
|
+
|
|
246
|
+
Multi-agent ideation (independent agents conversing/contributing) outperforms a single agent on perceived quality and novelty (Quan et al., 2025, *MultiColleagues*). Where the host supports parallel subagents (e.g. Claude Code's Agent/Workflow tools), `--enhanced` runs each persona — and each critic — as a **parallel, context-isolated agent**, then merges and de-duplicates the results.
|
|
247
|
+
|
|
248
|
+
多 agent 發想(獨立 agent 互相對話/貢獻)在感知品質與新穎度上勝過單 agent(Quan 等,2025,*MultiColleagues*)。在支援平行子代理的宿主(如 Claude Code 的 Agent/Workflow 工具),`--enhanced` 會把每個 persona 與每個評審當作**平行、context 隔離的 agent** 跑,再合併去重。
|
|
249
|
+
|
|
250
|
+
> **Graceful degradation:** This tier is **optional**. On hosts without subagents, `--enhanced` silently falls back to baseline (single-context simulated personas). The skill remains `scope: universal`.
|
|
251
|
+
>
|
|
252
|
+
> **優雅降級:** 此層為**可選**。在無子代理的宿主,`--enhanced` 靜默退回 baseline(單 context 模擬 persona)。本 skill 維持 `scope: universal`。
|
|
253
|
+
|
|
223
254
|
## Technique Quick Reference | 技法速覽
|
|
224
255
|
|
|
225
|
-
| Technique | Purpose |
|
|
226
|
-
|
|
227
|
-
| **5 Whys** | Root cause analysis |
|
|
228
|
-
| **HMW** | Problem reframing |
|
|
229
|
-
| **
|
|
230
|
-
| **
|
|
231
|
-
| **
|
|
256
|
+
| Technique | Purpose | 用途 |
|
|
257
|
+
|-----------|---------|------|
|
|
258
|
+
| **5 Whys** | Root cause analysis | 根因分析 |
|
|
259
|
+
| **HMW** | Problem reframing | 問題重構 |
|
|
260
|
+
| **Persona ensemble** | Forced viewpoint diversity (v3 core) | 強制視角多樣性(v3 核心) |
|
|
261
|
+
| **Diversity lenses** | Push past obvious zone (analogical / reversal / morphological) | 突破顯而易見區 |
|
|
262
|
+
| **Multi-critic panel** | Bias-reduced scoring (v3 core) | 降偏誤評分(v3 核心) |
|
|
263
|
+
| **Devil's Advocate + Steelman** | Hard-role rebuttal | 硬角色反駁 |
|
|
264
|
+
| **SCAMPER / Six Hats** | Classic divergence (usable as personas) | 經典發散(可當 persona) |
|
|
232
265
|
|
|
233
266
|
## Session Self-Evaluation | 工作階段自評
|
|
234
267
|
|
|
235
|
-
After each session, record three metrics (1–5
|
|
268
|
+
After each session, record three metrics (1–5) to track improvement over time.
|
|
236
269
|
|
|
237
|
-
|
|
270
|
+
每次工作階段結束後記錄三個指標(1–5 分),追蹤長期改善。
|
|
238
271
|
|
|
239
272
|
| Metric | Question | 指標 |
|
|
240
273
|
|--------|----------|------|
|
|
241
|
-
| **Adoption Rate** | How many of today's ideas will I actually use? |
|
|
242
|
-
| **Diversity** |
|
|
243
|
-
| **Cognitive Load** | How mentally taxing was this
|
|
274
|
+
| **Adoption Rate** | How many of today's ideas will I actually use? | 採用率 |
|
|
275
|
+
| **Diversity** | Did surviving ideas span multiple personas/lenses? | 多樣性(跨幾個 persona/透鏡) |
|
|
276
|
+
| **Cognitive Load** | How mentally taxing was this? (5 = effortless) | 認知負擔 |
|
|
244
277
|
|
|
245
278
|
Collect 3 sessions before drawing conclusions. See [guide.md](./guide.md) for the full A/B experiment protocol.
|
|
246
279
|
|
|
@@ -250,6 +283,9 @@ Collect 3 sessions before drawing conclusions. See [guide.md](./guide.md) for th
|
|
|
250
283
|
|
|
251
284
|
| Flag | Effect | 說明 |
|
|
252
285
|
|------|--------|------|
|
|
286
|
+
| `--personas "a,b,c"` | Override the default persona ensemble | 覆寫預設 persona 組 |
|
|
287
|
+
| `--lens analogical\|reversal\|morphological` | Force a primary diversity lens | 指定主要多樣性透鏡 |
|
|
288
|
+
| `--enhanced` | Parallel persona/critic agents (falls back if unsupported) | 平行 persona/評審 agent(不支援則退回) |
|
|
253
289
|
| `--skip-preflight` | Skip Phase 0 with warning | 跳過 Phase 0,顯示錨定警告 |
|
|
254
290
|
| `--no-rebuttal` | Skip rebuttal round in CONVERGE | 跳過反駁輪,報告標注 skipped |
|
|
255
291
|
| `--quick` | 3-idea fast mode; gates and rebuttal exempt | 快速 3 想法模式;門檻與反駁均豁免 |
|
|
@@ -259,10 +295,11 @@ Collect 3 sessions before drawing conclusions. See [guide.md](./guide.md) for th
|
|
|
259
295
|
|
|
260
296
|
- `/brainstorm` — Start interactive brainstorming session
|
|
261
297
|
- `/brainstorm "user retention"` — Brainstorm around a specific topic
|
|
298
|
+
- `/brainstorm --enhanced "user retention"` — Parallel persona ensemble (if host supports it)
|
|
299
|
+
- `/brainstorm --personas "designer,economist,skeptic" "pricing"` — Custom personas
|
|
300
|
+
- `/brainstorm --lens analogical "onboarding"` — Force the analogical lens
|
|
262
301
|
- `/brainstorm --quick "reduce checkout friction"` — Fast 3-idea mode
|
|
263
|
-
- `/brainstorm --skip-preflight "feature X"` — Skip Pre-flight (with warning)
|
|
264
302
|
- `/brainstorm --no-rebuttal "topic"` — Skip rebuttal round
|
|
265
|
-
- `/brainstorm --technique scamper` — Use a specific technique
|
|
266
303
|
|
|
267
304
|
## Next Steps Guidance | 下一步引導
|
|
268
305
|
|
|
@@ -270,14 +307,13 @@ After `/brainstorm` completes, the AI assistant should suggest:
|
|
|
270
307
|
|
|
271
308
|
> **腦力激盪完成。建議下一步 / Brainstorming complete. Suggested next steps:**
|
|
272
309
|
> - 執行 `/requirement` 將最佳構想轉為使用者故事 — Convert top idea to user stories
|
|
273
|
-
> - 執行 `/sdd` 直接建立規格(若需求已明確)⭐ **Recommended / 推薦** — Create spec directly
|
|
310
|
+
> - 執行 `/sdd` 直接建立規格(若需求已明確)⭐ **Recommended / 推薦** — Create spec directly
|
|
274
311
|
> - 針對特定構想進行更深入探索 — Explore a specific idea further
|
|
275
312
|
|
|
276
313
|
## Reference | 參考
|
|
277
314
|
|
|
278
315
|
- Detailed guide: [guide.md](./guide.md)
|
|
279
316
|
|
|
280
|
-
|
|
281
317
|
## AI Agent Behavior | AI 代理行為
|
|
282
318
|
|
|
283
319
|
> 完整的 AI 行為定義請參閱對應的命令文件:[`/brainstorm`](../commands/brainstorm.md#ai-agent-behavior--ai-代理行為)
|