project-structure-guidelisted

# 專案結構指南 > **Language**: [English](../../../../skills/project-structure-guide/SKILL.md) | 繁體中文 **版本**：1.1.0 **最後更新**：2026-03-04 **適用性**：Claude Code Skills --- ## 目的 此技能提供根據語言和框架慣例建構專案的指引，協助建立一致、可維護的目錄佈局。 ## 觸發時機 在以下情況使用此技能： - 建立新專案 - 重組現有專案結構 - 新增模組或功能 - 設定建構配置 - 建立 .gitignore 檔案 - 決定檔案的放置位置（程式碼、文件、設定、資源） - 在 utils/、helpers/、shared/、lib/ 或 internal/ 之間做選擇 - 放置開發中間產物（腦力激盪、RFC、POC、技術調查） ## 支援的語言 | 語言 | 框架/模式 | |------|-----------| | Node.js | Express、NestJS、Next.js | | Python | Django、Flask、FastAPI | | Java | Spring Boot、Maven、Gradle | | .NET | ASP.NET Core、Console | | Go | 標準佈局、cmd/pkg | | Rust | Binary、Library、Workspace | | Kotlin | Gradle、Android、Multiplatform | | PHP | Laravel、Symfony、PSR-4 | | Ruby | Rails、Gem、Sinatra | | Swift | SPM、iOS App、Vapor | ## 常見結構模式 ### 標準目錄 ``` project-root/ ├── src/ # 原始碼 ├── tests/ # 測試檔案 ├── docs/ # 文件 ├── tools/ # 建構/部署腳本 ├── examples/ # 使用範例 ├── config/ # 配置檔案 └── .github/ # GitHub 配置 ``` ### 建構輸出（始終 gitignore） ``` dist/ # 發佈輸出 build/ # 編譯產物 out/ # 輸出目錄 bin/ # 二進位執行檔 ``` ## 語言特定指南 ### Node.js ``` project/ ├── src/ │ ├── index.js │ ├── routes/ │ ├── controllers/ │ ├── services/ │ └── models/ ├── tests/ ├── package.json └── .gitignore ``` ### Python ``` project/ ├── src/ │ └── package_name/ │ ├── __init__.py │ └── main.py ├── tests/ ├── pyproject.toml └── .gitigno