|
3 | 3 | ## 🎯 學習目標 |
4 | 4 | - 了解 GitHub Copilot 的**基本 Chat 功能** |
5 | 5 | - 學習如何使用 **ask** 功能進行對話 |
| 6 | +- **理解 @workspace 的重要性和實際差異** |
6 | 7 | - 掌握**程式碼自動完成**的基礎操作 |
7 | 8 | - 熟悉 Copilot Chat 介面和快捷鍵 |
8 | 9 | - **建立使用 Copilot 的基礎認知**(為後續 Agent 學習打基礎) |
9 | 10 |
|
10 | 11 | ## 📝 場景說明 |
11 | | -您是一位剛開始使用 GitHub Copilot 的開發者,需要建立一個簡單的待辦事項應用程式。這個階段**專注於傳統 Chat 功能**,不使用 Agent 模式,讓您先熟悉基本操作。 |
| 12 | +您是一位剛開始使用 GitHub Copilot 的開發者,想要了解這個工具的基本功能。這個階段**專注於傳統 Chat 功能**(0% Agent),通過簡單的對話體驗建立基礎認知,特別是 **@workspace 與一般對話的重要差異**。 |
12 | 13 |
|
13 | 14 | ## 🛠️ 初始專案結構 |
14 | 15 | ``` |
|
21 | 22 |
|
22 | 23 | ## 📚 Demo 劇本 |
23 | 24 |
|
24 | | -### 階段 1:快速熟悉 Chat (2分鐘) |
| 25 | +### 階段 1:快速熟悉 Chat + @workspace 對比 (3分鐘) |
25 | 26 |
|
26 | | -#### 步驟 1:開啟並體驗 Chat |
27 | | -1. 在 VS Code 中開啟本資料夾 |
| 27 | +#### 步驟 1:開啟並體驗基本 Chat |
| 28 | +1. 在 VS Code 中開啟本資料夾 (`01-first-experience/`) |
28 | 29 | 2. 按下 `Ctrl+Alt+I` (或 `Cmd+Option+I`) 開啟 Copilot Chat |
29 | | -3. **對話** (Ask): |
| 30 | +3. **一般提問**: |
30 | 31 | ``` |
31 | 32 | 你好!我想建立一個簡單的待辦事項網頁,請告訴我基本的檔案結構和需要的功能? |
32 | 33 | ``` |
| 34 | +💡 **使用模式:Ask** |
33 | 35 |
|
34 | | -### 階段 2:核心 Chat 功能展示 (5分鐘) |
| 36 | +#### 步驟 2:體驗 @workspace 的差異 |
| 37 | +🔄 **開啟新對話** |
| 38 | +- 點擊 Chat 面板右上角的「+」或「New Chat」按鈕 |
| 39 | +- 或使用快捷鍵:`Ctrl+L` |
35 | 40 |
|
36 | | -#### 步驟 2:**獲取實作指導** (Ask) |
37 | 41 | ``` |
38 | | -我已經有 HTML 和 CSS 檔案了,現在需要 JavaScript 來實作新增、刪除待辦事項的功能。請給我具體的程式碼結構建議。 |
| 42 | +@workspace 我想了解這個專案的結構,請告訴我現在有哪些檔案? |
39 | 43 | ``` |
| 44 | +💡 **使用模式:Ask** |
40 | 45 |
|
41 | | -#### 步驟 3:**請求程式碼優化建議** (Ask) |
| 46 | +✅ **觀察差異**: |
| 47 | +- **一般對話**:給通用建議 |
| 48 | +- **@workspace**:能看到實際檔案,給出針對性回答 |
| 49 | + |
| 50 | +### 階段 2:核心 Chat 功能展示 (4分鐘) |
| 51 | + |
| 52 | +#### 步驟 3:**了解專案結構** |
| 53 | +``` |
| 54 | +@workspace 這個專案有哪些檔案?每個檔案的用途是什麼? |
42 | 55 | ``` |
43 | | -我的 JavaScript 程式碼應該遵循哪些最佳實踐?有什麼常見的錯誤需要避免? |
| 56 | +💡 **使用模式:Ask** |
| 57 | + |
| 58 | +#### 步驟 4:**獲取學習建議** |
| 59 | +``` |
| 60 | +@workspace 我是初學者,想了解待辦事項應用通常有哪些功能?學習 JavaScript 時應該注意什麼? |
44 | 61 | ``` |
| 62 | +💡 **使用模式:Ask** |
45 | 63 |
|
46 | 64 | ### 階段 3:程式碼自動完成體驗 (3分鐘) |
47 | 65 |
|
48 | | -#### 步驟 4:體驗 Ghost Text |
| 66 | +#### 步驟 5:體驗 Ghost Text(僅體驗,不深入實作) |
49 | 67 | 1. 開啟 `script.js` |
50 | | -2. 輸入:`// 待辦事項陣列`,按 Enter |
51 | | -3. 繼續輸入:`const todos = `,觀察 Copilot 建議 |
52 | | -4. 按 `Tab` 接受建議 |
53 | | - |
54 | | -#### 步驟 5:函數自動完成 |
55 | | -```javascript |
56 | | -// 新增待辦事項函數 |
57 | | -function addTodo( |
58 | | -``` |
59 | | -⚡ **重點觀察**:Copilot 如何預測參數和函數內容 |
| 68 | +2. 輸入:`// 學習 GitHub Copilot`,按 Enter |
| 69 | +3. 繼續輸入:`console.log(`,觀察 Copilot 建議 |
| 70 | +4. 按 `Tab` 接受建議,感受自動補全 |
| 71 | + |
| 72 | +⚡ **重點觀察**:體驗 Ghost Text 的建議效果,但不進行複雜程式開發 |
60 | 73 |
|
61 | 74 | ### 🔍 重點觀察 |
62 | | -- **Chat 回應速度**:了解等待時間,學會耐心 |
| 75 | + |
| 76 | +#### **@workspace vs 一般對話差異**: |
| 77 | +- **一般對話**:籠統建議,不了解專案脈絡 |
| 78 | +- **@workspace**:針對性強,程式碼可直接使用 |
| 79 | +- **效率差異**:@workspace 節省 50-70% 的溝通成本 |
| 80 | + |
| 81 | +#### **Chat 使用體驗**: |
| 82 | +- **回應速度**:了解等待時間,學會耐心 |
63 | 83 | - **需要明確指導**:問題越具體,答案越有用 |
64 | 84 | - **逐步建構**:傳統模式需要分步驟完成專案 |
65 | 85 |
|
66 | 86 | ## 💡 重點提示 |
67 | 87 |
|
68 | | -### Ask 模式使用技巧: |
| 88 | +### **@workspace 最佳實踐**: |
| 89 | +1. **永遠使用 @workspace**:這是最重要的聊天參與者 |
| 90 | +2. **讓 AI 先了解專案**:讓它分析現有結構 |
| 91 | +3. **要求針對性建議**:避免通用範例程式碼 |
| 92 | + |
| 93 | +### **Ask 模式使用技巧**: |
69 | 94 | 1. **明確具體**:問題越具體,答案越精準 |
70 | 95 | 2. **提供上下文**:說明您的需求和限制 |
71 | 96 | 3. **迭代改進**:根據回答繼續深入詢問 |
72 | 97 |
|
73 | | -### Ask 模式常用提示詞範例: |
74 | | -- "請解釋這段程式碼的功能" |
75 | | -- "如何優化這個函數的效能?" |
76 | | -- "這個錯誤訊息是什麼意思?" |
77 | | -- "請提供最佳實踐建議" |
| 98 | +### **常用提示詞範例**: |
| 99 | +- `@workspace 請分析這個專案的結構` |
| 100 | +- `@workspace 如何優化這個函數的效能?` |
| 101 | +- `@workspace 這個錯誤在我的專案中如何解決?` |
| 102 | +- `@workspace 根據現有架構提供最佳實踐建議` |
| 103 | + |
| 104 | +### **Chat 管理技巧**: |
| 105 | +- **何時開啟新對話**:切換不同主題或想要清晰對比時 |
| 106 | +- **如何開啟新對話**:點擊 Chat 面板上方的「新對話」按鈕 |
| 107 | +- **對話歷史**:Copilot 會記住同一對話中的上下文 |
78 | 108 |
|
79 | 109 | ## 🎬 Demo 重點 |
80 | | -1. **快速開啟 Chat**:`Ctrl+Alt+I` 熟練操作 |
81 | | -2. **有效提問技巧**:具體、有上下文的問題 |
82 | | -3. **Ghost Text 體驗**:灰色建議 → Tab 接受 |
83 | | -4. **建立基礎認知**:為後續 Agent 學習做準備 |
| 110 | +1. **@workspace 對比展示**:先不用 → 再使用,展現明顯差異 |
| 111 | +2. **快速開啟 Chat**:`Ctrl+Alt+I` 熟練操作 |
| 112 | +3. **專案感知能力**:展示 AI 如何理解專案結構 |
| 113 | +4. **Ghost Text 體驗**:灰色建議 → Tab 接受 |
| 114 | +5. **建立基礎認知**:為後續 Agent 學習做準備 |
84 | 115 |
|
85 | 116 | ## ✅ 預期成果 |
86 | 117 | 完成本場景後,您應該: |
| 118 | +- **深刻理解 @workspace 的重要性** |
87 | 119 | - 能夠開啟並使用 Copilot Chat |
88 | 120 | - 了解如何提出有效的問題 |
89 | | -- 掌握基本的程式碼自動完成 |
90 | | -- 建立一個簡單但功能完整的待辦事項應用程式 |
| 121 | +- 體驗基本的程式碼自動完成功能 |
| 122 | +- **建立對 GitHub Copilot 的基礎認知**(為後續學習做準備) |
91 | 123 |
|
92 | 124 | ## 🔍 延伸練習 |
93 | | -1. 嘗試用不同方式詢問相同問題,比較回答差異 |
94 | | -2. 請 Copilot 解釋它生成的程式碼 |
95 | | -3. 要求 Copilot 提供程式碼的其他實作方式 |
| 125 | +1. **對比測試**:同樣問題分別用一般對話和 @workspace 詢問 |
| 126 | +2. 請 @workspace 解釋它對專案結構的理解 |
| 127 | +3. 要求 @workspace 提供符合專案風格的不同實作方式 |
| 128 | + |
| 129 | +## 🎯 為下階段準備 |
| 130 | +- 第一階段建立了 @workspace 的基礎認知 |
| 131 | +- 第二階段將深入探索 @workspace 的程式碼解釋能力 |
| 132 | +- 第三階段開始引入 Agent 模式,展現更強大的功能 |
0 commit comments