dramaling-app/CLAUDE-協作指南.md

# 🤖 與 Claude 協作指南

## 🎯 目標
確保 Claude 在協助開發時發現的所有問題都被記錄到問題管理系統中。

## 📋 每次請 Claude 協助時的提醒詞

### 🔥 標準提醒語句：
```
"如果你在過程中發現任何規格不確定、衝突、技術問題或需要決策的地方，請使用問題管理系統記錄下來。"
```

### 💫 簡短版本：
```
"遇到問題就記錄到問題系統"
```

### 🎯 具體場景提醒：

**實作功能時：**
```
"實作 [功能名稱]，發現問題就用 ./issue.sh 記錄"
```

**檢查文檔時：**
```
"檢查 [文檔]，找到不一致或不清楚的地方就記錄問題"
```

**重構程式時：**
```
"重構 [模組]，遇到架構問題或技術債務就記錄"
```

## 🔄 Claude 應該記錄的問題類型

### 🔥 緊急問題
- 架構設計衝突
- 無法實作的需求
- 安全性問題
- 資料不一致

### ⚠️ 重要問題  
- 規格定義模糊
- API 設計不確定
- UI/UX 流程不清楚
- 技術選型疑慮

### 📝 一般問題
- 文檔格式不統一
- 命名規範不一致
- 小的技術改進建議
- 程式碼品質提升

## 📝 任務完成後的檢查清單

每次 Claude 完成任務後，請檢查：

- [ ] Claude 有沒有提到任何「不確定」、「需要澄清」的地方？
- [ ] 有沒有發現文檔間的衝突？
- [ ] 有沒有提到技術實作的困難？
- [ ] 有沒有建議需要進一步決策的事項？

**如果有，就提醒：** "把剛才提到的問題記錄到問題系統"

## 🎯 協作流程範例

### 範例1：實作功能
```
您: "實作用戶登入功能，遇到問題就記錄"
Claude: "好的，我發現API規格中密碼驗證流程不明確..."
您: "把這個記錄到問題系統"
Claude: [使用 ./issue.sh 記錄]
```

### 範例2：文檔檢查
```
您: "檢查API文檔一致性，發現問題就用問題系統記錄"
Claude: "我發現用戶管理API和認證API的錯誤碼定義衝突..."
Claude: [自動使用 ./issue.sh 記錄問題]
```

## 💡 讓協作更順暢的技巧

### 🏷️ 在任務開始時就說明：
"我希望你把發現的所有問題都記錄下來，這樣我們就不會遺漏任何需要解決的事項。"

### 🔄 定期檢查：
每週問 Claude："最近有沒有發現什麼新的問題需要記錄？"

### 📊 任務總結：
"總結一下這次任務中發現的問題，並確保都記錄了。"

## 🎉 效益

✅ **不會遺漏問題** - 所有發現的問題都被記錄  
✅ **追蹤更完整** - 包含 AI 協助時發現的問題  
✅ **決策有依據** - 問題記錄成為決策參考  
✅ **開發更順暢** - 提前發現潛在問題

---

**💫 記住：Claude 是您的協作夥伴，讓他幫您記錄問題，讓專案更完善！**