自然科學與人工智慧

期末專題指南

115 學年度第 1 學期|商業設計系

AI AGENT VIBE CODING

有任何問題、操作上的困難,或對課程與這份說明的建議,都歡迎隨時跟老師反映。本頁也會依同學的需求與實際使用情況持續調整,請以最新內容為準。

主題不限。用 AI Agent 做一個自己或別人用得到的網站,例如個人網站、作品集、商業分析、市場調研、商品展示、偶像介紹、遊戲或生活小工具。可以沿用開學時的主題和 Logo,也可以重新想一個。報告時分享為什麼想做、實際用起來怎麼樣,以及自己覺得哪裡有趣。

把你的點子做成有自己特色的作品 不用先學會進階技術。用自己的話告訴 AI Agent 你想做什麼,請它先做一版。自己試用,再把想改的地方說清楚,直到作品符合你的想法。

10~15 分鐘每組上台時間
約 10~15 張建議投影片張數

第 10 週期末報告講義(PDF)

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 可在任何階段提出改善建議。

學生製作與修改Agent 依須知評量

網站作品

  1. 學生用 AI Agent做網站初版

    定題、分工,先讓核心功能能操作。

  2. Agent 自評網站估分與建議

    隨時請 Agent 看目前版本,找出優先改善的問題。

  3. 學生用 AI Agent修改並自己測

    修正問題,實際操作確認,留下修改前後的差異。

  4. 學生驗證確認修改成果

    操作新版網站,留下可以核對的改善證據。

報告投影片(PPT)

  1. 學生製作或請 AI 協作產出投影片初稿

    可用 Canva、PowerPoint 等工具製作,或把素材交給 AI 做 PPTX 或逐頁稿。

  2. Agent 自評簡報估分與建議

    隨時請 Agent 看目前簡報,指出值得調整的頁面。

  3. 學生修改,可用 AI 協作改簡報並試講

    調整內容、排版與時間,留足現場操作時間。

  4. 學生驗證核對新版簡報

    確認內容符合網站,保留改過的頁面或試講紀錄。

從開工到交件一路保留:每人留下自己的 AI Agent 對話與 GitHub 紀錄,最後整理繳交。
把至少三處實際改善和證據放進簡報最後 1~2 張,再排練 Demo。

想知道目前做得如何,隨時可以問。 AI 的估分供改進參考,正式成績由老師評定。

GitHub 協作與 Vercel 部署

每組共用一個 公開 GitHub 專案庫(Public repo) 和一個 Vercel 網址。每人用自己的 GitHub 帳號留下貢獻,由專案庫擁有者負責部署。單人組自行完成。

第一次加入專案

  1. 每人登入 GitHub。 在 Antigravity 請 Agent 檢查 Git 和提交姓名、Email。本人依提示完成 gh auth login 的瀏覽器授權,Agent 核對帳號。提交 Email 可用 GitHub 提供的 noreply 地址。
  2. 一人建庫、放初版、邀請。 建立 Public repo,將可執行的初版推到 main。到 Settings → Collaborators 邀請組員,分享 repo 網址和啟動方式。
  3. 其他人接受邀請,再 clone。 請 Agent 用 git clone 把共用 repo 複製到本機並試跑。之後在 Antigravity 開啟同一資料夾即可。

每輪修改由 Agent 協助同步與提交

預設由可操作本機專案和終端機的 Agent 代做。學生要求先看結果、暫緩提交或想自己操作時,依學生指示。

  1. 改之前,拿到最新版本。 檢查 repo、分支、本人提交身分與本機改動。保留未提交的工作,從最新版主分支建立個人分支。已有個人分支時,先同步它在 GitHub 的版本,再整合最新主分支。
  2. 遇到衝突,先嘗試修好。 能確定兩邊修改可以並存時,自行合併並重測受影響功能。遇到兩種設計或功能互斥、可能覆蓋別人的改動,或測試失敗且修不好時,保留雙方工作,說明差異、建議與需要決定的地方,暫停推送。禁止強制推送、丟棄或覆蓋未確認的改動。
  3. 改完並驗證後,自動存到 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。

Antigravity 授權 ・ GitHub 登入 ・ Vercel 匯入

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 字評語。若看不到實際排版,請標示「視覺設計無法完整評估」。
每位組員交 1~2 段代表性的 AI Agent 開發對話。選能看出自己提出需求、和 AI 討論、修改或除錯的段落。優先交唯讀分享連結,無法分享可匯出 PDF/Markdown。另附個人 GitHub commit/push 證據與 AI 使用量截圖;用量只供參考。共同討論可用,但每人要指出自己的貢獻。分享前移除密碼、API Key、個資與無關對話。提供可讀的專題紀錄即可,不用交帳號或登入權限。

上台報告與操作展示

每組 10~15 分鐘,建議約 10~15 張。先交代題目與使用者,再示範一個完整流程,最後用具體例子說明你們怎麼改善。

  1. 主題與成員

    專題名稱、選用的主題與 Logo 如何發展成現在的網站、姓名、學號和分工。

  2. 選題動機

    誰會使用?想解決什麼問題?

  3. 網站 Live Demo

    打開作品,實際操作核心功能;畫面截圖可作輔助。

  4. AI 開發過程

    用了哪些工具和關鍵提示詞?遇到什麼問題、怎麼處理?

  5. 自己的設計與修改

    挑出你們提出的需求、做的設計決定和修改前後的差異。

  6. 試用心得、分工與下一步

    AI 協助做出的成品真的能用嗎?實際試用後,哪裡好用、哪裡有趣或好玩?每人做了什麼?如果再做一版,會先改哪裡?

簡報工具自由選。 可用 Canva、PowerPoint、Google 簡報等工具製作,也可把 Logo、網站網址、實際操作截圖、分工與修改紀錄交給 AI Agent,請它做 10~15 張的可編輯 PPTX 或逐頁稿。已有簡報時,可匯出成 PPTX 或 PDF 交給 Agent,請它估分並標出建議修改的頁面。

最後 1~2 張放「實際改善紀錄」。整理至少三處實際改善。每項都交代「原本的問題 → 改了什麼 → 怎麼確認」。

投影片範例|一組咖啡店網站

  1. 網站:手機版標題超出畫面 → 讓標題可換行 → 用手機重測,文字完整顯示。
  2. 網站:菜單分類按鈕按了沒反應 → 加上分類篩選 → 逐個點選,確認顯示正確品項。
  3. 簡報:菜單截圖字太小 → 裁切、放大操作區 → 用全螢幕播放,確認關鍵文字可讀。

正式評分

正式提交期末作品並經老師確認收件後,取得基本 60 分。四個加分項目各為 1~10 分,未達加分條件為 0 分。每組 1~4 人,超過 4 人請分成兩組。若仍超過 4 人,每位組員的期末成績上限為 79 分。

60 + 10 + 10 + 10 + 10正式評分滿分 100 分
基本作品
項目分數
正式提交期末作品:老師確認收到正式作品後給 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 前),重新整理上方的線上指南(公開連結即可)。比對「最後更新」時間與版本號。時間和版本相同就照原流程;有更新就看版本紀錄和相關段落,依最新版調整。若送出前發現規則已變,先核對受影響的成果,再提交。暫時讀不到網頁時,沿用最近成功讀到的版本,告知學生更新尚未確認。需要記錄時,只記指南版本和時間。

  1. v1.1 · · 正式交件基本 60 分,四項各加 1~10 分,補上組別人數與 79 分上限。新增第 10 週的中、英、日文講義。
  2. v1.0 · · 首次提供學生使用。