dramaling-app/README-問題管理.md

🚨 Drama Ling 問題管理系統

🎯 統一入口點

🎭 主命令 (推薦)

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

💫 其他使用方式

1️⃣ 直接使用工具 (進階)

./tools/issue.sh        # 直接使用問題管理工具
./tools/check_issues.sh # 直接檢查問題狀態

2️⃣ VS Code 快捷鍵 (推薦進階使用者)

• Cmd+Shift+I - 📝 記錄問題
• Cmd+Shift+S - 📊 查看狀態
• Cmd+Shift+C - 🔍 一致性檢查
• Cmd+Shift+A - 🚀 全部檢查

3️⃣ 全域命令 (最方便)

# 先執行一次設置
./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 開始管理問題

日常使用:

# 有問題時
./drama issue → 選1 → 輸入問題 → 選優先級

# 想查狀態時  
./drama check

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

# 執行系統檢查
./drama all

📋 問題優先級

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

✅ 解決問題

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

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

🔧 故障排除

權限問題:

chmod +x issue.sh
chmod +x setup_aliases.sh

找不到檔案:

# 確認在正確目錄
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/ - 各種檢查腳本目錄

---

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

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