2.7 KiB
2.7 KiB
🤖 與 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 是您的協作夥伴,讓他幫您記錄問題,讓專案更完善!