universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-TW/ai/options/project-structure/java.ai.yaml

@@ -0,0 +1,113 @@
+# Java 專案結構 - AI 優化選項
+# 父項: project-structure
+
+id: java
+meta:
+  parent: project-structure
+  version: "1.0.0"
+  description: Java/Spring Boot 專案的標準目錄結構
+  language: zh-TW
+
+structure:
+  template: |
+    project-root/
+    ├── src/
+    │   ├── main/
+    │   │   ├── java/
+    │   │   │   └── com/company/project/
+    │   │   │       ├── Application.java          # 進入點
+    │   │   │       ├── config/                   # 設定類別
+    │   │   │       │   ├── SecurityConfig.java
+    │   │   │       │   └── WebConfig.java
+    │   │   │       ├── modules/                  # 功能模組
+    │   │   │       │   ├── users/
+    │   │   │       │   │   ├── User.java         # 實體
+    │   │   │       │   │   ├── UserController.java
+    │   │   │       │   │   ├── UserService.java
+    │   │   │       │   │   ├── UserRepository.java
+    │   │   │       │   │   └── dto/
+    │   │   │       │   └── products/
+    │   │   │       ├── shared/                   # 共用程式碼
+    │   │   │       │   ├── exception/
+    │   │   │       │   └── util/
+    │   │   │       └── infrastructure/           # 外部整合
+    │   │   └── resources/
+    │   │       ├── application.yml
+    │   │       ├── application-dev.yml
+    │   │       └── application-prod.yml
+    │   └── test/
+    │       └── java/
+    │           └── com/company/project/
+    ├── docs/
+    ├── scripts/
+    ├── pom.xml                    # Maven
+    ├── build.gradle               # 或 Gradle
+    └── README.md
+
+layers:
+  spring_boot:
+    - name: Controller
+      annotation: "@RestController"
+      responsibility: HTTP 端點
+    - name: Service
+      annotation: "@Service"
+      responsibility: 業務邏輯
+    - name: Repository
+      annotation: "@Repository"
+      responsibility: 資料存取
+    - name: Entity
+      annotation: "@Entity"
+      responsibility: 資料庫模型
+
+conventions:
+  naming:
+    files: PascalCase.java
+    packages: lowercase
+    classes: PascalCase
+    interfaces: PascalCase（不用 I 前綴）
+    methods: camelCase
+    constants: UPPER_SNAKE_CASE
+
+  package_naming:
+    pattern: com.company.project.module.layer
+    example: com.example.shop.users.service
+
+rules:
+  - id: package-by-feature
+    trigger: 組織套件時
+    instruction: 使用功能套件而非層級套件
+    priority: recommended
+    examples:
+      good: com.example.shop.users
+      bad: com.example.shop.services
+
+  - id: dto-separation
+    trigger: 定義 API 模型時
+    instruction: 使用 DTO 類別，不要直接暴露實體
+    priority: required
+
+  - id: constructor-injection
+    trigger: 注入相依性時
+    instruction: 優先使用建構子注入而非欄位注入
+    priority: required
+
+spring_annotations:
+  - "@SpringBootApplication": 主要應用程式類別
+  - "@RestController": REST API 控制器
+  - "@Service": 業務邏輯服務
+  - "@Repository": 資料存取層
+  - "@Configuration": 設定類別
+  - "@Autowired": 相依性注入
+
+tools:
+  build:
+    - Maven
+    - Gradle（推薦）
+  testing:
+    - JUnit 5
+    - Mockito
+    - Spring Boot Test
+  quality:
+    - Checkstyle
+    - SpotBugs
+    - SonarQube

package/bundled/locales/zh-TW/ai/options/project-structure/kotlin.ai.yaml

@@ -0,0 +1,123 @@
+# Kotlin 專案結構 - AI 優化選項
+# 父層: project-structure
+
+id: kotlin
+meta:
+  parent: project-structure
+  version: "1.0.0"
+  description: Kotlin 專案慣例
+
+structure:
+  gradle: |
+    project-root/
+    ├── src/
+    │   ├── main/
+    │   │   ├── kotlin/
+    │   │   │   └── com/example/app/
+    │   │   │       ├── Application.kt
+    │   │   │       ├── config/
+    │   │   │       ├── controller/
+    │   │   │       ├── service/
+    │   │   │       ├── repository/
+    │   │   │       └── model/
+    │   │   └── resources/
+    │   │       └── application.yml
+    │   └── test/
+    │       ├── kotlin/
+    │       │   └── com/example/app/
+    │       └── resources/
+    ├── build.gradle.kts      # Gradle Kotlin DSL
+    ├── settings.gradle.kts
+    ├── gradle.properties
+    └── gradlew
+
+  android: |
+    project-root/
+    ├── app/
+    │   ├── src/
+    │   │   ├── main/
+    │   │   │   ├── kotlin/
+    │   │   │   ├── res/
+    │   │   │   └── AndroidManifest.xml
+    │   │   ├── test/
+    │   │   └── androidTest/
+    │   └── build.gradle.kts
+    ├── build.gradle.kts
+    ├── settings.gradle.kts
+    └── gradle.properties
+
+  multiplatform: |
+    project-root/
+    ├── shared/
+    │   ├── src/
+    │   │   ├── commonMain/kotlin/
+    │   │   ├── commonTest/kotlin/
+    │   │   ├── androidMain/kotlin/
+    │   │   ├── iosMain/kotlin/
+    │   │   └── jvmMain/kotlin/
+    │   └── build.gradle.kts
+    ├── androidApp/
+    ├── iosApp/
+    └── build.gradle.kts
+
+config_files:
+  - file: build.gradle.kts
+    purpose: 建置設定（Kotlin DSL）
+    required: true
+    alternative: build.gradle (Groovy)
+
+  - file: settings.gradle.kts
+    purpose: 專案設定
+    required: true
+
+  - file: gradle.properties
+    purpose: Gradle 屬性
+    required: false
+
+  - file: gradle/libs.versions.toml
+    purpose: 版本目錄
+    required: false
+    note: 建議用於相依性管理
+
+gitignore:
+  - build/
+  - .gradle/
+  - "*.iml"
+  - .idea/
+  - local.properties
+  - "*.apk"
+  - "*.aab"
+
+rules:
+  - id: kotlin-dsl
+    trigger: 建立建置檔案
+    instruction: 優先使用 build.gradle.kts（Kotlin DSL）而非 Groovy
+    priority: recommended
+
+  - id: package-structure
+    trigger: 組織程式碼
+    instruction: 遵循反向網域套件命名（com.example.app）
+    priority: required
+
+  - id: test-location
+    trigger: 放置測試
+    instruction: 在 test 目錄中映射主原始碼結構
+    priority: required
+
+  - id: version-catalog
+    trigger: 管理相依性
+    instruction: 使用版本目錄（libs.versions.toml）管理相依性
+    priority: recommended
+
+  - id: coroutines-testing
+    trigger: 測試協程
+    instruction: 使用 kotlinx-coroutines-test 測試 suspend 函數
+    priority: recommended
+
+tools:
+  build: [Gradle, Gradle Kotlin DSL]
+  test_runner: [JUnit5, Kotest, MockK]
+  linter: [Detekt, ktlint]
+  formatter: [ktlint, IntelliJ IDEA]
+  package_manager: [Gradle, Maven]
+  documentation: [Dokka]

package/bundled/locales/zh-TW/ai/options/project-structure/nodejs.ai.yaml

@@ -0,0 +1,101 @@
+# Node.js 專案結構 - AI 優化選項
+# 父項: project-structure
+
+id: nodejs
+meta:
+  parent: project-structure
+  version: "1.0.0"
+  description: Node.js/TypeScript 專案的標準目錄結構
+  language: zh-TW
+
+structure:
+  template: |
+    project-root/
+    ├── src/
+    │   ├── index.ts              # 應用程式進入點
+    │   ├── app.ts                # Express/Fastify 應用程式設定
+    │   ├── config/               # 設定檔
+    │   │   ├── index.ts
+    │   │   └── database.ts
+    │   ├── modules/              # 功能模組（按功能組織）
+    │   │   ├── users/
+    │   │   │   ├── user.model.ts
+    │   │   │   ├── user.service.ts
+    │   │   │   ├── user.controller.ts
+    │   │   │   ├── user.routes.ts
+    │   │   │   └── user.test.ts
+    │   │   └── products/
+    │   ├── shared/               # 共用工具和類型
+    │   │   ├── middleware/
+    │   │   ├── utils/
+    │   │   └── types/
+    │   └── infrastructure/       # 外部服務整合
+    │       ├── database/
+    │       └── cache/
+    ├── tests/                    # 整合/E2E 測試
+    │   ├── integration/
+    │   └── e2e/
+    ├── scripts/                  # 建置/部署腳本
+    ├── docs/                     # 文件
+    ├── package.json
+    ├── tsconfig.json
+    ├── .env.example
+    └── README.md
+
+conventions:
+  naming:
+    files: kebab-case.ts
+    directories: kebab-case
+    classes: PascalCase
+    functions: camelCase
+    constants: UPPER_SNAKE_CASE
+
+  file_suffixes:
+    - ".model.ts"
+    - ".service.ts"
+    - ".controller.ts"
+    - ".routes.ts"
+    - ".test.ts"
+    - ".dto.ts"
+    - ".middleware.ts"
+
+rules:
+  - id: feature-folders
+    trigger: 組織原始碼時
+    instruction: 使用功能資料夾而非技術資料夾
+    priority: required
+    examples:
+      good: |
+        src/modules/users/
+          user.model.ts
+          user.service.ts
+      bad: |
+        src/models/user.ts
+        src/services/user.ts
+
+  - id: index-exports
+    trigger: 建立模組時
+    instruction: 使用 index.ts 匯出公開 API
+    priority: recommended
+
+  - id: colocation
+    trigger: 放置測試時
+    instruction: 單元測試與原始碼放一起
+    priority: recommended
+
+package_json:
+  required_scripts:
+    - "start": 執行應用程式
+    - "dev": 開發模式（熱重載）
+    - "build": 編譯 TypeScript
+    - "test": 執行測試
+    - "lint": 執行 linter
+
+example_module: |
+  // src/modules/users/index.ts
+  export { User } from './user.model';
+  export { UserService } from './user.service';
+  export { userRoutes } from './user.routes';
+
+  // 使用方式
+  import { User, UserService } from '@/modules/users';

package/bundled/locales/zh-TW/ai/options/project-structure/php.ai.yaml

@@ -0,0 +1,147 @@
+# PHP 專案結構 - AI 優化選項
+# 父層: project-structure
+
+id: php
+meta:
+  parent: project-structure
+  version: "1.0.0"
+  description: PHP 專案慣例
+
+structure:
+  standard: |
+    project-root/
+    ├── src/
+    │   ├── Controller/
+    │   ├── Service/
+    │   ├── Repository/
+    │   ├── Entity/
+    │   ├── Exception/
+    │   └── Helper/
+    ├── config/
+    │   └── config.php
+    ├── public/               # 網站根目錄
+    │   ├── index.php
+    │   ├── css/
+    │   ├── js/
+    │   └── images/
+    ├── resources/
+    │   └── views/
+    ├── tests/
+    │   ├── Unit/
+    │   └── Feature/
+    ├── vendor/               # 相依性（git忽略）
+    ├── storage/              # 日誌、快取（git忽略）
+    ├── composer.json
+    ├── composer.lock
+    └── phpunit.xml
+
+  laravel: |
+    project-root/
+    ├── app/
+    │   ├── Http/
+    │   │   ├── Controllers/
+    │   │   └── Middleware/
+    │   ├── Models/
+    │   ├── Services/
+    │   └── Providers/
+    ├── config/
+    ├── database/
+    │   ├── migrations/
+    │   ├── seeders/
+    │   └── factories/
+    ├── public/
+    ├── resources/
+    │   ├── views/
+    │   ├── css/
+    │   └── js/
+    ├── routes/
+    ├── storage/
+    ├── tests/
+    ├── composer.json
+    └── artisan
+
+  symfony: |
+    project-root/
+    ├── bin/
+    │   └── console
+    ├── config/
+    │   ├── packages/
+    │   ├── routes/
+    │   └── services.yaml
+    ├── public/
+    │   └── index.php
+    ├── src/
+    │   ├── Controller/
+    │   ├── Entity/
+    │   ├── Repository/
+    │   └── Service/
+    ├── templates/
+    ├── tests/
+    ├── var/                  # 快取、日誌
+    ├── vendor/
+    └── composer.json
+
+config_files:
+  - file: composer.json
+    purpose: 套件設定檔
+    required: true
+
+  - file: composer.lock
+    purpose: 相依性鎖定檔
+    required: true
+
+  - file: phpunit.xml
+    purpose: PHPUnit 設定
+    required: false
+
+  - file: .php-cs-fixer.php
+    purpose: 程式碼風格設定
+    required: false
+
+  - file: phpstan.neon
+    purpose: 靜態分析設定
+    required: false
+
+gitignore:
+  - vendor/
+  - storage/
+  - var/
+  - ".env"
+  - ".env.local"
+  - "*.cache"
+  - "*.log"
+  - node_modules/
+
+rules:
+  - id: psr-autoloading
+    trigger: 組織命名空間
+    instruction: 遵循 PSR-4 自動載入標準
+    priority: required
+
+  - id: public-web-root
+    trigger: 設定網站伺服器
+    instruction: 僅將網站根目錄指向 public/ 目錄
+    priority: required
+
+  - id: env-config
+    trigger: 管理設定
+    instruction: 使用 .env 檔案處理環境特定設定
+    priority: recommended
+
+  - id: tests-mirror
+    trigger: 放置測試
+    instruction: 在 tests/ 目錄中映射 src/ 結構
+    priority: recommended
+
+  - id: dependency-injection
+    trigger: 組織服務
+    instruction: 使用相依性注入容器
+    priority: recommended
+
+tools:
+  build: [Composer]
+  test_runner: [PHPUnit, Pest, Codeception]
+  linter: [PHP_CodeSniffer, PHP-CS-Fixer]
+  static_analysis: [PHPStan, Psalm]
+  package_manager: [Composer, Packagist]
+  documentation: [phpDocumentor]

package/bundled/locales/zh-TW/ai/options/project-structure/python.ai.yaml

@@ -0,0 +1,116 @@
+# Python 專案結構 - AI 優化選項
+# 父項: project-structure
+
+id: python
+meta:
+  parent: project-structure
+  version: "1.0.0"
+  description: Python 專案的標準目錄結構
+  language: zh-TW
+
+structure:
+  template: |
+    project-root/
+    ├── src/
+    │   └── myproject/            # 主要套件（套件名稱）
+    │       ├── __init__.py
+    │       ├── main.py           # 進入點
+    │       ├── config/           # 設定
+    │       │   ├── __init__.py
+    │       │   └── settings.py
+    │       ├── modules/          # 功能模組
+    │       │   ├── __init__.py
+    │       │   ├── users/
+    │       │   │   ├── __init__.py
+    │       │   │   ├── models.py
+    │       │   │   ├── services.py
+    │       │   │   └── routes.py
+    │       │   └── products/
+    │       ├── shared/           # 共用工具
+    │       │   ├── __init__.py
+    │       │   └── utils.py
+    │       └── infrastructure/   # 外部服務
+    │           ├── __init__.py
+    │           └── database.py
+    ├── tests/                    # 測試
+    │   ├── __init__.py
+    │   ├── conftest.py           # pytest fixtures
+    │   ├── unit/
+    │   └── integration/
+    ├── scripts/                  # 工具腳本
+    ├── docs/                     # 文件
+    ├── pyproject.toml            # 專案設定（推薦）
+    ├── requirements.txt          # 相依性（或用 poetry）
+    ├── .env.example
+    └── README.md
+
+conventions:
+  naming:
+    files: snake_case.py
+    directories: snake_case
+    classes: PascalCase
+    functions: snake_case
+    constants: UPPER_SNAKE_CASE
+    private: _leading_underscore
+
+  imports:
+    order:
+      - 標準函式庫
+      - 第三方套件
+      - 本地模組
+    example: |
+      import os
+      from typing import Optional
+
+      import requests
+      from fastapi import FastAPI
+
+      from myproject.modules.users import UserService
+
+rules:
+  - id: src-layout
+    trigger: 組織專案時
+    instruction: 使用 src 布局以避免導入問題
+    priority: recommended
+
+  - id: init-files
+    trigger: 建立目錄時
+    instruction: 每個 Python 套件目錄都需要 __init__.py
+    priority: required
+
+  - id: type-hints
+    trigger: 撰寫函式時
+    instruction: 使用類型提示提升可讀性
+    priority: recommended
+
+pyproject_toml:
+  example: |
+    [project]
+    name = "myproject"
+    version = "1.0.0"
+    requires-python = ">=3.10"
+
+    [tool.pytest.ini_options]
+    testpaths = ["tests"]
+
+    [tool.black]
+    line-length = 88
+
+    [tool.ruff]
+    line-length = 88
+
+tools:
+  package_manager:
+    - Poetry（推薦）
+    - pip + requirements.txt
+    - pipenv
+  testing:
+    - pytest
+    - pytest-cov
+  linting:
+    - ruff（推薦）
+    - flake8
+    - black
+  type_checking:
+    - mypy
+    - pyright