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

2.7 KiB
Raw Blame History

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