11# GitHub Copilot 教學專案 - 專案指令
22
3- ## 👤 專案作者
3+ ## 專案作者
44- ** 作者** : Yulin Wang (yulin0629)
55- ** GitHub** : https://github.com/yulin0629
66
7- ## 📋 專案概述
7+ ## 專案概述
88建立一個完整的 GitHub Copilot 教學課程,時長 2 小時,專注於 ** Agent 模式** 的實際應用。
99
10- ## 🎯 目標聽眾
10+ ## 目標聽眾
1111- ** PM (產品經理)** :了解 AI 輔助開發如何提升產品開發效率
1212- ** SA (系統分析師)** :學習如何利用 AI 進行系統分析和架構設計
1313- ** PG (程式設計師)** :掌握 AI 輔助編程的實際技能
1414- ** VD (視覺設計師)** :了解如何與 AI 工具協作提升設計效率
1515
16- ## 🚀 核心功能重點
16+ ## 核心功能重點
1717
1818### ** Agent 模式 (50% 內容重點)**
1919- Agent 自主開發能力
3232- ** Inline Chat** (` Ctrl+I ` ):即時編輯輔助
3333- ** Ghost Text** :智能程式碼建議
3434
35- ### ** ⚠️ GitHub Copilot 操作模式說明**
35+ ### ** GitHub Copilot 操作模式說明**
3636#### ** Chat 模式** (Ctrl+Alt+I)
3737- ** Ask** :純對話,獲取建議和指導,不會修改程式碼
3838- ** Agent** :自主執行任務,多步驟操作,會直接修改檔案
4343- ** 場景 3+** :逐步引入 ** Agent 模式** ,展示自主能力
4444- ** Edit 模式** :當需要對單一檔案進行明確修改時使用(本教學較少使用)
4545
46- #### ** ⚠️ Prompt 撰寫規範**
46+ #### ** Prompt 撰寫規範**
4747- ** 每個 Prompt 後必須加上模式指示** :
48- - ` 💡 **使用模式:Ask**`
49- - ` 💡 **使用模式:Agent**`
50- - ` 💡 **使用模式:Edit**` (較少使用)
51- - ** 新對話指示** :需要時加上 ` 🔄 **開啟新對話**`
48+ - ` **使用模式:Ask** `
49+ - ` **使用模式:Agent** `
50+ - ` **使用模式:Edit** ` (較少使用)
51+ - ** 新對話指示** :需要時加上 ` **開啟新對話** `
5252- ** 目的** :明確告訴學員在 VS Code 中應該選擇哪個模式和何時重新開始
5353
54- ## 📁 8 個漸進式學習場景
54+ ## 8 個漸進式學習場景
5555
56- ### ** 🌱 基礎階段** (建立認知) ⚠️ ** 0% Agent 嚴格執行**
56+ ### ** 基礎階段** (建立認知) ** 0% Agent 嚴格執行**
57571 . ** 初次對話體驗** (0% Agent) - 傳統 Chat 功能,@workspace 認知建立
58582 . ** 程式碼解釋實作** (0% Agent) - @workspace 核心應用,程式碼理解
5959
60- ### ** 🚀 進階階段** (引入 Agent)
60+ ### ** 進階階段** (引入 Agent)
61613 . ** 函數生成** (20% Agent) - 體驗 Agent 協助編程
62624 . ** 偵錯輔助** (30% Agent) - Agent 智能診斷
6363
64- ### ** 🔥 專業階段** (Agent 主角)
64+ ### ** 專業階段** (Agent 主角)
65655 . ** 單元測試** (50% Agent) - Agent 測試策略
66666 . ** 程式碼重構** (60% Agent) - Agent 重構規劃
6767
68- ### ** 🎯 專家階段** (Agent 主導)
68+ ### ** 專家階段** (Agent 主導)
69697 . ** 文件生成** (80% Agent) - Agent 文件自動化
70708 . ** GitHub 自動化 Agent** (100% Agent) - 完全自動化的 GitHub 工作流程
7171
72- ### ** ⚠️ 場景 8 特殊架構設計**
72+ ### ** 場景 8 特殊架構設計**
7373場景 8 使用** 獨立的 GitHub Repository** (` copilot-agent-demo-todo ` ):
7474
7575#### ** 為什麼需要獨立 Repo?**
@@ -98,7 +98,7 @@ copilot-agent-demo-todo/
9898
9999這種設計讓學員體驗** 真正的 AI 驅動開發工作流程** ,而不只是本地檔案修改。
100100
101- ## 🏗️ 技術架構
101+ ## 技術架構
102102
103103### ** 指令系統架構**
104104```
@@ -128,22 +128,22 @@ copilot-agent-demo-todo/
128128}
129129```
130130
131- ## 📚 課程設計原則
131+ ## 課程設計原則
132132
133- ### ** 由淺入深的學習路徑** ⚠️ ** 嚴格遵守**
133+ ### ** 由淺入深的學習路徑** ** 嚴格遵守**
134134- ** 前期** :建立基礎認知,** 絕對不使用 Agent**
135135 - 場景 1:純對話體驗,重點是 @workspace 認知
136136 - 場景 2:程式碼解釋,@workspace 應用但無 Agent
137137- ** 中期** :逐步引入 Agent,展示價值差異
138138- ** 後期** :深度應用 Agent,展示完整潛力
139139
140- ### ** ⚠️ 課程設計鐵律**
140+ ### ** 課程設計鐵律**
1411411 . ** 嚴格按照 Agent 比例** :場景 1-2 必須是 0% Agent(只用 Ask)
1421422 . ** 不可超前實作** :前期場景只能是對話和學習,不能進行複雜開發
1431433 . ** 漸進式體驗** :每個階段都有明確的學習重點,不可混淆
1441444 . ** 建立認知為主** :前期重點是讓學員理解工具價值,而非完成專案
145- 5 . ** 模式標示強制** :每個 Prompt 範例後必須標明 ` 💡 **使用模式:Ask**` 或 ` 💡 **使用模式:Agent**`
146- 6 . ** 新對話管理** :必要時指示學員 ` 🔄 **開啟新對話**` ,避免上下文混淆
145+ 5 . ** 模式標示強制** :每個 Prompt 範例後必須標明 ` **使用模式:Ask** ` 或 ` **使用模式:Agent** `
146+ 6 . ** 新對話管理** :必要時指示學員 ` **開啟新對話** ` ,避免上下文混淆
1471477 . ** 輸入內容格式** :所有需要學員輸入的提示詞、程式碼片段都必須使用 code block 格式,方便複製
1481488 . ** Context 管理** :在修改教學內容時,必須考慮是否需要加入 @workspace 或其他 context 參與者
1491499 . ** Context 準備說明** :每個 Demo 步驟前都必須清楚說明 Context 準備(例如:需要開啟哪些檔案、是否需要加入 context 等)
@@ -198,7 +198,7 @@ copilot-agent-demo-todo/
198198- 程式碼風格和開發規範的統一
199199- Prompt Files 的分享和重複使用
200200
201- ## ⚠️ 重要限制和注意事項
201+ ## 重要限制和注意事項
202202
203203### ** Visual Studio 支援**
204204- 本課程專注於 VS Code
@@ -217,7 +217,7 @@ copilot-agent-demo-todo/
217217- 重點展示而非詳細教學每個功能
218218- 提供實用的 takeaway 工具和模板
219219
220- ## 📌 Git 分支管理策略
220+ ## Git 分支管理策略
221221
222222### ** 教學專案分支設計**
223223- ** main 分支** :保持原始教學檔案,供學員下載使用
@@ -243,7 +243,7 @@ copilot-agent-demo-todo/
243243- GitHub Pages 即時展示修改效果
244244- 保留教學過程的完整記錄
245245
246- ### ** ⚠️ Git Commit 作者規範**
246+ ### ** Git Commit 作者規範**
247247
248248#### ** 重要:所有 commit 的作者必須是專案擁有者**
249249- ** Author** : Yulin Wang < yulin@example.com >
@@ -261,7 +261,7 @@ git commit -m "feat: 功能描述
261261- ** 保持簡潔** :commit 訊息專注於變更內容本身
262262- ** 專業呈現** :乾淨的 git 歷史記錄
263263
264- ## 🎯 預期成果
264+ ## 預期成果
265265
266266學員完成課程後將能夠:
267267- 熟練使用 GitHub Copilot Agent 模式
0 commit comments