3.9 KiB

Raw Blame History

Claude 工作指南 (Claude Working Guidelines)

🤖 Claude 協作標準操作程序

本文件為 Claude AI 助手在 Drama Ling 專案中的標準操作程序，確保工作流程的一致性和品質。

🛠️ 必須使用的系統工具

報告建立

# ✅ 正確做法：使用系統工具
./drama report analysis "分析主題"
./drama report decision "決策主題"

# ❌ 禁止行為：手動創建報告檔案
# 直接 Write 或 Edit reports/ 目錄下的檔案

問題管理

# ✅ 正確做法：使用問題管理工具
./drama issue

# ❌ 禁止行為：直接編輯 ISSUES.md
# 除非是修正現有問題的格式錯誤

檢查作業

# ✅ 正確做法：使用檢查工具
./drama check

# 其他維護腳本
./check_consistency.sh

🎯 核心工作原則

1. 工具優先原則

必須優先使用現有工具和腳本
手動操作只能用於緊急修正
所有報告都必須透過 ./drama report 創建

2. 日期準確性原則

系統工具會自動處理日期
當前日期：2025-09-07
任何手動設定日期都必須使用正確的當前日期

3. 文檔整合原則

所有問題必須記錄到 ISSUES.md
所有分析必須產生正式報告
報告必須與問題系統整合

📋 標準工作流程

分析任務流程

建立分析報告: ./drama report analysis "主題"
執行分析工作: 使用適當工具進行分析
更新報告內容: 編輯生成的報告檔案
整合問題系統: 確認相關問題已正確連結

問題處理流程

記錄問題: ./drama issue
分配優先級: 🔥緊急 / ⚠️重要 / 📝一般
建立相關報告: 如有需要，建立分析或決策報告
追蹤解決進展: 定期更新問題狀態

檢查作業流程

執行系統檢查: ./drama check
運行一致性檢查: ./check_consistency.sh
記錄發現問題: 使用問題管理系統
產生檢查報告: 必要時建立分析報告

⚠️ 常見錯誤和避免方法

錯誤1: 手動創建報告

問題: 直接創建報告檔案，導致日期錯誤、格式不一致解決: 必須使用 ./drama report 命令

錯誤2: 忽略現有工具

問題: 重複實作已存在的功能解決: 先檢查 tools/ 目錄下的現有工具

錯誤3: 未整合問題系統

問題: 發現問題但未記錄到 ISSUES.md 解決: 每次發現問題都必須使用 ./drama issue

錯誤4: 日期不一致

問題: 使用錯誤的日期或格式解決: 依賴系統工具的自動日期處理

🔍 品質檢查清單

每次任務完成後檢查

是否使用了正確的系統工具？
所有日期是否正確（2025-09-07）？
發現的問題是否已記錄？
報告是否已正確整合到問題系統？
檔案命名是否符合系統標準？

🚨 緊急情況處理

工具故障時

記錄工具故障情況到 ISSUES.md
使用手動方式完成緊急任務
修正工具後重新使用標準流程
檢查並修正手動操作造成的不一致

系統不一致時

立即停止當前工作
運行 ./check_consistency.sh
記錄發現的不一致問題
修正問題後繼續工作

📚 相關文檔

🔄 持續改善

發現新問題時

立即記錄到 ISSUES.md
評估是否需要新工具或流程
更新本指南文檔
通知相關團隊成員

工具優化時

測試新工具的正確性
更新操作流程
修訂本指南文檔
確保向下相容性

重要提醒: 本指南是 Claude AI 助手的強制性操作標準。任何偏離此流程的行為都可能造成系統不一致和品質問題。

最後更新: 2025-09-07
版本: 1.0
維護者: Drama Ling 開發團隊

3.9 KiB Raw Blame History Unescape Escape