template-is-all-you-need: Instructions file for GitHub Copilot

Copilot 自定義指令

此文件為 VS Code GitHub Copilot 及 Claude Code 提供專案上下文與操作規範。

---

專案概述

這是一個 AI 輔助開發專案模板，整合了：

• 憲法-子法層級規則系統
• Claude Skills 模組化技能
• Memory Bank 專案記憶
• DDD + DAL 獨立架構（前後端通用）

---

開發哲學 💡

「想要寫文件的時候，就更新 Memory Bank 吧！」

「想要零散測試的時候，就寫測試檔案進 tests/ 資料夾吧！」

• 不要另開檔案寫筆記，直接寫進 Memory Bank
• 今天的零散測試，就是明天的回歸測試

---

法規層級

CONSTITUTION.md          ← 最高原則（不可違反）
  │
  ├── .github/bylaws/    ← 子法（細則規範）
  │     ├── ddd-architecture.md
  │     ├── git-workflow.md
  │     ├── python-environment.md
  │     └── memory-bank.md
  │
  └── .claude/skills/    ← 實施細則（操作程序）

你必須遵守以下法規層級：

1. 憲法：CONSTITUTION.md - 最高原則，不可違反
2. 子法：.github/bylaws/*.md - 細則規範
3. 技能：.claude/skills/*/SKILL.md - 操作程序

---

架構原則

DDD (Domain-Driven Design)

• Domain Layer 不依賴外部
• DAL (Data Access Layer) 必須獨立
• 使用 Repository Pattern
• 依賴方向：Presentation → Application → Domain ← Infrastructure

詳見：.github/bylaws/ddd-architecture.md

目錄結構約定

後端 (Python/Go/Rust)

src/
├── Domain/           # 核心領域（無外部依賴）
├── Application/      # 應用層（用例編排）
├── Infrastructure/   # 基礎設施（DAL、外部服務）
└── Presentation/     # 呈現層（API、CLI）

前端 (React/Vue)

src/
├── domain/           # 型別定義、業務規則
├── application/      # Hooks、Stores、Services
├── infrastructure/   # API Client、Storage
└── presentation/     # Components、Pages、Layouts

---

Python 環境（uv 優先）

• 優先使用 uv 管理套件和虛擬環境
• 新專案必須建立 pyproject.toml + uv.lock
• 禁止全域安裝套件

# 初始化環境
uv venv
uv sync --all-extras

# 安裝依賴
uv add package-name
uv add --dev pytest ruff mypy bandit vulture

詳見：.github/bylaws/python-environment.md

---

Memory Bank 同步

每次重要操作必須更新 Memory Bank：

操作	更新文件
完成任務	progress.md (Done)
開始任務	progress.md (Doing), activeContext.md
重大決策	decisionLog.md
架構變更	architect.md

詳見：.github/bylaws/memory-bank.md

---

Git 工作流

提交前必須執行檢查清單：

1. ✅ Memory Bank 同步（必要）
2. 📖 README 更新（如需要）
3. 📋 CHANGELOG 更新（如需要）
4. 🗺️ ROADMAP 標記（如需要）