npm - universal-dev-standards - Versions diffs - 4.2.0 → 5.0.0-beta.10 - Mend

universal-dev-standards 4.2.0 → 5.0.0-beta.10

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.

Files changed (542) hide show

package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/methodology.md RENAMED Viewed

@@ -1,5 +1,5 @@
 ---
-source: ../../../../../skills/claude-code/commands/methodology.md
+source: ../../../../skills/commands/methodology.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-12
@@ -15,7 +15,7 @@ status: experimental
 # /methodology 命令
-> **Language**: [English](../../../../../skills/claude-code/commands/methodology.md) | 繁體中文
+> **Language**: [English](../../../../skills/commands/methodology.md) | 繁體中文
 > [!WARNING]
 > **實驗性功能 / Experimental Feature**
@@ -254,7 +254,7 @@ status: experimental
 | 命令 | 說明 |
 |------|------|
 | `/tdd` | 啟動 TDD 工作流（啟用 TDD 方法論） |
-| `/spec` | 啟動 SDD 工作流（啟用 SDD 方法論） |
+| `/sdd` | 啟動 SDD 工作流（啟用 SDD 方法論） |
 | `/config methodology` | 配置方法論設定 |
 ---

package/bundled/locales/zh-TW/skills/{claude-code/commands → commands}/refactor.md RENAMED Viewed

@@ -1,5 +1,5 @@
 ---
-source: skills/claude-code/commands/refactor.md
+source: ../../../../skills/commands/refactor.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-21
@@ -12,7 +12,7 @@ status: stable
 # /refactor 命令
-> **語言**: [English](../../../../../skills/claude-code/commands/refactor.md) | 繁體中文
+> **語言**: [English](../../../../skills/commands/refactor.md) | 繁體中文
 引導重構決策，推薦適合的重構策略。
@@ -159,7 +159,7 @@ AI: 處理遺留程式碼需要安全優先的策略。
 ## 參考
-- [重構標準](../../../core/refactoring-standards.md) - 核心標準
+- [重構標準](../../core/refactoring-standards.md) - 核心標準
 - [重構助手技能](../refactoring-assistant/SKILL.md) - 完整技能
 - [TDD 助手](../tdd-assistant/SKILL.md) - TDD 工作流程

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

@@ -0,0 +1,61 @@
+---
+source: ../../../../skills/commit-standards/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  根據 Conventional Commits 規範產生格式正確的 commit message。
+  使用時機：提交程式碼、撰寫 commit message、檢查提交格式。
+  關鍵字：commit, conventional commits, 提交, 訊息, feat, fix, refactor。
+---
+# Commit Message 助手
+> **語言**: [English](../../../../skills/commit-standards/SKILL.md) | 繁體中文
+根據 staged 的變更，產生符合 Conventional Commits 格式的 commit message。
+## 工作流程
+1. **檢查狀態** - 執行 `git status` 和 `git diff --staged` 了解變更內容
+2. **分析變更** - 判斷類型（feat、fix、refactor 等）和範圍
+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 |
+## 規則
+- **Subject**：祈使語氣、不加句號、首字母大寫、不超過 72 字元
+- **Body**：說明**為什麼**進行變更，而非僅描述變更了什麼
+- **Footer**：使用 `BREAKING CHANGE:` 標記破壞性變更，使用 `Fixes #123` 關聯 issue
+## 使用方式
+- `/commit` - 自動分析 staged 的變更並建議 commit message
+- `/commit fix login bug` - 根據提供的描述產生訊息
+## 參考
+- 詳細指南：[guide.md](./guide.md)
+- 核心規範：[commit-message-guide.md](../../../../core/commit-message-guide.md)

package/bundled/locales/zh-TW/skills/{claude-code/commit-standards → commit-standards}/conventional-commits.md RENAMED Viewed

@@ -1,5 +1,5 @@
 ---
-source: /skills/claude-code/commit-standards/conventional-commits.md
+source: ../../../../skills/commit-standards/conventional-commits.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 # Conventional Commits 指南
-> **語言**: [English](../../../../../skills/claude-code/commit-standards/conventional-commits.md) | 繁體中文
+> **語言**: [English](../../../../skills/commit-standards/conventional-commits.md) | 繁體中文
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -243,9 +243,9 @@ fix: change line 45 from getUserById to getUserByEmail
 ## 相關標準
-- [Commit Message Guide](../../../../../core/commit-message-guide.md)
+- [Commit Message Guide](../../../../core/commit-message-guide.md)
 - [Language Options](./language-options.md)
-- [Git Workflow](../../../../../core/git-workflow.md)
+- [Git Workflow](../../../../core/git-workflow.md)
 ---

package/bundled/locales/zh-TW/skills/{claude-code/commit-standards/SKILL.md → commit-standards/guide.md} RENAMED Viewed

@@ -1,10 +1,9 @@
 ---
-source: skills/claude-code/commit-standards/SKILL.md
+source: ../../../../skills/commit-standards/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
 status: current
-name: commit-standards
 description: |
   遵循約定式提交標準格式化提交訊息。
   使用時機：撰寫提交訊息、git commit、檢視提交歷史。
@@ -13,7 +12,7 @@ description: |
 # 提交訊息標準
-> **語言**: [English](../../../../../skills/claude-code/commit-standards/SKILL.md) | 繁體中文
+> **語言**: [English](../../../../skills/commit-standards/SKILL.md) | 繁體中文
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -170,9 +169,9 @@ feat, fix, refactor, docs, style, test, perf, build, ci, chore, revert, security
 ## 相關標準
-- [提交訊息指南](../../../../../core/commit-message-guide.md)
-- [Git 工作流程](../../../../../core/git-workflow.md)
-- [變更日誌標準](../../../../../core/changelog-standards.md)
+- [提交訊息指南](../../../../core/commit-message-guide.md)
+- [Git 工作流程](../../../../core/git-workflow.md)
+- [變更日誌標準](../../../../core/changelog-standards.md)
 ---

package/bundled/locales/zh-TW/skills/{claude-code/commit-standards → commit-standards}/language-options.md RENAMED Viewed

@@ -1,5 +1,5 @@
 ---
-source: /skills/claude-code/commit-standards/language-options.md
+source: ../../../../skills/commit-standards/language-options.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 # Commit Message 語言選項
-> **語言**: [English](../../../../../skills/claude-code/commit-standards/language-options.md) | 繁體中文
+> **語言**: [English](../../../../skills/commit-standards/language-options.md) | 繁體中文
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -152,7 +152,7 @@ Closes #123
 ## 相關標準
-- [Commit Message Guide](../../../../../core/commit-message-guide.md)
+- [Commit Message Guide](../../../../core/commit-message-guide.md)
 - [Conventional Commits Guide](./conventional-commits.md)
 ---

package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md ADDED Viewed

@@ -0,0 +1,59 @@
+---
+source: ../../../../skills/docs-generator/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-02-10
+status: current
+description: |
+  從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）。
+  使用時機：產生文件、建立速查表、產生參考手冊。
+  關鍵字：docgen, documentation, cheatsheet, reference, 文件產生, 速查表, 參考手冊。
+---
+# 文件產生器
+> **語言**: [English](../../../../skills/docs-generator/SKILL.md) | 繁體中文
+從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）。
+## 工作流程
+1. **讀取設定** - 載入 `.usage-docs.yaml`（或指定的設定檔）
+2. **掃描來源** - 讀取原始碼檔案、命令和技能定義
+3. **提取內容** - 從原始碼解析描述、選項、範例
+4. **產生文件** - 以設定的格式產生輸出
+5. **寫入輸出** - 將產生的檔案儲存到設定的輸出目錄
+## 設定檔格式
+```yaml
+# .usage-docs.yaml
+output_dir: docs/generated/
+formats:
+  - cheatsheet
+  - reference
+sources:
+  - path: skills/commands/
+    type: commands
+  - path: cli/src/commands/
+    type: cli
+language: [en, zh-TW]
+```
+## 輸出類型
+| 類型 | 說明 |
+|------|------|
+| **cheatsheet** | 速查表，包含命令和快捷鍵 |
+| **reference** | 完整功能參考手冊，包含所有選項 |
+| **usage-guide** | 新手入門使用指南 |
+## 使用方式
+- `/docgen` - 使用預設的 `.usage-docs.yaml` 產生文件
+- `/docgen .usage-docs.yaml` - 從指定的設定檔產生文件
+- `/docgen --format cheatsheet` - 僅產生速查表
+## 參考
+- 詳細指南：[guide.md](./guide.md)

package/bundled/locales/zh-TW/skills/docs-generator/guide.md ADDED Viewed

@@ -0,0 +1,262 @@
+---
+description: |
+  從專案來源產生使用說明文件。
+  使用時機：「產生文件」、「建立速查表」、「使用指南」、「功能參考」、「列出所有功能」
+  關鍵字：documentation, usage, reference, cheatsheet, features, 功能文件, 速查表, 使用說明
+source: ../../../../skills/docs-generator/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-26
+status: current
+---
+# 文件產生器技能
+> **Language**: [English](../../../../skills/docs-generator/SKILL.md) | 繁體中文
+**版本**: 1.0.0
+**最後更新**: 2026-01-26
+**適用範圍**: Claude Code Skills
+---
+## 用途
+自動從專案來源檔案產生完整的使用說明文件。此技能會建立：
+1. **FEATURE-REFERENCE.md**：包含所有細節的完整功能文件
+2. **CHEATSHEET.md**：單頁速查表
+支援多語言（英文、繁體中文、簡體中文），並掃描各種來源：
+- CLI 指令
+- 斜線命令
+- 技能
+- 代理
+- 工作流程
+- 核心規範
+- 腳本
+## 快速參考
+### 產生所有文件
+```bash
+node scripts/generate-usage-docs.mjs
+```
+### 產生特定語言
+```bash
+node scripts/generate-usage-docs.mjs --lang=en       # 僅英文
+node scripts/generate-usage-docs.mjs --lang=zh-TW    # 繁體中文
+node scripts/generate-usage-docs.mjs --lang=zh-CN    # 簡體中文
+```
+### 產生特定格式
+```bash
+node scripts/generate-usage-docs.mjs --cheatsheet    # 僅速查表
+node scripts/generate-usage-docs.mjs --reference     # 僅參考手冊
+```
+### 檢查同步狀態
+```bash
+# 檢查文件是否需要更新
+node scripts/generate-usage-docs.mjs --check
+# 或使用同步檢查腳本
+./scripts/check-usage-docs-sync.sh         # 檢查
+./scripts/check-usage-docs-sync.sh --fix   # 需要時修復
+```
+## 配置
+產生器使用專案根目錄的 `.usage-docs.yaml` 來定義：
+- **輸出路徑**：文件產生位置
+- **語言**：要產生的語言版本
+- **來源**：要掃描的內容（CLI、技能、命令等）
+- **範本**：文件結構範本
+### 配置範例（多語言）
+```yaml
+# .usage-docs.yaml - 完整 UDS 配置
+version: "1.0"
+output:
+  directory: "docs/"
+  formats: [reference, cheatsheet]
+  languages: [en, zh-TW, zh-CN]
+  paths:
+    en: "docs/"
+    zh-TW: "locales/zh-TW/docs/"
+    zh-CN: "locales/zh-CN/docs/"
+sources:
+  cli:
+    enabled: true
+    entry: "cli/bin/uds.js"
+  skills:
+    enabled: true
+    directory: "skills/"
+    pattern: "**/SKILL.md"
+```
+### 單語言專案
+僅需要英文文件的專案：
+```yaml
+# .usage-docs.yaml - 僅英文
+version: "1.0"
+output:
+  directory: "docs/"
+  formats: [reference, cheatsheet]
+  languages:
+    - en
+  paths:
+    en: "docs/"
+sources:
+  cli:
+    enabled: true
+    entry: "src/cli.js"
+```
+### 自訂語言配置
+不同語言需求的專案（例如：英文 + 日文）：
+```yaml
+# .usage-docs.yaml - 英文 + 日文
+version: "1.0"
+output:
+  directory: "docs/"
+  formats: [reference, cheatsheet]
+  languages:
+    - en
+    - ja
+  paths:
+    en: "docs/"
+    ja: "docs/ja/"
+templates:
+  reference:
+    title:
+      en: "My Project Reference"
+      ja: "プロジェクトリファレンス"
+  cheatsheet:
+    title:
+      en: "My Project Cheatsheet"
+      ja: "チートシート"
+```
+### 配置 Fallback 行為
+產生器實作智慧 fallback 機制處理標題和路徑：
+| 優先順序 | 來源 | 說明 |
+|----------|------|------|
+| 1 | `config[lang]` | 特定語言的配置值 |
+| 2 | `config.en` | 配置中的英文 fallback |
+| 3 | 內建預設值 | 支援語言的硬編碼預設值 |
+**內建支援的語言**：`en`、`zh-TW`、`zh-CN`
+對於不支援的語言，您必須在 `templates` 區塊中提供自訂標題。
+## 輸出檔案
+| 語言 | FEATURE-REFERENCE | CHEATSHEET |
+|------|-------------------|------------|
+| English | `docs/FEATURE-REFERENCE.md` | `docs/CHEATSHEET.md` |
+| 繁體中文 | `locales/zh-TW/docs/FEATURE-REFERENCE.md` | `locales/zh-TW/docs/CHEATSHEET.md` |
+| 简体中文 | `locales/zh-CN/docs/FEATURE-REFERENCE.md` | `locales/zh-CN/docs/CHEATSHEET.md` |
+## 整合到發布前檢查
+將使用說明文件同步檢查加入 `pre-release-check.sh`：
+```bash
+# 檢查使用說明文件同步
+echo "Checking usage documentation sync..."
+./scripts/check-usage-docs-sync.sh
+```
+## 工作流程
+```
+┌─────────────────────────────────────────────────────────┐
+│                      文件產生器                          │
+├─────────────────────────────────────────────────────────┤
+│                                                          │
+│  1. 載入配置 (.usage-docs.yaml)                         │
+│           │                                              │
+│           ▼                                              │
+│  2. 掃描來源                                             │
+│     ├─ CLI 指令 (uds.js)                                │
+│     ├─ 技能 (SKILL.md 檔案)                             │
+│     ├─ 命令 (斜線命令)                                   │
+│     ├─ 代理 (代理定義)                                   │
+│     ├─ 工作流程 (工作流程檔案)                           │
+│     ├─ 核心規範 (core/*.md)                             │
+│     └─ 腳本 (scripts/*.sh)                              │
+│           │                                              │
+│           ▼                                              │
+│  3. 產生文件                                             │
+│     ├─ FEATURE-REFERENCE.md（詳細版）                   │
+│     └─ CHEATSHEET.md（速查表）                          │
+│           │                                              │
+│           ▼                                              │
+│  4. 輸出各語言版本                                       │
+│     ├─ 英文 (docs/)                                      │
+│     ├─ 繁體中文 (locales/zh-TW/docs/)                   │
+│     └─ 簡體中文 (locales/zh-CN/docs/)                   │
+│                                                          │
+└─────────────────────────────────────────────────────────┘
+```
+## 在其他專案使用
+此技能設計為可重用。在你的專案中使用：
+1. **複製配置範本**：
+   ```bash
+   cp .usage-docs.yaml your-project/.usage-docs.yaml
+   ```
+2. **修改為你的專案結構**：
+   - 更新來源目錄
+   - 調整檔案命名模式
+   - 配置輸出路徑
+3. **複製產生器腳本**：
+   ```bash
+   cp scripts/generate-usage-docs.mjs your-project/scripts/
+   ```
+4. **執行產生器**：
+   ```bash
+   node scripts/generate-usage-docs.mjs
+   ```
+## 相關規範
+- [文件撰寫規範](../../../../core/documentation-writing-standards.md)
+- [文件結構規範](../../../../core/documentation-structure.md)
+- [AI 友善架構](../../../../core/ai-friendly-architecture.md)
+## 版本歷史
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-01-26 | 初始發布，支援多語言 |
+---
+## 授權
+此技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/SKILL.md RENAMED Viewed

@@ -1,10 +1,9 @@
 ---
-source: skills/claude-code/documentation-guide/SKILL.md
+source: ../../../../skills/documentation-guide/SKILL.md
 source_version: 2.0.0
 translation_version: 2.0.0
 last_synced: 2026-01-12
 status: current
-name: documentation-guide
 description: |
   引導文件結構、內容需求和專案文件最佳實踐。
   使用時機：建立 README、文件、docs 目錄、專案設定、技術文件。
@@ -13,7 +12,7 @@ description: |
 # 文件指南
-> **語言**: [English](../../../../../skills/claude-code/documentation-guide/SKILL.md) | 繁體中文
+> **語言**: [English](../../../../skills/documentation-guide/SKILL.md) | 繁體中文
 **版本**: 2.0.0
 **最後更新**: 2026-01-12
@@ -390,17 +389,17 @@ MIT
 ## 詳細指南
 完整標準請參閱：
-- [文件撰寫標準](../../../core/documentation-writing-standards.md)
-- [文件結構標準](../../../core/documentation-structure.md)
+- [文件撰寫標準](../../core/documentation-writing-standards.md)
+- [文件結構標準](../../core/documentation-structure.md)
 - [README 範本](./readme-template.md)
 ---
 ## 相關標準
-- [文件撰寫標準](../../../core/documentation-writing-standards.md) - 內容需求
-- [文件結構標準](../../../core/documentation-structure.md) - 檔案組織
-- [變更日誌標準](../../../core/changelog-standards.md) - CHANGELOG 格式
+- [文件撰寫標準](../../core/documentation-writing-standards.md) - 內容需求
+- [文件結構標準](../../core/documentation-structure.md) - 檔案組織
+- [變更日誌標準](../../core/changelog-standards.md) - CHANGELOG 格式
 - [變更日誌指南技能](../changelog-guide/SKILL.md) - CHANGELOG 技能
 ---

package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/documentation-structure.md RENAMED Viewed

@@ -1,5 +1,5 @@
 ---
-source: skills/claude-code/documentation-guide/documentation-structure.md
+source: ../../../../skills/documentation-guide/documentation-structure.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 # 文件結構參考
-> **語言**: [English](../../../../../skills/claude-code/documentation-guide/documentation-structure.md) | 繁體中文
+> **語言**: [English](../../../../skills/documentation-guide/documentation-structure.md) | 繁體中文
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -336,8 +336,8 @@ npm install
 ## 相關標準
-- [Documentation Structure](../../../../../core/documentation-structure.md)
-- [Documentation Writing Standards](../../../../../core/documentation-writing-standards.md)
+- [Documentation Structure](../../../../core/documentation-structure.md)
+- [Documentation Writing Standards](../../../../core/documentation-writing-standards.md)
 - [README Template](./readme-template.md)
 ---

package/bundled/locales/zh-TW/skills/{claude-code/documentation-guide → documentation-guide}/readme-template.md RENAMED Viewed

@@ -1,5 +1,5 @@
 ---
-source: skills/claude-code/documentation-guide/readme-template.md
+source: ../../../../skills/documentation-guide/readme-template.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 # README 範本與最佳實踐
-> **語言**: [English](../../../../../skills/claude-code/documentation-guide/readme-template.md) | 繁體中文
+> **語言**: [English](../../../../skills/documentation-guide/readme-template.md) | 繁體中文
 **版本**: 1.0.0
 **最後更新**: 2025-12-24
@@ -393,7 +393,7 @@ See [documentation](docs/old-path.md) for more info.  ← 連結不存在
 ## 相關標準
 - [Documentation Structure Reference](./documentation-structure.md)
-- [Documentation Writing Standards](../../../core/documentation-writing-standards.md)
+- [Documentation Writing Standards](../../core/documentation-writing-standards.md)
 ---

package/bundled/locales/zh-TW/skills/{claude-code/error-code-guide → error-code-guide}/SKILL.md RENAMED Viewed

@@ -1,10 +1,10 @@
 ---
-name: error-code-guide
+name: errors
 description: |
   設計一致的錯誤碼，遵循 PREFIX_CATEGORY_NUMBER 格式。
   使用時機：定義錯誤碼、建立錯誤處理、設計 API。
   關鍵字：error code, error handling, error format, API errors, 錯誤碼, 錯誤處理。
-source: ../../../../../skills/claude-code/error-code-guide/SKILL.md
+source: ../../../../skills/error-code-guide/SKILL.md
 source_version: 1.0.0
 translation_version: 1.0.0
 last_synced: 2026-01-08
@@ -13,7 +13,7 @@ status: current
 # 錯誤碼指南
-> **語言**: [English](../../../../../skills/claude-code/error-code-guide/SKILL.md) | 繁體中文
+> **語言**: [English](../../../../skills/error-code-guide/SKILL.md) | 繁體中文
 **版本**: 1.0.0
 **最後更新**: 2025-12-30
@@ -86,7 +86,7 @@ API_NET_408     → API 網路逾時
 ## 詳細指南
 完整標準請參考：
-- [錯誤碼標準](../../../core/error-code-standards.md)
+- [錯誤碼標準](../../core/error-code-standards.md)
 ### AI 優化格式（節省 Token）
@@ -249,8 +249,8 @@ export const ErrorCodes = {
 ## 相關標準
-- [錯誤碼標準](../../../core/error-code-standards.md)
-- [日誌標準](../../../core/logging-standards.md)
+- [錯誤碼標準](../../core/error-code-standards.md)
+- [日誌標準](../../core/logging-standards.md)
 ---