AI Instruction Standards

AI 指令檔案標準指南

語言: English | 繁體中文

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

核心標準: 本技能實作 AI 指令檔案標準。完整方法論文件請參閱核心標準。

AI 技能層級

此技能是三層 AI 協作系統的一部分：

目的

本技能協助建立和維護 AI 指令檔案，適當區分通用標準與專案特定配置。

快速參考

支援的 AI 工具

核心原則：通用 vs 專案特定

建議配置

# [專案名稱] - AI 指令

## 通用標準
<!-- 適用於任何專案的規則 -->
- Commit 訊息格式
- 程式碼審查清單
- 測試標準
- 反幻覺規則

---

## 專案特定配置
<!-- 此專案獨有的設定 -->

### 技術棧
[你的技術在此]

### 快速命令
[你的建置/測試/部署命令]

### 檔案結構
[你的專案結構]

詳細指南

完整標準請參閱：

• AI 指令檔案標準

AI 優化格式（Token 效率）

AI 助手可使用 YAML 格式檔案以減少 Token 使用：

• 基礎標準：ai/standards/ai-instruction-standards.ai.yaml

內容指南

通用內容（保持通用）

通用區段應避免：

• 特定命令（npm test、pytest）
• 固定路徑（cli/src/、/var/www/）
• 版本號（Node.js 18、Python 3.11）
• 專案名稱和 URL

專案特定內容

標籤慣例

選項 A：區段標題

## 通用標準
[通用內容]

## 專案特定配置
[專案特定內容]

選項 B：行內標記

> ⚠️ **專案特定**：本區段包含此專案獨有的配置。

### 技術棧
...

選項 C：註解標註

<!-- 通用：以下適用於所有專案 -->
### Commit 訊息格式
...

<!-- 專案特定：為你的專案自訂 -->
### 快速命令
...

多工具配置

使用多個 AI 工具時，保持一致性：

project/
├── CLAUDE.md              # Claude Code 指令
├── .cursorrules           # Cursor 指令（可從 CLAUDE.md 匯入）
├── .windsurfrules         # Windsurf 指令
└── .github/
    └── copilot-instructions.md  # Copilot 指令

最佳實踐：建立共用的 docs/ai-standards.md 並從各工具檔案引用，避免重複。

維護檢查清單

提交 AI 指令檔案變更前：

• 通用區段不包含專案特定的路徑、命令或版本
• 專案特定區段有明確標記
• 標準文件的交叉引用正確
• 格式與現有區段一致

配置偵測

本技能支援專案特定配置。

偵測順序

1. 檢查是否存在 CLAUDE.md 或等效檔案
2. 分析內容結構是否區分通用/專案特定
3. 若未找到，建議建立結構化 AI 指令檔案

首次設定

若未找到 AI 指令檔案：

1. 詢問：「此專案沒有 AI 指令檔案。是否要建立一個？」
2. 確定專案類型和技術棧
3. 產生包含適當區段的範本
4. 若包含敏感資訊，新增到 .gitignore

相關標準

• AI 指令檔案標準 - 核心標準
• 文件撰寫標準 - 撰寫指南
• 反幻覺規範 - AI 準確性規則
• AI 友善架構 - 上下文優化

版本歷史

授權

本技能以 CC BY 4.0 授權發布。

來源: universal-dev-standards