Skip to content

Commit 10b0e3a

Browse files
committed
docs: 補充場景 8 獨立 Git Repository 和 Commit 作者規範
- 詳細記錄場景 8 使用獨立 repo 的設計原因和架構 - 明確 Git commit 作者規範:唯一作者為 Yulin Wang - 建立純淨的 commit 格式標準,專注於變更內容 - 完善專案開發和維護的重要指導原則
1 parent 03f7dea commit 10b0e3a

1 file changed

Lines changed: 48 additions & 1 deletion

File tree

CLAUDE.md

Lines changed: 48 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,36 @@
6767

6868
### **🎯 專家階段** (Agent 主導)
6969
7. **文件生成** (80% Agent) - Agent 文件自動化
70-
8. **綜合專案開發** (90% Agent) - Agent 完全主導
70+
8. **GitHub 自動化 Agent** (100% Agent) - 完全自動化的 GitHub 工作流程
71+
72+
### **⚠️ 場景 8 特殊架構設計**
73+
場景 8 使用**獨立的 GitHub Repository** (`copilot-agent-demo-todo`):
74+
75+
#### **為什麼需要獨立 Repo?**
76+
- **真實 GitHub 工作流程**:展示完整的 Issue → PR 流程
77+
- **避免污染主專案**:教學修改不影響學員下載的原始檔案
78+
- **預置測試 Issues**:可以準備 3-5 個實際的功能需求和 Bug
79+
- **完整 GitHub 體驗**:學員看到真實的 GitHub 操作和自動化
80+
81+
#### **獨立 Repo 設定**
82+
```
83+
copilot-agent-demo-todo/
84+
├── .github/
85+
│ ├── copilot-instructions.md # Agent 自動讀取的專案規範
86+
│ └── instructions/ # 詳細指令檔案
87+
├── index.html # 待辦事項應用
88+
├── app.js # 核心邏輯
89+
├── style.css # 樣式檔案
90+
└── README.md # 專案說明
91+
```
92+
93+
#### **教學流程**
94+
1. **展示預置 Issues**:瀏覽器開啟獨立 repo 的 Issues 頁面
95+
2. **Agent 完全接管**:從讀取 Issue 到創建 PR 的完整自動化
96+
3. **真實 PR 審核**:學員看到實際的 Pull Request
97+
4. **GitHub Pages 部署**:修改後的應用立即上線展示
98+
99+
這種設計讓學員體驗**真正的 AI 驅動開發工作流程**,而不只是本地檔案修改。
71100

72101
## 🏗️ 技術架構
73102

@@ -214,6 +243,24 @@
214243
- GitHub Pages 即時展示修改效果
215244
- 保留教學過程的完整記錄
216245

246+
### **⚠️ Git Commit 作者規範**
247+
248+
#### **重要:所有 commit 的作者必須是專案擁有者**
249+
- **Author**: Yulin Wang <yulin@example.com>
250+
- **純淨的 commit**:不添加額外的工具標註
251+
252+
#### **標準 Commit 格式**
253+
```bash
254+
git commit -m "feat: 功能描述
255+
256+
詳細說明..."
257+
```
258+
259+
#### **為什麼這樣設計?**
260+
- **專案擁有權明確**:Yulin Wang 是專案的唯一負責人和作者
261+
- **保持簡潔**:commit 訊息專注於變更內容本身
262+
- **專業呈現**:乾淨的 git 歷史記錄
263+
217264
## 🎯 預期成果
218265

219266
學員完成課程後將能夠:

0 commit comments

Comments
 (0)