ai-collaboration-standards

name	ai-collaboration-standards
source	../../../../skills/ai-collaboration-standards/SKILL.md
source_version	1.1.0
translation_version	1.1.0
last_synced	"2026-05-28T00:00:00.000Z"
status	current
description	[UDS] 防止 AI 幻覺、確保分析程式碼或提建議時以證據為基礎的回應。 Use when: analyzing code, making recommendations, providing options, or when user asks about confidence/certainty. Keywords: certainty, assumption, inference, evidence, source, 證據, 假設, 推論.

AI 協作標準

語言: English | 繁體中文

版本: 1.1.0 最後更新: 2026-01-25 適用範圍: Claude Code Skills

---

目的

此技能確保 AI 助理提供準確、基於證據的回應，避免產生幻覺。

快速參考

確定性標籤

標籤	使用時機
[Confirmed]	來自程式碼/文件的直接證據
[Inferred]	基於證據的邏輯推論
[Assumption]	基於常見模式（需要驗證）
[Unknown]	資訊不可用
[Need Confirmation]	需要使用者澄清

來源類型

來源類型	標籤	可靠性
專案程式碼	[Source: Code]	⭐⭐⭐⭐⭐ 最高
專案文件	[Source: Docs]	⭐⭐⭐⭐ 高
外部文件	[Source: External]	⭐⭐⭐⭐ 高
網路搜尋	[Source: Search]	⭐⭐⭐ 中等
AI 知識	[Source: Knowledge]	⭐⭐ 低
使用者提供	[Source: User]	⭐⭐⭐ 中等

核心規則

1. 僅基於證據: 只分析已明確讀取的內容
2. 引用來源: 包含程式碼參考的檔案路徑和行號
3. 分類確定性: 為所有陳述標記確定性等級
4. 永遠提供建議: 在呈現選項時，包含建議選擇及其理由

詳細指南

完整標準請參閱：

• 防幻覺指南
• 確定性標籤參考

範例

✅ 正確回應

[Confirmed] src/auth/service.ts:45 - JWT 驗證使用 'jsonwebtoken' 函式庫
[Inferred] 基於 src/repositories/ 中的儲存庫模式，可能使用依賴注入
[Need Confirmation] 新功能是否應支援多租戶？

❌ 錯誤回應

系統使用 Redis 進行快取（程式碼未審查）
UserService 應該有 authenticate() 方法（API 未驗證）

✅ 正確選項呈現

有三個選項：
1. Redis 快取
2. 記憶體快取
3. 檔案快取

**建議：選項 1 (Redis)**：鑑於專案已有 Redis 基礎設施
且需要跨實例快取共享，Redis 是最合適的選擇。

❌ 錯誤選項呈現

有三個選項：
1. Redis 快取
2. 記憶體快取
3. 檔案快取

請選擇一個。

檢查清單

在做出任何陳述之前：

• 來源已驗證 - 我是否已讀取實際檔案/文件？
• 來源類型已標記 - 我是否指定了 [Source: Code]、[Source: External] 等？
• 參考已引用 - 我是否包含了檔案路徑和行號？
• 確定性已分類 - 我是否標記為 [Confirmed]、[Inferred] 等？
• 無捏造 - 我是否避免了虛構 API、設定或需求？
• 包含建議 - 在呈現選項時，我是否包含了建議選擇？

---

設定檢測

此技能支援專案特定的確定性標籤語言設定。

檢測順序

1. 檢查 CONTRIBUTING.md 中的「Certainty Tag Language」章節
2. 如果找到，使用指定的語言（English / 中文）
3. 如果未找到，預設使用英文標籤

首次設定

如果未找到設定且情境不明確：

1. 詢問使用者：「此專案尚未設定確定性標籤語言偏好。您想使用哪一種？（English / 中文）」
2. 使用者選擇後，建議在 CONTRIBUTING.md 中記錄：

## Certainty Tag Language

This project uses **[English / 中文]** certainty tags.
<!-- Options: English | 中文 -->

設定範例

在專案的 CONTRIBUTING.md 中：

## Certainty Tag Language

This project uses **English** certainty tags.

### Tag Reference
- [Confirmed] - Direct evidence from code/docs
- [Inferred] - Logical deduction from evidence
- [Assumption] - Based on common patterns
- [Unknown] - Information not available
- [Need Confirmation] - Requires user clarification

---

相關標準

• 防幻覺標準
• 程式碼審查檢查清單
• 測試標準

---

版本歷史

版本	日期	變更
1.0.0	2025-12-24	新增：標準章節（目的、相關標準、版本歷史、授權）

---

授權

此技能依據 CC BY 4.0 釋出。

來源: universal-dev-standards

Next Steps Guidance | 下一步引導

After /ai-collaboration completes, the AI assistant should suggest:

AI 協作行為規範已掌握。建議下一步 / AI collaboration behavior standards understood. Suggested next steps:

• 執行 /ai-instruction-standards 建立或更新 CLAUDE.md 等 AI 指令檔案 ⭐ Recommended / 推薦 — 將協作標準寫入專案配置 / Write collaboration standards into project configuration
• 執行 /ai-friendly-architecture 設計 AI 友善架構 — 從長期架構層面優化 AI 協作 / Optimize AI collaboration at the architecture level
• 執行 /code-review 運用確定性標籤進行程式碼審查 — 實踐基於證據的分析 / Practice evidence-based analysis

---

Related Standards

• Anti-Hallucination Standards
• Code Review Checklist
• Testing Standards

---

Version History

Version	Date	Changes
1.1.0	2026-01-25	Added: Unified Tag System with Certainty and Derivation tag categories
1.0.0	2025-12-24	Added: Standard sections (Purpose, Related Standards, Version History, License)

---

License

This skill is released under CC BY 4.0.

Source: universal-dev-standards