Skip to content

Commit 4ee0c8a

Browse files
committed
docs: 移除 markdown 檔案中的 emoji
- 移除所有 markdown 檔案中的 emoji 符號 - 保持文字內容不變,提升專業文檔的簡潔性 - 包含 README.md、TEACHING.md、CLAUDE.md 及所有 LESSON_GUIDE.md
1 parent dc91e20 commit 4ee0c8a

File tree

13 files changed

+234
-234
lines changed

13 files changed

+234
-234
lines changed

.github/instructions/testing.instructions.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,10 +31,10 @@ describe('模組或功能名稱', () => {
3131

3232
## 測試覆蓋要求
3333
### 必須測試的情境:
34-
- **正常情況**:有效輸入的正確輸出
35-
- **邊界條件**:空值、null、undefined、空字串
36-
- **錯誤處理**:無效輸入的錯誤回應
37-
- **異常情境**:網路錯誤、超時等
34+
- **正常情況**:有效輸入的正確輸出
35+
- **邊界條件**:空值、null、undefined、空字串
36+
- **錯誤處理**:無效輸入的錯誤回應
37+
- **異常情境**:網路錯誤、超時等
3838

3939
### 測試類型:
4040
- **單元測試**:測試單一函數或方法

.github/prompts/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
這個目錄包含了可重複使用的 GitHub Copilot prompt files,用於常見的開發任務。
44

5-
## 📋 **Prompt Files vs Instructions 差異**
5+
## **Prompt Files vs Instructions 差異**
66

77
### Instructions Files (`.github/copilot-instructions.md`)
88
- **用途**:全專案的通用設定,自動套用到每個 Chat 請求
@@ -76,7 +76,7 @@ Chat: New Prompt File
7676
}
7777
```
7878

79-
## 💡 **最佳實踐**
79+
## **最佳實踐**
8080

8181
### 撰寫 Prompt Files
8282
1. **明確的描述**: 在 frontmatter 中提供清楚的 description

.github/prompts/refactoring.prompt.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ description: "程式碼重構最佳實踐"
7575
- [ ] 實作錯誤邊界 (Error Boundaries)
7676
- [ ] 加入輸入驗證
7777

78-
## 📊 **效能優化**
78+
## **效能優化**
7979
### 檢查項目:
8080
- [ ] 避免不必要的計算
8181
- [ ] 使用適當的資料結構
@@ -98,7 +98,7 @@ description: "程式碼重構最佳實踐"
9898
4. **測試驗證** - 確保功能未被破壞
9999
5. **文件更新** - 更新相關註解和文件
100100

101-
## 📋 **重構報告格式**
101+
## **重構報告格式**
102102
### 🔧 執行的重構
103103
- **重構類型**: [提取函數/重新命名/移動等]
104104
- **原因**: [為什麼需要這個重構]

.github/prompts/security-review.prompt.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ description: "執行程式碼安全性檢查"
4949
- 避免在日誌中記錄密碼或個人資料
5050
- 確保所有傳輸都使用加密
5151

52-
## 🌐 **網路安全**
52+
## **網路安全**
5353
### 檢查項目:
5454
- [ ] CORS 設定是否適當
5555
- [ ] CSP (Content Security Policy) 是否設定
@@ -88,10 +88,10 @@ app.use(helmet({
8888
- 定期更新依賴項
8989
- 考慮使用 Snyk 或類似工具
9090

91-
## 📋 **安全檢查清單**
91+
## **安全檢查清單**
9292
請提供以下格式的檢查結果:
9393

94-
### 已通過的安全檢查
94+
### 已通過的安全檢查
9595
- [項目名稱]: [檢查結果]
9696

9797
### ⚠️ 發現的安全風險

01-first-experience/LESSON_GUIDE.md

Lines changed: 28 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 場景 1:初次對話體驗
22

3-
## 🎯 學習目標
3+
## 學習目標
44
- 了解 GitHub Copilot 的**基本 Chat 功能**
55
- 學習如何使用 **ask** 功能進行對話
66
- **理解 @workspace 的重要性和實際差異**
@@ -24,16 +24,16 @@
2424

2525
在開始之前,請確認使用 **GPT-4.1** 模型:
2626
1. 開啟 Copilot Chat (`Ctrl+Alt+I`)
27-
2. 點擊 Chat 面板右上角的 ⚙️ 設定圖示
27+
2. 點擊 Chat 面板右上角的 設定圖示
2828
3. 在 Model 選項中選擇 **GPT-4.1**
2929
4. 確認顯示 "Using GPT-4.1"
3030

31-
💡 **為什麼選擇 GPT-4.1?**
31+
**為什麼選擇 GPT-4.1?**
3232
- 更準確的程式碼生成
3333
- 更好的專案理解能力
3434
- Edit 模式效果最佳
3535

36-
## 📚 Demo 劇本
36+
## Demo 劇本
3737

3838
### 階段 1:快速熟悉 Chat + @workspace 對比 (3分鐘)
3939

@@ -44,19 +44,19 @@
4444
```
4545
你好!我想建立一個簡單的待辦事項網頁,請告訴我基本的檔案結構和需要的功能?
4646
```
47-
💡 **使用模式:Ask**
47+
**使用模式:Ask**
4848

4949
#### 步驟 2:體驗 @workspace 的差異
50-
🔄 **開啟新對話**
50+
**開啟新對話**
5151
- 點擊 Chat 面板右上角的「+」或「New Chat」按鈕
5252
- 或使用快捷鍵:`Ctrl+L`
5353

5454
```
5555
@workspace 我想了解這個專案的結構,請告訴我現在有哪些檔案?
5656
```
57-
💡 **使用模式:Ask**
57+
**使用模式:Ask**
5858

59-
**觀察差異**
59+
**觀察差異**
6060
- **一般對話**:給通用建議
6161
- **@workspace**:能看到實際檔案,給出針對性回答
6262

@@ -66,13 +66,13 @@
6666
```
6767
@workspace 這個專案有哪些檔案?每個檔案的用途是什麼?
6868
```
69-
💡 **使用模式:Ask**
69+
**使用模式:Ask**
7070

7171
#### 步驟 4:**獲取學習建議**
7272
```
7373
@workspace 我是初學者,想了解待辦事項應用通常有哪些功能?學習 JavaScript 時應該注意什麼?
7474
```
75-
💡 **使用模式:Ask**
75+
**使用模式:Ask**
7676

7777
### 階段 3:程式碼自動完成體驗 (3分鐘)
7878

@@ -85,23 +85,23 @@
8585
3. 看到建議後,按 `Tab` 鍵接受
8686
4. 繼續輸入 `// 待辦事項`,觀察新的建議
8787

88-
**重點觀察**
88+
**重點觀察**
8989
- Ghost Text 會以灰色文字顯示建議
9090
-`Tab` 接受,按 `Esc` 拒絕
9191
- 建議會根據你的註解和程式碼上下文改變
9292

9393
### 階段 4:Edit 模式實作 (5分鐘)
9494

9595
#### 步驟 6:準備 Edit 模式的 Context
96-
🔄 **開啟新對話**
97-
1. 在 Chat 視窗中,點擊輸入框左側的 **📎** 圖示
96+
**開啟新對話**
97+
1. 在 Chat 視窗中,點擊輸入框左側的 **** 圖示
9898
2. 選擇「Add Files」
9999
3. 勾選以下檔案:
100100
- `index.html` (重要!讓 Copilot 了解 DOM 結構)
101101
- `script.js` (要編輯的檔案)
102102
4. 確認檔案已加入(會顯示在輸入框上方)
103103

104-
💡 **為什麼要加入 index.html?**
104+
**為什麼要加入 index.html?**
105105
讓 Copilot 看到按鈕和列表的 ID,才能生成正確的程式碼
106106

107107
#### 步驟 7:使用 Edit 模式完成功能
@@ -110,7 +110,7 @@
110110
```
111111
實作待辦事項的新增功能,點擊按鈕要能新增項目到列表
112112
```
113-
💡 **使用模式:Edit**
113+
**使用模式:Edit**
114114

115115
3. Copilot 會顯示修改預覽
116116
4. 檢視程式碼,確認使用了正確的 ID (`todoInput`, `addButton`, `todoList`)
@@ -126,20 +126,20 @@
126126
- 點擊「新增」按鈕
127127
- 確認項目出現在列表中
128128

129-
**Edit 模式關鍵學習**
129+
**Edit 模式關鍵學習**
130130
- 必須加入相關檔案作為 context
131131
- Copilot 會根據 context 生成符合專案的程式碼
132132
- 簡單的 prompt 就能完成功能
133133

134134
### 階段 5:UI 美化體驗 (5分鐘)
135135

136136
#### 步驟 9:使用 @workspace 分析現有樣式
137-
🔄 **開啟新對話**
137+
**開啟新對話**
138138
1. 使用 @workspace 了解現有設計:
139139
```
140140
@workspace 請分析 style.css 的設計風格,包括配色、排版和整體視覺風格
141141
```
142-
💡 **使用模式:Ask**
142+
**使用模式:Ask**
143143

144144
#### 步驟 10:獲取樣式改進建議
145145
```
@@ -149,10 +149,10 @@
149149
- 添加動畫和過渡效果
150150
- 提升整體視覺層次
151151
```
152-
💡 **使用模式:Ask**
152+
**使用模式:Ask**
153153

154154
#### 步驟 11:使用 Edit 模式實作樣式改進
155-
1. 點擊 📎 圖示,選擇 `style.css` 檔案
155+
1. 點擊 圖示,選擇 `style.css` 檔案
156156
2. 切換到 **Edit** 模式
157157
3. 輸入具體的修改需求:
158158
```
@@ -163,7 +163,7 @@
163163
4. 給待辦事項添加滑入動畫,讓新增項目更有動感
164164
5. 優化整體配色,使用更專業的色彩搭配
165165
```
166-
💡 **使用模式:Edit**
166+
**使用模式:Edit**
167167

168168
4. 檢視 Copilot 的修改預覽
169169
5. 點擊 **Accept** 接受修改
@@ -175,12 +175,12 @@
175175
- 新增項目的動畫
176176
- 整體視覺層次的改善
177177

178-
**樣式修改關鍵學習**
178+
**樣式修改關鍵學習**
179179
- Copilot 能理解設計意圖並轉化為 CSS
180180
- 可以一次性處理多個樣式需求
181181
- 生成的程式碼包含現代 CSS 特性(動畫、漸變、陰影等)
182182

183-
### 🔍 重點觀察
183+
### 重點觀察
184184

185185
#### **@workspace vs 一般對話差異**
186186
- **一般對話**:籠統建議,不了解專案脈絡
@@ -197,7 +197,7 @@
197197
- **現代化設計**:Copilot 了解當前設計趨勢
198198
- **完整性思考**:不只改單一元素,而是整體提升
199199

200-
## 💡 重點提示
200+
## 重點提示
201201

202202
### **@workspace 最佳實踐**
203203
1. **永遠使用 @workspace**:這是最重要的聊天參與者
@@ -220,7 +220,7 @@
220220
- **如何開啟新對話**:點擊 Chat 面板上方的「新對話」按鈕
221221
- **對話歷史**:Copilot 會記住同一對話中的上下文
222222

223-
## 🎬 Demo 重點
223+
## Demo 重點
224224
1. **@workspace 對比展示**:先不用 → 再使用,展現明顯差異
225225
2. **快速開啟 Chat**`Ctrl+Alt+I` 熟練操作
226226
3. **專案感知能力**:展示 AI 如何理解專案結構
@@ -229,20 +229,20 @@
229229
6. **UI 美化能力**:展示 Copilot 的設計理解力
230230
7. **建立基礎認知**:為後續 Agent 學習做準備
231231

232-
## 預期成果
232+
## 預期成果
233233
完成本場景後,您應該:
234234
- **深刻理解 @workspace 的重要性**
235235
- 能夠開啟並使用 Copilot Chat
236236
- 了解如何提出有效的問題
237237
- 體驗基本的程式碼自動完成功能
238238
- **建立對 GitHub Copilot 的基礎認知**(為後續學習做準備)
239239

240-
## 🔍 延伸練習
240+
## 延伸練習
241241
1. **對比測試**:同樣問題分別用一般對話和 @workspace 詢問
242242
2.@workspace 解釋它對專案結構的理解
243243
3. 要求 @workspace 提供符合專案風格的不同實作方式
244244

245-
## 🎯 為下階段準備
245+
## 為下階段準備
246246
- 第一階段建立了 @workspace 的基礎認知
247247
- 第二階段將深入探索 @workspace 的程式碼解釋能力
248248
- 第三階段開始引入 Agent 模式,展現更強大的功能

0 commit comments

Comments
 (0)