105 lines
2.6 KiB
Markdown
105 lines
2.6 KiB
Markdown
## 事實檢查
|
||
|
||
參考項目內的代碼庫、文檔 (docs/、README.md 等)，確認所給資訊的正確性。
|
||
|
||
### 使用方法
|
||
|
||
```bash
|
||
# 基本用法
|
||
/check-fact "Flutter 應用使用了 Riverpod"
|
||
|
||
# 一次性確認多個資訊
|
||
/check-fact "這個項目使用 GraphQL，並通過 auto_route 管理路由"
|
||
|
||
# 確認特定技術規範
|
||
/check-fact "使用 JWT 進行身份驗證，未使用 Firebase Auth"
|
||
```
|
||
|
||
### 確認流程
|
||
|
||
1. **資訊源優先級**
|
||
- 代碼庫 (最可靠)
|
||
- README.md、docs/ 內文檔
|
||
- package.json、pubspec.yaml 等配置文件
|
||
- Issue、Pull Request 的讨論歷史
|
||
|
||
2. **判定結果分類**
|
||
- `✅ 正確` - 資訊與代碼庫完全一致
|
||
- `❌ 錯誤` - 資訊明顯錯誤
|
||
- `⚠️ 部分正確` - 部分準確但不完整
|
||
- `❓ 無法判斷` - 缺少必要的確認資訊
|
||
|
||
3. **依據明示**
|
||
- 相關文件名和行号
|
||
- 相關代碼片段
|
||
- 文檔相關部分
|
||
|
||
### 報告格式
|
||
|
||
```text
|
||
## 事實檢查結果
|
||
|
||
### 檢驗對象
|
||
「[用戶提供的資訊]」
|
||
|
||
### 結論
|
||
[✅/❌/⚠️/❓] [判定結果]
|
||
|
||
### 依據
|
||
- **文件**: `path/to/file.dart:123`
|
||
- **內容**: [相關代碼/文本]
|
||
- **補充**: [额外說明]
|
||
|
||
### 詳细說明
|
||
[如果錯誤，提供正確資訊]
|
||
[如果部分正確，指出不準確的部分]
|
||
[如果無法判斷，說明缺少的資訊]
|
||
```
|
||
|
||
### 基本示例
|
||
|
||
```bash
|
||
# 項目技術棧確認
|
||
/check-fact "這個應用是 Flutter + Riverpod + GraphQL 的架構"
|
||
|
||
# 實現狀况確認
|
||
/check-fact "已實現暗黑模式功能，可從用戶設置切換"
|
||
|
||
# 架構確認
|
||
/check-fact "狀態管理全部使用 Riverpod，未使用 BLoC"
|
||
|
||
# 安全實現確認
|
||
/check-fact "認證令牌已加密存儲在 secure storage 中"
|
||
```
|
||
|
||
### 與 Claude 的協作
|
||
|
||
```bash
|
||
# 分析整個代碼庫後進行確認
|
||
ls -la && find . -name "pubspec.yaml" -exec cat {} \;
|
||
/check-fact "這個項目使用的主要依賴有..."
|
||
|
||
# 確認特定功能的實現狀况
|
||
grep -r "authentication" . --include="*.dart"
|
||
/check-fact "認證功能為自定義實現，未使用第三方認證"
|
||
|
||
# 確認與文檔的一致性
|
||
cat README.md
|
||
/check-fact "README 中記載的功能都已實現"
|
||
```
|
||
|
||
### 應用場景
|
||
|
||
- 技術規格書編寫時: 確認內容準確性
|
||
- 項目交接時: 確認對現有實現的理解
|
||
- 客戶報告前: 確認實現狀况
|
||
- 技術博客撰寫時: 驗證文章內容準確性
|
||
- 面試·說明資料制作時: 確認項目概要準確性
|
||
|
||
### 注意事項
|
||
|
||
- 代碼庫是最可靠的資訊源
|
||
- 如果文檔過時，以實現為準
|
||
- 缺少判斷所需資訊時，坦诚回答"無法判斷"
|
||
- 對涉及安全的資訊要特別谨慎驗證
|