universal-dev-standards 5.1.1 → 5.3.0

package/bundled/locales/zh-TW/MAINTENANCE.md

@@ -1,12 +1,23 @@
+---
+source: ../../MAINTENANCE.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 維護指南
 
-> **本文件已合併至 [OPERATION-WORKFLOW.md](../../docs/OPERATION-WORKFLOW.md)。**
+> **維護流程已遷至 AsiaOstrich dev-platform 規劃中心。**
+>
+> 自 v2.0.0 起，所有維護工作流程整合至 `OPERATION-WORKFLOW.md`；自 v5.1.1 起依 DEC-047 遷至內部規劃中心（`cross-project/ops/uds-operation.md`）。
 >
-> 自 v2.0.0 起，所有維護工作流程、檔案同步對照表及目錄參考已整合至單一文件。
+> **Maintenance workflow has moved to the AsiaOstrich dev-platform planning hub.**
 >
-> **This document has been merged into [OPERATION-WORKFLOW.md](../../docs/OPERATION-WORKFLOW.md).**
+> Merged into `OPERATION-WORKFLOW.md` in v2.0.0; migrated to internal planning hub in v5.1.1 per DEC-047.
+
+## 快速參考
 
-## 快速連結
+日常維護請遵循 `CLAUDE.md` 中的驗證步驟（§Post-Modification Verification）。
 
-- [Operation Workflow](../../docs/OPERATION-WORKFLOW.md) — 完整維護參考文件
-- [歸檔版本](../../docs/archive/MAINTENANCE-v1.md) — 原始獨立指南 (v1.1.0)
+- [歸檔版本 v1.1.0](../../docs/archive/MAINTENANCE-v1.md) — 原始獨立指南

package/bundled/locales/zh-TW/README.md

@@ -1,3 +1,11 @@
+---
+source: ../../README.md
+source_version: 5.2.0
+translation_version: 5.2.0
+last_synced: 2026-04-22
+status: current
+---
+
 # Universal Development Standards
 
 [![npm version](https://img.shields.io/npm/v/universal-dev-standards.svg)](https://www.npmjs.com/package/universal-dev-standards)
@@ -6,7 +14,7 @@
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 5.1.1 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.3.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 
@@ -55,7 +63,7 @@ npx universal-dev-standards init
 <!-- UDS_STATS_TABLE_START -->
 | 類別 | 數量 | 說明 |
 |----------|-------|-------------|
-| **核心標準** | 72 | 通用開發準則 |
+| **核心標準** | 78 | 通用開發準則 |
 | **AI Skills** | 48 | 互動式技能 |
 | **斜線命令** | 48 | 快速操作 |
 | **CLI 指令** | 6 | list, init, configure, check, update, skills |
@@ -72,8 +80,8 @@ UDS 採用 **雙層執行模型 (Dual-Layer Execution Model)**，專為高速互
 ```mermaid
 graph TD
     A[AI 助手 / 開發者] --> B{執行層}
-    B -- "日常任務" --> C[技能層 Skills (.ai.yaml)]
-    B -- "深度審查" --> D[標準層 Standards (.md)]
+    B -- "日常任務" --> C["技能層 Skills (.ai.yaml)"]
+    B -- "深度審查" --> D["標準層 Standards (.md)"]
     
     C --> C1[Token 最佳化]
     C --> C2[互動式引導]
@@ -96,8 +104,8 @@ graph TD
 
 | AI 工具 | 狀態 | Skills | 斜線命令 | 設定檔 |
 | :--- | :--- | :---: | :---: | :--- |
-| **Claude Code** | ✅ 完整支援 | **26** | **30** | `CLAUDE.md` |
-| **OpenCode** | ✅ 完整支援 | **26** | **30** | `AGENTS.md` |
+| **Claude Code** | ✅ 完整支援 | **29** | **33** | `CLAUDE.md` |
+| **OpenCode** | ✅ 完整支援 | **29** | **33** | `AGENTS.md` |
 | **Gemini CLI** | 🧪 預覽版 | **18+** | **20+** | `GEMINI.md` |
 | **Cursor** | ✅ 完整支援 | **核心** | **模擬支援** | `.cursorrules` |
 | **Cline / Roo Code**| 🔶 部分支援 | **核心** | **工作流** | `.clinerules` |
@@ -145,6 +153,28 @@ uds uninstall   # 從專案移除標準
 
 ---
 
+## 🌐 生態系統
+
+UDS 是 AsiaOstrich 三層產品架構中的**標準定義層**：
+
+```
+UDS（定義什麼） → DevAP（代理人如何執行） → VibeOps（完整生命週期）
+```
+
+| 層級 | 產品 | 角色 | 授權 |
+|------|------|------|------|
+| 標準 | **UDS** | 開發方法論框架 | MIT + CC BY 4.0 |
+| 編排 | [DevAP](https://github.com/AsiaOstrich/dev-autopilot) | 代理人無關的編排引擎 | MIT |
+| 生命週期 | [VibeOps](https://github.com/AsiaOstrich/vibeops360) | AI 驅動的軟體工廠 | AGPL-3.0-only |
+
+- **UDS** 定義開發標準 → 供 DevAP（品質 Gate）和 VibeOps（代理人管線）使用
+- **DevAP** 使用 UDS 標準編排 AI 代理人 → VibeOps 是其消費者之一
+- **VibeOps** 提供完整軟體生命週期 → 透過 `uds init` 整合 UDS（一次複製）
+
+UDS 保持**工具無關性**：支援 Claude Code、OpenCode、Gemini CLI、Cursor、Cline 和 Windsurf。DevAP 和 VibeOps 是消費者，並非必要依賴。
+
+---
+
 ## 📄 授權
 
 | 元件 | 授權 |
@@ -152,6 +182,23 @@ uds uninstall   # 從專案移除標準
 | **文件內容** | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
 | **CLI 工具** | [MIT](../../cli/LICENSE) |
 
+## 致謝
+
+UDS 的架構靈感來自以下傑出的開源專案：
+
+| 專案 | 借鑑概念 | 授權 |
+|------|---------|------|
+| [Superpowers](https://github.com/obra/superpowers) | 系統性除錯、代理人派遣、驗證證據 | MIT |
+| [GSD](https://github.com/gsd-build/get-shit-done) | 結構化任務定義、可追蹤性矩陣、驗證迴圈上限 | MIT |
+| [PAUL](https://github.com/ChristopherKahler/paul) | Plan-Apply-Unify 迴圈、驗收驅動開發 | MIT |
+| [CARL](https://github.com/ChristopherKahler/carl) | 情境感知載入、動態規則注入 | MIT |
+| [CrewAI](https://github.com/crewAIInc/crewAI) | 多代理人通訊協定、情境預算追蹤 | MIT |
+| [LangGraph](https://github.com/langchain-ai/langgraph) | 工作流程狀態協定、HITL 中斷檢查點 | MIT |
+| [OpenHands](https://github.com/All-Hands-AI/OpenHands) | 事件溯源、動作-觀察串流模式 | MIT |
+| [DSPy](https://github.com/stanfordnlp/dspy) | 代理人簽名、結構化 I/O 契約 | MIT |
+
+> **注意**：UDS 僅借鑑概念與方法論，不包含上述專案的任何原始碼。
+
 ---
 
 **由開源社群用 ❤️ 維護**

package/bundled/locales/zh-TW/SECURITY.md

@@ -1,3 +1,11 @@
+---
+source: ../../SECURITY.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 安全政策
 
 ## 支援的版本

package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md

@@ -280,7 +280,7 @@ description: |
 - [CLAUDE.md 範本](../../../templates/CLAUDE.md.template) - 可立即使用的靜態規則範本
 - [Claude Code Skills](../../../skills/README.md) - 技能安裝指南
 - [採用指南](ADOPTION-GUIDE.md) - 整體採用策略
-- [OPERATION-WORKFLOW.md](../../../docs/OPERATION-WORKFLOW.md) - 如何新增/更新技能（維護者專用）
+- 維護者流程指南 — 見內部規劃中心（`cross-project/ops/uds-operation.md`）
 
 ---
 

package/bundled/locales/zh-TW/core/ai-friendly-architecture.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/ai-friendly-architecture.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # AI 友善架構標準
 
 > **語言**: [English](../../../core/ai-friendly-architecture.md) | 繁體中文

package/bundled/locales/zh-TW/core/anti-hallucination.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/anti-hallucination.md
+source_version: 1.5.1
+translation_version: 1.5.1
+last_synced: 2026-04-22
+status: current
+---
+
 # 防幻覺規範 (Anti-Hallucination Standards)
 
 > **語言**: [English](../../../core/anti-hallucination.md) | 繁體中文

package/bundled/locales/zh-TW/core/git-workflow.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/git-workflow.md
+source_version: 1.4.0
+translation_version: 1.4.0
+last_synced: 2026-04-22
+status: current
+---
+
 # Git 工作流程標準
 
 > **語言**: [English](../../../core/git-workflow.md) | 繁體中文

package/bundled/locales/zh-TW/core/refactoring-standards.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/refactoring-standards.md
+source_version: 2.1.0
+translation_version: 2.1.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 重構標準
 
 > **語言**: [English](../../../core/refactoring-standards.md) | 繁體中文

package/bundled/locales/zh-TW/core/spec-driven-development.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/spec-driven-development.md
+source_version: 2.2.0
+translation_version: 2.2.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 規格驅動開發 (SDD) 標準
 
 > **語言**: [English](../../../core/spec-driven-development.md) | 繁體中文

package/bundled/locales/zh-TW/core/structured-task-definition.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/structured-task-definition.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 結構化任務定義標準
 
 > **語言**: [English](../../../core/structured-task-definition.md) | 繁體中文

package/bundled/locales/zh-TW/core/test-driven-development.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/test-driven-development.md
+source_version: 1.2.0
+translation_version: 1.2.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 測試驅動開發 (TDD) 標準
 
 > **語言**: [English](../../../core/test-driven-development.md) | 繁體中文

package/bundled/locales/zh-TW/core/versioning.md

@@ -242,7 +242,7 @@ CHANGELOG **不應**記錄以下類型的變更：
 | 類別 | 常見目錄/檔案 | 原因 |
 |------|--------------|------|
 | AI 協作輔助 | `.claude/`, `.cursor/`, `.ai/` | 本地開發輔助，不納入版控 |
-| 開發規範 | `.standards/`, `docs/internal/` | 本地規範文件，不納入版控 |
+| 開發規範 | `.standards/` | 本地規範文件，不納入版控 |
 | 建置輸出 | `dist/`, `build/`, `out/` | 建置產物，不納入版控 |
 | 大型資料 | `data/`, `datasets/` | 資料檔案，不納入版控 |
 

package/bundled/locales/zh-TW/core/workflow-enforcement.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/workflow-enforcement.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 工作流程強制執行標準
 
 **適用範圍**：所有使用結構化開發方法論的軟體專案

package/bundled/locales/zh-TW/core/workflow-state-protocol.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/workflow-state-protocol.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 工作流程狀態協議
 
 > **語言**: [English](../../../core/workflow-state-protocol.md) | 繁體中文

package/bundled/locales/zh-TW/docs/CHEATSHEET.md

@@ -1,3 +1,11 @@
+---
+source: ../../../docs/CHEATSHEET.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # UDS 速查表
 
 > Quick reference for all UDS features | Last updated: 2026-03-24

package/bundled/locales/zh-TW/docs/CLI-FLOW.md

@@ -1,3 +1,11 @@
+---
+source: ../../../docs/CLI-FLOW.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # CLI 指令流程
 
 > **Language**: [English](../../../docs/CLI-FLOW.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CLI-FLOW.md)

package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md

@@ -1,3 +1,11 @@
+---
+source: ../../../docs/FEATURE-REFERENCE.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # UDS 功能參考手冊
 
 > Universal Development Standards - 完整功能文件

package/bundled/locales/zh-TW/docs/MIGRATION-V5.md

@@ -1,3 +1,11 @@
+---
+source: ../../../docs/archive/MIGRATION-V5.md
+source_version: 5.0.0
+translation_version: 5.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # 遷移指南：Universal Dev Standards V5
 
 > **語言**: English | [繁體中文](MIGRATION-V5.md)

package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md

@@ -1,3 +1,11 @@
+---
+source: ../../../docs/STANDARDS-REFERENCE.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # UDS 核心規範與業界標準對照表
 # UDS Core Standards vs Industry Standards Reference
 

package/bundled/locales/zh-TW/integrations/claude-code/README.md

@@ -1,3 +1,11 @@
+---
+source: ../../../../integrations/claude-code/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-22
+status: current
+---
+
 # Claude Code 整合
 
 > **語言**: English | [繁體中文](README.md)

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

@@ -0,0 +1,178 @@
+---
+name: deploy
+source: ../../../../skills/deploy-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-26
+status: current
+description: "[UDS] 引導無 CI/CD 平台下的可靠部署 — 生成 deploy.sh、verify.sh、rollback.sh、Makefile"
+allowed-tools: Read, Bash(cat VERSION:*), Bash(git describe:*), Bash(which nginx:*), Bash(which rsync:*)
+argument-hint: "[project type | 專案類型: node/python/docker/go]"
+---
+
+# 無 CI/CD 部署助手
+
+> **語言**: [English](../../../../skills/deploy-assistant/SKILL.md) | 繁體中文
+
+在沒有 GitHub Actions 或 GitLab CI 的環境中，引導建立可靠的部署腳本組。採用三層架構：防錯、驗證、回復。
+
+## 三層部署架構
+
+```
+Layer 1: 防止錯誤部署
+  └─ set -euo pipefail + 版本 tag 強制 + deploy.lock
+
+Layer 2: 驗證部署正確
+  └─ Smoke Test + /health 端點 + 版本號比對 + 自動 rollback
+
+Layer 3: 快速回復能力
+  └─ Blue-Green 切換（Nginx）+ rollback.sh（< 30 秒）
+```
+
+## 引導式問答
+
+Skill 啟動後，AI 助手應詢問：
+
+| 問題 | 選項 | 影響 |
+|------|------|------|
+| 專案類型 | 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 "❌ 請先建立版本 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..."; ./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 失敗，等待 5s..."
+  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 "Current 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 "Health check failed"
+```
+
+## 使用方式
+
+```bash
+/deploy              # 互動式引導，自動偵測專案類型
+/deploy node         # 指定 Node.js 專案直接生成
+/deploy docker       # Docker Compose 部署模式
+/deploy --verify-only  # 只生成 verify.sh
+```
+
+## 輸出確認清單
+
+生成後，AI 助手必須確認：
+
+- [ ] `deploy.sh` 包含 `set -euo pipefail`
+- [ ] `deploy.sh` 包含 deploy.lock 防並發邏輯
+- [ ] `verify.sh` 比對版本號（不只檢查 HTTP 200）
+- [ ] `rollback.sh` 在驗證失敗時自動觸發
+- [ ] `Makefile` 提供 `make deploy / make rollback / make status`
+
+## 下一步引導
+
+`/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)
+- 相關 Skill：[ci-cd-assistant](../../skills/ci-cd-assistant/SKILL.md) — 有 CI/CD 平台的場景