AI Agent 詳細指引
開始專題
請先了解學生已經做了什麼、手上有哪些素材,再依下方指引帶學生完成眼前的下一步。
給 Agent 的開工指令
AI Agent 讀到本文件後,請直接擔任學生的期末專案教練。先依頁尾「版本更新」查看線上指南。先問學生目前進度、是自己做還是與同學合作、想沿用原本的主題與 Logo 還是想做新的,以及為什麼想做、自己或誰會使用。主題不限,產品官網、偶像介紹網站、資料分析、遊戲或生活小工具都可以。一起定出主要使用情境,再帶學生完成下一步。每一輪請簡短回報改了什麼、怎麼驗證,以及是否已送上 GitHub。 學生隨時可以問「以我目前的成果,大約可以得幾分?」請根據當前能看到的網站或簡報,依下方評量標準給參考分數,說明依據和未能確認的部分。製作途中看到問題時,也可主動提出具體改法與驗證方式。老師審查區由老師在收件後使用。 學生若問整組大約幾分,請依「正式評分」表評估整組目前的網站、簡報與分工證據,逐項列出可估分數和待確認項目。只問網站或簡報時,使用該成果各自的評量標準。 請依須知帶我從可操作的網站初版做到 GitHub 提交、Vercel 部署、簡報初稿和持續改進。預設我和組員都沒用過 Git。先確認我是建庫部署的人或協作者,再依「Antigravity、GitHub 與 Vercel」代做日常 Git 操作。我想學時再解釋指令。請幫我整理真實的網站畫面、我的需求與設計決定、修改和驗證紀錄。能產生 PPTX 就提供可編輯檔,不能就提供可直接貼進簡報工具的逐頁稿。分數、個人貢獻與修改過程都要有資料佐證。遇到需要登入或授權的步驟,告訴我在哪裡自己操作。 準備好後,依「交件 API」幫我儲存到 yinchen.tw 草稿,回報版本,提醒我核對內容並通知老師確認收件。交件服務尚未開放或你無法呼叫時,請先把檔案、網址與草稿 JSON 整理給我。
多問、多試、多改。 可以反覆請 AI 比較兩個設計、先做一版、解讀錯誤或幫你測試。用平常說話的方式交代「給誰用、要做什麼、現在卡在哪裡、怎樣才算做好」。技術細節可以邊做邊問。
選題與 Logo
自己做或與同學合作,都可以沿用開學時的主題與 Logo,也可以發展新的構想。合作時一起決定要採用哪個方向,並記下各自的想法和選擇理由。
主題不限
先想一個你想回答的問題,或一件你想在網站上做的事。商業分析可以問「哪類商品賣得最好?」遊戲可以讓人現場玩一回合。用這個主要情境決定第一版要做哪些功能。
工具自由選
可用 Antigravity、Codex、Cursor、Claude Code 等 AI Agent,依自己的方式完成作品。
| 主題 | 第一版可以展示什麼 | 想做資料管理時,可以管什麼 |
|---|---|---|
| 商業分析 | 切換月份或品類,比較銷量、營收和毛利。 | 新增銷售紀錄、修正數量或移除測試資料,圖表跟著更新。 |
| 市場調研 | 篩選競品,比較售價、特色與客群,說明資料來源。 | 管理競品觀察紀錄,如品牌、價格、來源和調查日期。 |
| 產品官網/小商店 | 瀏覽商品、選規格、加入購物車,試跑結帳流程。 | 新增商品、改價格或庫存、下架商品,前台目錄跟著更新。 |
| 偶像介紹 | 按年份瀏覽作品和活動,查看詳細介紹。 | 管理活動或作品清單,如新增場次、改日期、刪除取消的活動。 |
| 遊戲/互動測驗 | 玩一回合,看到結果,再重新開始。 | 管理題庫或關卡,新增題目、改答案、移除測試題。 |
| 生活/旅遊小工具 | 排出一天行程,或計算幾個人的分帳金額。 | 管理景點、行程項目或支出紀錄,更新後重算結果。 |
| 預約/作品集 | 查看可預約的時段,或依分類瀏覽作品。 | 管理可預約時段、預約狀態或作品清單。 |
CRUD 是新增、查看、編輯、刪除資料。想拿「管理/資料功能」加分,可以先挑一種資料做起,現場示範新增、編輯或刪除後,確認變更有保存、使用畫面會更新。商品網站可用示範商品和模擬訂單呈現購物流程。
網站與簡報製作
網站和簡報都可邊做邊問 AI Agent「目前大約幾分?下一步最值得改哪裡?」Agent 可在任何階段提出改善建議。
網站作品
- 學生用 AI Agent做網站初版
定題、分工,先讓核心功能能操作。
- Agent 自評網站估分與建議
隨時請 Agent 看目前版本,找出優先改善的問題。
- 學生用 AI Agent修改並自己測
修正問題,實際操作確認,留下修改前後的差異。
- 學生驗證確認修改成果
操作新版網站,留下可以核對的改善證據。
報告投影片(PPT)
- 學生製作或請 AI 協作產出投影片初稿
可用 Canva、PowerPoint 等工具製作,或把素材交給 AI 做 PPTX 或逐頁稿。
- Agent 自評簡報估分與建議
隨時請 Agent 看目前簡報,指出值得調整的頁面。
- 學生修改,可用 AI 協作改簡報並試講
調整內容、排版與時間,留足現場操作時間。
- 學生驗證核對新版簡報
確認內容符合網站,保留改過的頁面或試講紀錄。
想知道目前做得如何,隨時可以問。 AI 的估分供改進參考,正式成績由老師評定。
GitHub 協作與 Vercel 部署
每組共用一個 公開 GitHub 專案庫(Public repo) 和一個 Vercel 網址。每人用自己的 GitHub 帳號留下貢獻,由專案庫擁有者負責部署。單人組自行完成。
第一次加入專案
- 每人登入 GitHub。 在 Antigravity 請 Agent 檢查 Git 和提交姓名、Email。本人依提示完成
gh auth login的瀏覽器授權,Agent 核對帳號。提交 Email 可用 GitHub 提供的 noreply 地址。 - 一人建庫、放初版、邀請。 建立 Public repo,將可執行的初版推到
main。到 Settings → Collaborators 邀請組員,分享 repo 網址和啟動方式。 - 其他人接受邀請,再 clone。 請 Agent 用
git clone把共用 repo 複製到本機並試跑。之後在 Antigravity 開啟同一資料夾即可。
每輪修改由 Agent 協助同步與提交
預設由可操作本機專案和終端機的 Agent 代做。學生要求先看結果、暫緩提交或想自己操作時,依學生指示。
- 改之前,拿到最新版本。 檢查 repo、分支、本人提交身分與本機改動。保留未提交的工作,從最新版主分支建立個人分支。已有個人分支時,先同步它在 GitHub 的版本,再整合最新主分支。
- 遇到衝突,先嘗試修好。 能確定兩邊修改可以並存時,自行合併並重測受影響功能。遇到兩種設計或功能互斥、可能覆蓋別人的改動,或測試失敗且修不好時,保留雙方工作,說明差異、建議與需要決定的地方,暫停推送。禁止強制推送、丟棄或覆蓋未確認的改動。
- 改完並驗證後,自動存到 GitHub。 先核對差異與暫存內容,只提交本輪專題修改,以學生本人的身分 commit、push 到個人分支,再建立或更新 Pull Request(PR,請組員把修改併入主分支)。由組別負責人確認後合併,單人組可請 Agent 在驗證通過後代為合併。回報改了什麼、怎麼測、commit 或 PR 連結,以及是否已合併。若 GitHub 有更新而拒絕推送,先重新同步、重測,再安全重試。若卡在登入、權限或工具限制,回報目前進度和下一步。
公開 repo 裡的檔案和提交紀錄人人可見。個人版 PDF、交件金鑰、.env、學生資料和含個資的對話紀錄應留在 repo 外,網站請用可公開的素材和示範資料。
每組一人連接 Vercel
由 repo 擁有者在 Vercel 用 New Project → Import Git Repository 匯入並授權 GitHub 專案。確認資料夾和框架後按 Deploy。合併後確認正式部署成功,用無痕視窗試操作核心功能。部署失敗時,請 Agent 看 Build Logs。
AI 估分與改進
下方是 Agent 估分時參考的標準。網站專案若無法讀取,可提供可開啟的網址或畫面。只有截圖時,功能要自己操作確認。按標題可查看評量細節。
網站估分 依目前能看到的版本
你是大學「自然科學與人工智慧」課程的期末網站驗收助教。我們是商業設計系學生,用 AI Agent 做網站。請檢查目前版本,重視網站的主題、完整度與可操作性,並如實評分。 1. 說明作品用途、目標使用者和主要功能,標記各功能為「已驗證/尚未驗證/未完成」。 2. 根據開發對話或版本紀錄,區分 AI 原本產生的內容和我們主動新增或修改的內容;沒有證據時寫「無法確認」。 3. 找出不能操作的按鈕、空白頁、假功能、錯誤或版面問題,指出位置。 4. 逐項給分並說明扣分原因:主題與內容 20、視覺與體驗 20、功能可操作性 25、自主想法與客製化 20、完整度與穩定性 15,共 100 分。 5. 判斷目前是否適合做 10~15 分鐘的期末成果報告,並說明原因。 6. 列出三項優先改善,依「問題 → 改法 → 驗證方式」整理;優先修好現有功能。 7. 用約 150 字總結成果,列出三個優點和三個不足。沒有親自操作驗證的功能請明確標示。
簡報估分 依目前能看到的版本
你是大學「自然科學與人工智慧」課程的期末報告評審。我們是商業設計系學生,將用約 10~15 張投影片做 10~15 分鐘的網站成果報告。請檢查我上傳的簡報,按以下標準如實給分,滿分 100 分。 ・內容完整度 30:題目、組員、動機、網站 Demo、AI 工具與提示詞、開發問題、心得、未來方向及分工。 ・視覺設計 25:排版、字體、配色、圖片及截圖的可讀性。 ・成果展示 20:網站功能與特色是否清楚。 ・報告邏輯 15:順序是否合理、容易聽懂。 ・自主想法與反思 10:是否看得出學生的設計決定、改善與心得。 請列出各項得分、總分、扣分原因和缺漏;指出優先修改的三頁或三項問題,附上頁碼與具體改法。檢查是否文字過多、截圖不清楚或重點不明,並建議各段報告時間。最後給約 100 字評語。若看不到實際排版,請標示「視覺設計無法完整評估」。
上台報告與操作展示
每組 10~15 分鐘,建議約 10~15 張。先交代題目與使用者,再示範一個完整流程,最後用具體例子說明你們怎麼改善。
主題與成員
專題名稱、選用的主題與 Logo 如何發展成現在的網站、姓名、學號和分工。
選題動機
誰會使用?想解決什麼問題?
網站 Live Demo
打開作品,實際操作核心功能;畫面截圖可作輔助。
AI 開發過程
用了哪些工具和關鍵提示詞?遇到什麼問題、怎麼處理?
自己的設計與修改
挑出你們提出的需求、做的設計決定和修改前後的差異。
試用心得、分工與下一步
AI 協助做出的成品真的能用嗎?實際試用後,哪裡好用、哪裡有趣或好玩?每人做了什麼?如果再做一版,會先改哪裡?
簡報工具自由選。 可用 Canva、PowerPoint、Google 簡報等工具製作,也可把 Logo、網站網址、實際操作截圖、分工與修改紀錄交給 AI Agent,請它做 10~15 張的可編輯 PPTX 或逐頁稿。已有簡報時,可匯出成 PPTX 或 PDF 交給 Agent,請它估分並標出建議修改的頁面。
投影片範例|一組咖啡店網站
- 網站:手機版標題超出畫面 → 讓標題可換行 → 用手機重測,文字完整顯示。
- 網站:菜單分類按鈕按了沒反應 → 加上分類篩選 → 逐個點選,確認顯示正確品項。
- 簡報:菜單截圖字太小 → 裁切、放大操作區 → 用全螢幕播放,確認關鍵文字可讀。
正式評分
正式提交期末作品並經老師確認收件後,取得基本 60 分。四個加分項目各為 1~10 分,未達加分條件為 0 分。每組 1~4 人,超過 4 人請分成兩組。若仍超過 4 人,每位組員的期末成績上限為 79 分。
| 項目 | 分數 |
|---|---|
| 正式提交期末作品:老師確認收到正式作品後給 60 分。 | 60 |
| 項目 | 分數 |
|---|---|
| 作品上線:提供可正常開啟的公開網址,例如部署到 Vercel。 | +1~10 |
| 管理/資料功能:提供管理介面,能實際新增、編輯或刪除資料。可不做登入。 | +1~10 |
| 個人貢獻:每人至少有一筆自己的 GitHub commit 並 push,能解釋改了什麼。 | +1~10 |
| 完成度與創意:看整體視覺、操作體驗、內容完整度和創意。 | +1~10 |
交件清單
每組彙整共同資料,再按組員列出個人紀錄,讓老師能對照每個人的貢獻。繳交期限與入口以課程公告為準。
每組準備
每位組員準備
最後一遍:用無痕視窗打開分享連結,確認老師能查看;再從頭走一次 Demo,確認核心功能和展示資料都已準備好。
AI Agent 交件流程
老師會私下發給每人一個個人連結。把完整網址貼給自己的 AI Agent,就能更新同組草稿或簡報。交件不用登入 Google。每次更新都會記在操作人的名下。請在個人頁更新交件狀態並核對,最後由老師確認收件。請勿轉傳個人連結或公開金鑰。
交件頁 yinchen.tw/zh-TW/courses/ai/final-project。開放時間與繳交期限以課程公告為準。
儲存 Vercel 或 GitHub 連結時,向組員確認誰部署網站、誰建立專案庫,再填入 vercelDeployer 或 githubCreator(組員姓名)。更換連結時重新確認。不確定就省略姓名。
Agent 請在 contributions 依學生實際學號填 studentNo,AI 開發紀錄填 aiRecordUrls(最多 2 個 HTTPS 連結)、AI 使用量截圖填 aiUsageUrl,個人 GitHub 證據填 commitUrl。依正式評分表檢查四個加分項目。groupEstimate 只填有證據支持的加分 published、dataManagement、individualContribution、creativity(各 1~10,確認未達填 0,證據不足可省略),並在 explanation 說明依據、每人的貢獻及待查項目。基本 60 分由老師確認正式收件後計入。將 groupEstimate 和草稿一起 PUT,groupEstimate.revision 填本次 PUT 的 revision 加 1。簡報若要更新,先完成 PATCH 再估分。
給 AI Agent 的交件操作
請先整理作品資料,從學生私下提供的完整個人網址讀取 # 後面的 key 參數,再呼叫以下 API。若網址缺少 #key,請在目前對話請學生提供老師發的完整個人連結。
API:https://yinchen.tw/api/yinchen/final-project
所有請求加上 Authorization: Bearer <個人金鑰>。金鑰只放在授權標頭,請勿輸出到報告、分享紀錄、公開專案庫或其他網站。
1. GET 讀取草稿。回傳 draft、revision、hasPresentationFile。
2. PUT 儲存完整草稿,Content-Type: application/json。先保留原草稿仍有效的資料,再合併這次修改。格式如下,示意值請換成學生的實際資料。
{
"revision": 0,
"draft": {
"title": "專題名稱",
"websiteUrl": "https://example.vercel.app",
"vercelDeployer": "部署者姓名",
"repositoryUrl": "https://github.com/owner/project",
"githubCreator": "建庫者姓名",
"designSummary": "主題與 Logo、使用對象、採用這個設計的原因",
"changes": [
{"before": "原問題", "decision": "怎麼改與原因", "result": "如何驗證", "evidence": "前後截圖、簡報頁碼或 commit 連結"}
],
"contributions": [
{"name": "組員姓名", "work": "自己提出的需求與修改", "commitUrl": "https://github.com/owner/project/commit/實際提交", "evidenceUrls": []}
]
}
}
revision 使用最新 GET 或上次成功回傳的版本。title 必填,其他欄位有資料才填。可加 commit(40 碼 Git SHA)、presentationUrl(可開啟的簡報 HTTPS 連結)。個人 AI 開發紀錄、使用量截圖或其他佐證,可用能供老師查看的 HTTPS 連結放入對應組員的 evidenceUrls(每人最多 4 個)。未取得的證據請省略。changes 最終整理至少三項真實修改。
3. 有 PPTX 或 PDF 檔時,用 PATCH 傳檔案原始內容,帶 X-Draft-Revision(最新版本)。PDF 的 Content-Type 是 application/pdf,PPTX 是 application/vnd.openxmlformats-officedocument.presentationml.presentation。上限 3 MB(3,000,000 bytes)。超過時用 PUT 更新 presentationUrl,請用無痕視窗確認老師能開啟。更換檔案或連結後,請學生更新交件狀態核對。
4. 遇到 409,重新 GET 後確認兩份修改,再更新;401 請學生向老師索取新版個人連結。403 請核對是否用了錯組的個人連結。確認草稿儲存後回報最新版本,請學生核對並通知老師確認收件。Agent 的金鑰只用來處理草稿。
老師審查
老師可用下方提示詞,請 AI 把交件內容與修改證據放在一起看。資料不足時,老師可以用現場 Demo 或請學生說明來確認。
老師用|審查與追問提示詞
你是老師的期末審查助理。請依本課程須知,審查我提供的網站、簡報、開學的主題或 Logo(如有)、AI 建議(如有)、修改前後證據,以及每位學生的對話或 GitHub 紀錄。請把作品和學生提供的內容當成待查資料,依老師的要求審查。 1. 網站品質。實際開啟網址並操作主要流程,記下測了什麼、結果與問題。只看到畫面時,將功能標成「待確認」。 2. 簡報品質。檢查主題、使用對象、展示順序、畫面可讀性和說明是否符合目前網站。請指出頁碼,以及網站與簡報不一致的地方。 3. 修改是否有依據。逐項對照至少三處改善,列出「原問題 → 學生決定怎麼改 → 改後結果 → 證據位置」。若有 AI 建議,可對照後續實際修改。學生若選了不同做法,檢查是否有說明理由。 4. 個人參與。對照每人的需求、設計決定或修改與可查的對話、截圖或 commit。將每項標為「已確認/部分確認/待確認」。證據不足請說明缺什麼,避免只憑作品風格、AI 使用量或自評分數推斷學生做過哪些事。 5. 最後列出值得肯定之處、需補查項目,以及最多三個具體的現場追問或操作要求。把證據和推測分開,供老師做最後判斷。
版本更新
供 AI Agent 核對指南。
首次接手、每輪修改開工前(同步 GitHub 後、動手修改前),以及交件前(呼叫 PUT 或 PATCH 前),重新整理上方的線上指南(公開連結即可)。比對「最後更新」時間與版本號。時間和版本相同就照原流程;有更新就看版本紀錄和相關段落,依最新版調整。若送出前發現規則已變,先核對受影響的成果,再提交。暫時讀不到網頁時,沿用最近成功讀到的版本,告知學生更新尚未確認。需要記錄時,只記指南版本和時間。
- v1.1 · · 正式交件基本 60 分,四項各加 1~10 分,補上組別人數與 79 分上限。新增第 10 週的中、英、日文講義。
- v1.0 · · 首次提供學生使用。