universal-dev-standards 5.14.0 → 5.16.0

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/commands/brainstorm.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-19
+source_version: 3.0.0
+source_hash: 3212203924de
+translation_version: 3.0.0
+last_synced: 2026-06-01
 ---
 
 ---
 name: brainstorm
-description: "[UDS] Structured AI-assisted brainstorming before spec creation"
+description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
 argument-hint: "[problem or feature idea | 問題或功能構想]"
 ---
 
@@ -15,9 +16,7 @@ argument-hint: "[problem or feature idea | 問題或功能構想]"
 
 > **Language**: [English](../../../../skills/commands/brainstorm.md) | 繁體中文
 
-在撰寫規格前進行結構化發想。透過引導式腦力激盪，將模糊構想轉化為可執行的功能提案。
-
----
+在撰寫規格前進行結構化發想。透過 persona 集成式腦力激盪，將模糊構想轉化為可執行的功能提案。
 
 ## 用法
 
@@ -28,33 +27,37 @@ argument-hint: "[problem or feature idea | 問題或功能構想]"
 ## 工作流程
 
 ```
-FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
-定義問題     發散思考       收斂評估       輸出提案
+PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► CONVERGE ─────────► OUTPUT
+  防錨定        定義問題    persona 集成+透鏡     多評審面板+硬角色反駁   輸出提案
 ```
 
-| 階段 | 目標 | 關鍵技法 |
-|------|------|----------|
-| **FRAME** | 清楚定義問題 | 5 Whys, HMW, Stakeholder Map |
-| **DIVERGE** | 產生大量想法 | HMW, SCAMPER, Six Thinking Hats |
-| **CONVERGE** | 評估與排序 | Evaluation Matrix, Dot Voting |
-| **OUTPUT** | 可執行的報告 | Brainstorm Report template |
+| 階段 | 目標 | 關鍵技法（v3） |
+|------|------|---------------|
+| **PRE-FLIGHT** | 防止 AI 錨定 | 使用者先寫 3 個想法；無類比種子 |
+| **FRAME** | 清楚定義問題 | 5 Whys、HMW、Stakeholder Map |
+| **DIVERGE** | 逼出視角多樣性 | persona 集成 + 多樣性透鏡 |
+| **CONVERGE** | 降偏誤選擇 | 多評審面板 + Devil's Advocate／Steelman |
+| **OUTPUT** | 可執行的報告 | Brainstorm Report 範本 |
 
 ## 技法
 
 | 技法 | 適用場景 |
 |------|----------|
-| **5 Whys** | 找到根本原因 |
-| **HMW** | 將問題重構為機會 |
-| **SCAMPER** | 改善現有功能 |
-| **Six Thinking Hats** | 多角度分析 |
-| **Dot Voting** | 快速排序 |
+| **Persona ensemble** | 強制視角多樣性（v3 核心） |
+| **Diversity lenses** | 突破顯而易見區（analogical / reversal / morphological） |
+| **Multi-critic panel** | 降偏誤評分（v3 核心） |
+| **Devil's Advocate + Steelman** | 硬角色反駁 |
+| **5 Whys / HMW / SCAMPER / Six Hats** | 經典框定與發散 |
 
 ## 範例
 
 ```bash
-/brainstorm                           # 啟動互動式會話
-/brainstorm "user retention"          # 針對特定主題腦力激盪
-/brainstorm --technique scamper       # 使用特定技法
+/brainstorm                                          # 啟動互動式工作階段
+/brainstorm "user retention"                         # 針對特定主題腦力激盪
+/brainstorm --enhanced "user retention"              # 平行 persona 集成（若宿主支援）
+/brainstorm --personas "designer,economist,skeptic"  # 自訂 persona
+/brainstorm --lens analogical "onboarding"           # 強制類比透鏡
+/brainstorm --quick "reduce checkout friction"       # 快速 3 想法模式
 ```
 
 ## 輸出格式
@@ -66,9 +69,10 @@ FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
 [Refined problem from FRAME phase]
 
 ## Top 3 Recommendations
-1. **[Idea]** — Score: X.X — [Why recommended]
-2. **[Idea]** — Score: X.X — [Why recommended]
-3. **[Idea]** — Score: X.X — [Why recommended]
+1. **[Idea]** — Agg. X.X ✓ Passed rebuttal — Persona: [..] — [Why recommended]
+
+## Diversity Note
+[How many distinct personas/lenses the surviving ideas span]
 
 ## Next Steps
 - [ ] Proceed to `/requirement` with top idea
@@ -84,8 +88,69 @@ FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
 3. `/sdd` - 建立規格文件
 4. `/derive-all` 或 `/tdd` - 以測試保護進行實作
 
+## AI 代理行為
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### 進入路由
+
+| 輸入 | AI 動作 |
+|------|---------|
+| `/brainstorm` | 啟動 PRE-FLIGHT，請使用者先寫 問題＋3 想法＋反向排除 |
+| `/brainstorm "topic"` | 以指定主題啟動 PRE-FLIGHT，再進入 FRAME |
+| `/brainstorm --personas "a,b,c"` | 以自訂 persona 組進入 DIVERGE |
+| `/brainstorm --lens <name>` | 以指定多樣性透鏡為主進入 DIVERGE |
+| `/brainstorm --enhanced` | 若宿主支援子代理則平行跑 persona／評審，否則靜默退回 baseline |
+
+### 互動腳本
+
+#### PRE-FLIGHT Phase
+1. 請使用者先寫 問題（一句）＋3 個初始想法＋最不想要的解法類型
+2. 拒絕「像 X 但給 Y」種子，改寫為底層問題
+
+🛑 **STOP**: 收到三項輸入前不生成任何想法（`--skip-preflight` 例外，顯示錨定警告）
+
+#### FRAME Phase
+1. 釐清問題陳述（5 Whys 找根因）
+2. 重構為 HMW 問題；識別利害關係人
+
+🛑 **STOP**: 問題定義後等待使用者確認
+
+#### DIVERGE Phase
+1. 逐一以預設 persona（領域專家／懷疑者／跨域類比者／成本約束者／使用者代言）思維鏈生成想法
+2. **分支隔離**：生成各 persona 時不互相預覽，全部產完才一起呈現
+3. 至少套用一個多樣性透鏡（類比／假設反轉／形態矩陣）
+4. 以多樣性（覆蓋的 persona／透鏡數）而非數量為繼續門檻
+
+#### CONVERGE Phase
+1. 以 3 個獨立評審（工程可行性／使用者影響／策略一致）各自評分後聚合
+2. 對前 3 名跑硬角色 Devil's Advocate（論證會失敗）+ Steelman；使用者以 (a)修改／(b)反駁／(c)移除 回應
+3. 排序並標記通過反駁的想法
+
+🛑 **STOP**: 展示 Brainstorm Report 後等待使用者決定下一步
+
+### 停止點
+
+| 停止點 | 等待內容 |
+|--------|---------|
+| PRE-FLIGHT 提交前 | 收到使用者三項輸入 |
+| 問題定義後 | 確認問題正確 |
+| 反駁輪每個反對理由 | 使用者 (a)／(b)／(c) 回應 |
+| 報告展示後 | 決定進入 `/requirement` 或 `/sdd` |
+
+### 錯誤處理
+
+| 錯誤情況 | AI 動作 |
+|---------|---------|
+| 主題太廣泛 | 引導縮小範圍 |
+| 使用「像 X 但給 Y」種子 | 改寫為底層問題再繼續（反種子 guardrail） |
+| 指定的 persona／透鏡不存在 | 列出可用選項供選擇 |
+| `--enhanced` 但宿主不支援子代理 | 靜默退回 baseline，照常進行 |
+| 前 3 名全來自同一 persona／透鏡 | 標示並在輸出前再跑一個透鏡 |
+
 ## 參考
 
 * [Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md)
+* [Brainstorm Assistant Guide](../brainstorm-assistant/guide.md)
 * [Requirement Assistant](../requirement-assistant/SKILL.md)
 * [Spec-Driven Development](../spec-driven-dev/SKILL.md)

package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md

@@ -2,8 +2,9 @@
 name: commit-standards
 source: ../../../../skills/commit-standards/SKILL.md
 source_version: 1.0.0
+source_hash: 8535f438ced8
 translation_version: 1.0.0
-last_synced: 2026-02-10
+last_synced: 2026-06-01
 status: current
 description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 commit message"
 ---
@@ -16,31 +17,34 @@ description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 comm
 
 ## 工作流程
 
+0. **偵測語言** - 讀取 `.standards/manifest.json` → 檢查 `options.output_language`。若找不到，預設為 `english`。
 1. **檢查狀態** - 執行 `git status` 和 `git diff --staged` 了解變更內容
 2. **分析變更** - 判斷類型（feat、fix、refactor 等）和範圍
-3. **產生訊息** - 根據以下格式建立 commit message
+3. **產生訊息** - 依偵測到的語言，按以下對應格式建立 commit message（見下方）
 4. **確認並提交** - 在執行 `git commit` 前詢問使用者確認
 
 ### 訊息格式
 
 ```
 <type>(<scope>): <subject>
+
 <body>
+
 <footer>
 ```
 
 ## 提交類型
 
-| 類型 | 使用時機 | When to Use |
-|------|---------|-------------|
-| `feat` | 新功能 | New feature |
-| `fix` | 修復錯誤 | Bug fix |
-| `refactor` | 重構（無功能變更） | Code refactoring |
-| `docs` | 文件更新 | Documentation |
-| `style` | 格式調整（無邏輯變更） | Formatting |
-| `test` | 測試相關 | Tests |
-| `perf` | 效能優化 | Performance |
-| `chore` | 維護任務 | Maintenance |
+| 類型 | 使用時機 |
+|------|---------|
+| `feat` | 新功能 |
+| `fix` | 修復錯誤 |
+| `refactor` | 重構（無功能變更） |
+| `docs` | 文件更新 |
+| `style` | 格式調整（無邏輯變更） |
+| `test` | 測試相關 |
+| `perf` | 效能優化 |
+| `chore` | 維護任務 |
 
 ## 規則
 
@@ -48,6 +52,60 @@ description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 comm
 - **Body**：說明**為什麼**進行變更，而非僅描述變更了什麼
 - **Footer**：使用 `BREAKING CHANGE:` 標記破壞性變更，使用 `Fixes #123` 關聯 issue
 
+## 雙語格式
+
+當 `output_language` 為 `bilingual` 時，你必須使用以下格式：
+
+```
+<type>(<scope>): <English subject>. <中文主旨>.
+
+<English body — explain what and why in English>
+
+<中文本文 — 用中文說明做了什麼及為什麼>
+
+<footer>
+```
+
+### 必須遵守的規則
+
+1. 英文本文在前，中文本文在後
+2. 英文本文與中文本文之間以空白行分隔
+3. 嚴禁在同一段落內混用語言
+4. 嚴禁省略中文本文——兩種語言皆為必填
+5. Footer（BREAKING CHANGE、Fixes #、Co-authored-by）置於兩段本文之後的最末端
+
+### 雙語範例
+
+```
+feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援.
+
+Implement Google OAuth2 authentication flow for user login.
+
+- Add Google OAuth2 SDK integration
+- Create callback endpoint for OAuth flow
+- Store refresh tokens securely
+
+實作 Google OAuth2 認證流程供使用者登入。
+
+- 整合 Google OAuth2 SDK
+- 建立 OAuth 流程回呼端點
+- 安全儲存更新權杖
+
+Closes #123
+```
+
+## 繁體中文格式
+
+當 `output_language` 為 `traditional-chinese` 時，使用中文類型與本文：
+
+```
+功能(認證): 新增 OAuth2 Google 登入支援
+
+實作 Google OAuth2 認證流程供使用者登入。
+
+關閉 #123
+```
+
 ## 使用方式
 
 - `/commit` - 自動分析 staged 的變更並建議 commit message
@@ -58,11 +116,15 @@ description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 comm
 `/commit` 完成後，AI 助手應建議：
 
 > **提交完成。建議下一步：**
-> - 執行 `git push` 推送到遠端
-> - 準備發布時 → 執行 `/changelog` + `/release`
-> - 發現重複模式或規範摩擦 → 執行 `/audit --report` 回報
+> - 執行 `git push` 推送到遠端 ⭐ **推薦** — 推送到遠端
+> - 準備發布時 → 執行 `/changelog` + `/release` — 準備發布時執行
+> - 發現重複模式或規範摩擦 → 執行 `/audit --report` 回報 — 偵測到模式或摩擦時回報意見
 
 ## 參考
 
 - 詳細指南：[guide.md](./guide.md)
 - 核心規範：[commit-message-guide.md](../../../../core/commit-message-guide.md)
+
+## AI 代理行為
+
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/commit`](../commands/commit.md#ai-agent-behavior--ai-代理行為)

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

@@ -2,8 +2,9 @@
 name: contract-test-assistant
 source: ../../../../skills/contract-test-assistant/SKILL.md
 source_version: 1.0.0
+source_hash: f67623eb913a
 translation_version: 1.0.0
-last_synced: 2026-03-26
+last_synced: 2026-06-01
 status: current
 description: "[UDS] 引導 API 和微服務的合約測試策略"
 ---
@@ -14,6 +15,42 @@ description: "[UDS] 引導 API 和微服務的合約測試策略"
 
 引導 API 和微服務的合約測試策略選擇、設定和驗證。
 
+## 什麼是合約測試？
+
+合約測試透過測試消費者和提供者之間的協議（合約）來驗證服務間的通訊正確性，不需要所有服務同時運行。
+
+## 策略選擇
+
+| 策略 | 適用場景 | 工具 |
+|------|---------|------|
+| **消費者驅動（Consumer-Driven）** | 內部微服務，團隊同時擁有兩端 | Pact |
+| **提供者驅動（Provider-Driven）** | 公開 API，OpenAPI 優先設計 | OpenAPI + Prism |
+| **雙向（Bi-Directional）** | 混合所有權，漸進採用 | Pact + OpenAPI |
+
+## 工作流程
+
+```
+ASSESS ──► CHOOSE ──► DEFINE ──► IMPLEMENT ──► VERIFY
+  評估架構    選擇策略    定義合約     實作測試      驗證合約
+```
+
+### 1. ASSESS — 評估架構
+- 有多少服務互相通訊？
+- 誰擁有消費者端、誰擁有提供者端？
+
+### 2. CHOOSE — 選擇策略
+- 消費者驅動（Pact）vs 提供者驅動（OpenAPI）
+
+### 3. DEFINE — 定義合約
+- 撰寫消費者期望或 OpenAPI 規格
+
+### 4. IMPLEMENT — 實作測試
+- 消費者測試產生合約
+- 提供者測試驗證合約
+
+### 5. VERIFY — 執行驗證
+- CI 管線在每個 PR 上驗證合約
+
 ## 指令
 
 | 指令 | 說明 |
@@ -23,31 +60,53 @@ description: "[UDS] 引導 API 和微服務的合約測試策略"
 | `/contract-test provider` | 引導提供者測試設定 |
 | `/contract-test verify` | 檢查合約覆蓋率 |
 
-## 參考
+## 合約覆蓋率報告
+
+```markdown
+## 合約覆蓋率報告
+
+| 消費者 | 提供者 | 端點 | 狀態 |
+|--------|--------|------|------|
+| web-app | user-api | GET /users/:id | ✅ 已驗證 |
+| web-app | user-api | POST /users | ✅ 已驗證 |
+| mobile-app | auth-api | POST /login | ⚠️ 僅消費者端 |
+| admin-ui | report-api | GET /reports | ❌ 無合約 |
 
-- 詳細指南：[contract-testing.md](../../../../options/testing/contract-testing.md)
-- 技能指南：[guide.md](./guide.md)
+**覆蓋率**：50%（2/4 個端點兩端皆驗證）
+```
 
+## 與其他技能的整合
 
-## Next Steps Guidance | 下一步引導
+| 技能 | 整合方式 |
+|------|---------|
+| `/api-design` | 設計時定義 API 合約 |
+| `/ci-cd` | 管線中加入合約驗證 |
+| `/testing` | 合約測試作為測試策略一部分 |
+| `/migrate` | API 遷移時捕獲 legacy response fixture，驗證新實作保持結構性等價 |
 
-After `/contract-test` completes:
+### 遷移合約測試（替換實作時）
+
+當 API endpoint 從一個技術棧遷至另一個（PHP → .NET、Express → Spring 等），對 **legacy 參考 fixture** 的 contract test 可捕捉「缺漏欄位」「rename」「層級漂移」等新 DTO 單元測試無法覆蓋的缺陷。詳見 [migration-assistant § API Migration Contract Tests](../migration-assistant/SKILL.md#api-migration-contract-tests--api-遷移合約測試) 取得 fixture 捕獲協議與稽核檢查清單。
+
+## 下一步引導
+
+`/contract-test` 完成後：
 
 > **合約測試引導完成。建議下一步：**
 > - 執行 `/ci-cd` 將合約驗證加入 CI 管線
 > - 執行 `/api-design` 完善 API 設計
 > - 執行 `/testing` 整合到整體測試策略
 
-## Reference | 參考
+## 參考
 
-- Detailed guide: [contract-testing.md](../../options/testing/contract-testing.md)
-- Related: [api-design-assistant](../api-design-assistant/SKILL.md)
+- 詳細指南：[contract-testing.md](../../options/testing/contract-testing.md)
+- 相關：[api-design-assistant](../api-design-assistant/SKILL.md)
 
-## AI Agent Behavior | AI 代理行為
+## AI 代理行為
 
-When `/contract-test` is invoked:
-1. **Assess** — Ask about architecture (monolith, microservices, number of APIs)
-2. **Recommend** — Suggest strategy based on architecture
-3. **Guide** — Walk through setup for chosen strategy
-4. **Generate** — Create example contract test files
-5. **Verify** — If `verify` subcommand, scan for contracts and report coverage
+當 `/contract-test` 被呼叫時：
+1. **評估（Assess）** — 詢問架構（單體、微服務、API 數量）
+2. **推薦（Recommend）** — 依架構建議策略
+3. **引導（Guide）** — 逐步引導所選策略的設定
+4. **產生（Generate）** — 建立範例合約測試檔案
+5. **驗證（Verify）** — 若為 `verify` 子指令，掃描合約並回報覆蓋率

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

@@ -0,0 +1,187 @@
+---
+name: deploy
+source: ../../../../skills/deploy-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-05-28
+scope: universal
+description: |
+  [UDS] 無 CI/CD 平台環境下的可靠部署指引（不依賴 GitHub Actions / GitLab CI）。
+  Use when: deploying to VPS, air-gapped servers, or environments without CI/CD infrastructure.
+  Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無CI/CD, 部署.
+allowed-tools: Read, Bash(cat VERSION:*), Bash(git describe:*), Bash(which nginx:*), Bash(which rsync:*)
+argument-hint: "[專案類型: node/python/docker/go]"
+---
+
+# 無 CI/CD 部署助手
+
+> **語言**: [English](../../../../skills/deploy-assistant/SKILL.md) | 繁體中文
+
+引導無 CI/CD 平台環境下的可靠部署，採用三層架構：防錯、驗證、快速回復。
+
+## 三層部署架構
+
+```
+Layer 1：防止錯誤部署            Layer 2：驗證正確性             Layer 3：快速回復
+  set -euo pipefail                Smoke Test + /health           Blue-Green 切換
+  版本 tag 強制                    版本號比對                     rollback.sh < 30s
+  deploy.lock 並發守衛             驗證失敗自動回滾
+```
+
+## 引導式問答
+
+| 問題 | 選項 | 影響 |
+|------|------|------|
+| 專案類型 | node / python / go / docker | 建置指令 |
+| 部署目標 | SSH+rsync / Docker Compose | 傳輸方式 |
+| Blue-Green 支援 | yes / no | rollback.sh 是否生成 |
+| 健康檢查 URL | URL 輸入 | verify.sh 目標 |
+| 版本來源 | VERSION 檔 / package.json / git tag | 版本比對邏輯 |
+
+## 生成的腳本組
+
+### deploy.sh — 主要部署腳本
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+LOCK_FILE="/tmp/deploy.lock"
+trap "rm -f $LOCK_FILE" EXIT
+
+# 防並發守衛
+if [ -f "$LOCK_FILE" ]; then
+  echo "❌ 已有部署進行中（PID: $(cat $LOCK_FILE)）"
+  exit 1
+fi
+echo $$ > "$LOCK_FILE"
+
+# 版本 tag 強制
+CURRENT_TAG=$(git describe --exact-match --tags HEAD 2>/dev/null || echo "")
+if [ -z "$CURRENT_TAG" ]; then
+  echo "❌ HEAD 沒有版本 tag。請執行：git tag vX.Y.Z && git push --tags"
+  exit 1
+fi
+
+echo "[1/4] 執行測試..."
+# {TEST_COMMAND}
+
+echo "[2/4] 建置產物..."
+# {BUILD_COMMAND}
+
+echo "[3/4] 同步至伺服器..."
+rsync -avz --delete ./dist/ {USER}@{SERVER}:/app/
+
+echo "[4/4] 驗證部署..."
+./verify.sh || { echo "驗證失敗，啟動回滾..."; ./rollback.sh; exit 1; }
+
+echo "{\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"version\":\"$CURRENT_TAG\",\"operator\":\"$(whoami)\",\"result\":\"success\"}" >> /var/log/deployments.jsonl
+echo "✅ 部署成功：$CURRENT_TAG"
+```
+
+### verify.sh — Smoke Test
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+HEALTH_URL="${HEALTH_URL:-{HEALTH_URL}}"
+EXPECTED_VERSION=$(cat VERSION)
+
+for i in $(seq 1 3); do
+  RESPONSE=$(curl -sf --max-time 10 "$HEALTH_URL" 2>/dev/null) && break
+  echo "健康檢查第 $i/3 次失敗，5 秒後重試..."
+  sleep 5
+done
+
+ACTUAL_VERSION=$(echo "$RESPONSE" | python3 -c "import json,sys; print(json.load(sys.stdin)['version'])")
+
+if [ "$ACTUAL_VERSION" != "$EXPECTED_VERSION" ]; then
+  echo "❌ 版本不符！預期 $EXPECTED_VERSION，實際 $ACTUAL_VERSION"
+  exit 1
+fi
+
+echo "✅ 版本驗證通過：$ACTUAL_VERSION"
+```
+
+### rollback.sh — Blue-Green 回滾
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+CURRENT=$(readlink /app/current 2>/dev/null || echo "/app/blue")
+TARGET=$([[ "$CURRENT" == *"green"* ]] && echo "/app/blue" || echo "/app/green")
+
+ln -sfn "$TARGET" /app/current
+nginx -s reload
+
+echo "✅ 已回滾至 $TARGET ($(date -u +%Y-%m-%dT%H:%M:%SZ))"
+echo "{\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"event\":\"rollback\",\"from\":\"$CURRENT\",\"to\":\"$TARGET\",\"operator\":\"$(whoami)\"}" >> /var/log/deployments.jsonl
+```
+
+### Makefile
+
+```makefile
+.PHONY: deploy rollback verify status
+
+deploy:
+	@./deploy.sh
+
+rollback:
+	@./rollback.sh
+
+verify:
+	@./verify.sh
+
+status:
+	@echo "目前 slot：$$(readlink /app/current 2>/dev/null || echo 'N/A')"
+	@curl -s $${HEALTH_URL:-http://localhost/health} | python3 -m json.tool 2>/dev/null || echo "健康檢查失敗"
+```
+
+## 輸出確認清單
+
+腳本生成後，AI 助手必須確認：
+
+- [ ] `deploy.sh` 含 `set -euo pipefail`
+- [ ] `deploy.sh` 含 deploy.lock 並發守衛
+- [ ] `verify.sh` 比對版本號（不只是 HTTP 200）
+- [ ] `rollback.sh` 在 verify 失敗時自動觸發
+- [ ] `Makefile` 提供 `make deploy / make rollback / make status`
+
+## 使用方式
+
+```bash
+/deploy              # 互動模式 — 自動偵測專案類型
+/deploy node         # Node.js 專案，直接生成
+/deploy docker       # Docker Compose 部署模式
+/deploy --verify-only  # 僅生成 verify.sh
+```
+
+## 下一步引導
+
+`/deploy` 完成後，AI 助手應建議：
+
+> **部署腳本已生成，建議下一步：**
+> - `chmod +x deploy.sh verify.sh rollback.sh` — 設定執行權限
+> - `make verify` — 測試健康檢查設定
+> - `git tag v1.0.0 && git push --tags` — 建立版本 tag
+> - `make deploy` — 執行第一次部署
+
+## 參考
+
+- 核心標準：[no-cicd-deployment.md](../../../../core/no-cicd-deployment.md)
+- 核心標準：[deployment-standards.md](../../../../core/deployment-standards.md)
+- 核心標準：[deployment-standards.md § Defensive Deployment Ordering](../../../../core/deployment-standards.md#defensive-deployment-ordering) — **強制**遵循 extract-verify-then-delete 順序
+- 核心標準：[packaging-standards.md § Archive Format Integrity](../../../../core/packaging-standards.md#archive-format-integrity) — 消費 archive 前先驗證格式
+- 相關：[ci-cd-assistant](../ci-cd-assistant/SKILL.md) — 適用於有 CI/CD 的環境
+
+## 版本歷史
+
+| 版本 | 日期 | 變更說明 |
+|------|------|----------|
+| 1.0.0 | 2026-04-26 | 初始版本 — XSPEC-085 Phase 1b |
+
+## 授權
+
+CC BY 4.0 — 文件內容