142 lines
3.4 KiB
Markdown
142 lines
3.4 KiB
Markdown
# 🚨 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/` - 各種檢查腳本目錄
|
||
|
||
---
|
||
|
||
**🎉 現在您有了一個超級簡單好用的問題管理系統！**
|
||
|
||
遇到問題就記錄，定期檢查狀態，讓專案開發更順暢！ |