Community寫作與編輯github.com

steffen74/預設知識邊界

定義課程中學習者可被預設的知識與能力邊界,用於撰寫或審查學員指示、任務、設定步驟與測驗,以及當學習者卡住時判斷落差所在。

預設知識邊界 是什麼?

此技能為「預設知識邊界」規則,適用於任何需撰寫或審查學員面向內容的開發者或 AI 代理人。它幫助你明確界定在課程的每個時間點,學習者可以被合理預期知道哪些概念、擁有哪些資源、已完成哪些動作,以及東西位於何處。當學員卡住、提問或做出猜測時,此規則會指引你判斷問題是來自於一個合理的「邊界違規」(即學習者本應具備卻沒有的東西),還是課程設計本身的「脫節」(即步驟超出了學習者當前的邊界)。技能強調所有步驟的依賴項都必須有清晰的來源記錄,且邊界只透過已教授的材料或已執行的指示來擴展。它支援透過 YAML 設定檔(如 `boundary.yaml`)維護邊界,並與 `course-checks` 驗證工具整合,在課堂中出現重複問題或整組學員卡住時自動觸發檢查。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steffen74/agentic-course-creation/tree/HEAD/skills/assumed-knowledge

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

預設知識邊界 是做什麼的?

邊界是指學習者在課程的某個時間點可以被預期知道、擁有以及能夠做到的事情。Canvas 的 Block 6 記錄了課程開始時的邊界;每個單元的教材則會擴展它。學習者被要求進行的每個步驟,都必須落在該時間點的邊界內。如果步驟落在邊界之外,就是一個脫節:學習者會卡住、用猜的、或者求助。

邊界涵蓋的範圍

不只是概念。脫節常常來自於:

  • 他們擁有的東西:帳號、訂閱、已安裝的軟體、管理員權限、自己的筆電、自己的儲存庫。
  • 他們做過的事情:執行 clone、fork、uv sync、加入聊天室、接受邀請。
  • 東西在哪裡:哪個儲存庫、哪個資料夾、哪個連結。「你自己的範本儲存庫複製品(clone)」這句話,就假設他們已經做了一個。
  • 慣例:什麼是命令提示字元、在筆記本中「執行」是什麼意思、/command 表示要在代理人中輸入。

規則

  • 邊界是由講師決定的。當不確定某個東西是否可以預期時,請詢問,不要自行決定。
  • 某項知識只有在教材在該知識被使用之前就已經教過,或者要求學習者按照可跟隨的指示來完成時,才算成為已知。同一單元的影片只有在影片出現在該任務之前,才算數。
  • 工具(代理人、設定腳本)代學習者執行某個動作,只有在該步驟中明確告知學習者要使用該工具,並給出確切的提示或指令時,才算數。
  • 步驟所依賴的每個成品都必須有來源:一個建立它的步驟,或一個指向其所在位置的連結。
  • 選修的教材永遠不會擴展邊界。
  • 當兩個角色(personas)的邊界不同時,邊界應以能力較弱的那一方為準,除非 Block 6 明確排除它們。

典型的脫節

  • 指示中提到某個物件(儲存庫、檔案、聊天室、帳號),但建立該物件的步驟缺失或只是暗示。
  • 兩份頁面對同一個步驟命名了不同的儲存庫或資料夾。
  • 某個指令只能在特定資料夾中執行,但頁面卻沒有說明是哪個資料夾。
  • 步驟依賴的工具在某個方案中免費,在另一個方案中則需付費,但頁面假設使用的是付費方案。
  • 某個任務需要一個安排在後續單元才教授的觀念。

課堂中的紅旗

多位學習者問了相同的問題;學習者等待講師指示才敢開始;某個小組的作業整組缺失。遇到這些情況,應一律視為邊界違規,直到證明並非如此為止,並載入 course-checks 將其轉為檢查項目。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能