# 🚨 Drama Ling 問題管理系統

## 🎯 統一入口點

### 🎭 **主命令** (推薦)
```bash
./drama                 # 顯示所有可用命令
./drama issue          # 管理問題
./drama check          # 檢查問題狀態
./drama report "標題"   # 建立分析報告
./drama consistency    # 一致性檢查
./drama all            # 執行全部檢查
```

## 💫 其他使用方式

### 1️⃣ **直接使用工具** (進階)
```bash
./tools/issue.sh        # 直接使用問題管理工具
./tools/check_issues.sh # 直接檢查問題狀態
```

### 2️⃣ **VS Code 快捷鍵** (推薦進階使用者)
- `Cmd+Shift+I` - 📝 記錄問題
- `Cmd+Shift+S` - 📊 查看狀態  
- `Cmd+Shift+C` - 🔍 一致性檢查
- `Cmd+Shift+A` - 🚀 全部檢查

### 3️⃣ **全域命令** (最方便)
```bash
# 先執行一次設置
./drama setup

# 重啟終端機後，在任何地方都能用:
dl               # 主選單
dl-issue         # 記錄問題
dl-check         # 查看狀態
dl-report        # 建立報告
dl-consistency   # 一致性檢查
dl-all          # 全部檢查
```

## 🚀 快速開始

### 第一次使用:
1. 打開終端機
2. `cd /Users/jettcheng1018/code/dramaling-app`
3. `./drama` 查看所有命令
4. `./drama issue` 開始管理問題

### 日常使用:
```bash
# 有問題時
./drama issue → 選1 → 輸入問題 → 選優先級

# 想查狀態時  
./drama check

# 建立分析報告
./drama report "問題分析標題"

# 執行系統檢查
./drama all
```

## 📋 問題優先級

- 🔥 **緊急** - 阻擋開發的嚴重問題
- ⚠️ **重要** - 影響進度的重要問題
- 📝 **一般** - 可以延後的問題

## ✅ 解決問題

**方法1 - 用工具:**
`./issue.sh` → 選3 → 查看問題列表 → 手動編輯檔案

**方法2 - 直接編輯:**
打開 `ISSUES.md`，把 `[ ]` 改成 `[x]`，移到「已解決」區域

## 🔧 故障排除

### 權限問題:
```bash
chmod +x issue.sh
chmod +x setup_aliases.sh
```

### 找不到檔案:
```bash
# 確認在正確目錄
pwd
# 應該顯示: /Users/jettcheng1018/code/dramaling-app
```

### VS Code 快捷鍵無效:
1. 重啟 VS Code
2. 檢查是否在專案根目錄開啟 VS Code

## 💡 使用技巧

### 快速記錄:
- 發現問題立即記錄，不要拖延
- 描述要具體，包含檔案位置
- 優先級要準確判斷

### 定期回顧:
- 每週檢查一次狀態
- 將已解決問題移到完成區域
- 評估緊急問題是否需要立即處理

### 團隊協作:
- 問題描述要清楚，讓其他人也能理解
- 相關檔案路徑要完整
- 解決後記錄解決方案

## 📁 相關檔案

### 核心系統
- `drama` - 🎭 統一入口點腳本
- `ISSUES.md` - 主要問題追蹤檔案
- `reports/` - 結構化報告目錄

### 工具目錄
- `tools/issue.sh` - 互動式問題管理工具
- `tools/check_issues.sh` - 快速狀態檢查
- `tools/create_report.sh` - 快速建立報告工具
- `tools/check_reports.sh` - 報告狀態檢查
- `tools/setup_aliases.sh` - 全域命令設置

### VS Code 整合
- `.vscode/tasks.json` - VS Code 任務設定
- `.vscode/keybindings.json` - VS Code 快捷鍵

### 維護系統
- `scripts/maintenance_manager.sh` - 系統檢查主腳本
- `scripts/maintenance/` - 各種檢查腳本目錄

---

**🎉 現在您有了一個超級簡單好用的問題管理系統！**

遇到問題就記錄，定期檢查狀態，讓專案開發更順暢！