ai-friendly-architecture

# AI 友善架構指南 > **語言**: [English](../../../../skills/ai-friendly-architecture/SKILL.md) | 繁體中文 **版本**: 1.0.0 **最後更新**: 2026-01-25 **適用範圍**: Claude Code Skills --- > **核心標準**: 本技能實作 [AI 友善架構](../../core/ai-friendly-architecture.md)。完整方法論文件請參閱核心標準。 ## 目的 本技能協助設計專案架構，透過明確模式、分層文件和語義邊界，最大化 AI 協作效能。 ## 快速參考 ### 核心原則 | 原則 | 描述 | 效益 | |------|------|------| | **明確優於隱含** | 明確記錄行為 | AI 無需猜測即可理解 | | **分層上下文** | 多層級文件 | 依任務提供適當細節 | | **語義邊界** | 清晰的模組邊界 | 獨立分析 | | **可發現結構** | 自我說明的結構 | 快速定位 | ### 上下文層級 | 層級 | Token 預算 | 內容 | |------|------------|------| | **L1: 快速參考** | < 500 | 單行說明、API 簽章、入口點 | | **L2: 詳細** | < 5,000 | 完整 API 文件、使用範例 | | **L3: 範例** | 無限制 | 完整實作、邊界案例 | ### 建議結構 ``` project/ ├── .ai-context.yaml # AI 上下文配置 ├── docs/ │ ├── QUICK-REF.md # 第 1 層文件 │ └── ARCHITECTURE.md # 第 2 層文件 ├── src/ │ └── auth/ │ ├── index.ts # 入口點與模組標頭 │ ├── QUICK-REF.md # 模組快速參考 │ └── README.md # 模組文件 └── CLAUDE.md # AI 指令檔案 ``` ## 模組標頭範本 ```javascript /** * ═══════════════════════════════════════════════════════════ * 模組: [模組名稱] * ═══════════════════════════════════════════════════════════ * * 目的: [單句描述] * * 相依性: * - [dep1]: [原因] * - [dep2]: [原因] * * 匯出: * - [function1](params): [描述] * - [function2](params): [描述] * * 配置: * - [CONFIG_VAR]: [描述] * * ═══════════════════════════════════════════════════════════ */ ``` ## 詳細指南 完整標準請參閱： - [AI 友善架構標準](../../core/ai-friendly-archite...