📚 教學流程 Skills 缺口分析報告

根據 15 號框架 + 今日工作總結 | 由貞分析

備課 教學中 教學後 Kit 打包 學生環境

📊 執行摘要

3
需新建 Skills
1
需升級 Skill
2
非 Skill 工作項

💡 核心設計原則(15 號框架)

🎯 主公只做判斷

  • 構想對錯 → 主公說一句話
  • 交哪個 docx → 主公說一句話
  • 部署批准 → 主公說一句話
  • 其餘全部由技能執行

🔒 三重審核把關

  • Step 2:審核 ideatorich 構想
  • Step 4:審核 merge-docx 結果
  • Step 6:預覽後批准部署

💡 延伸原則:學員同樣只需做關鍵判斷,其餘由 Skills 執行。三小時交付簡單不出錯,學生回去打磨專案不容易出錯。

🔄 教學全流程 + Skills 對應

備課
ideatorich merge-docx content-studio aiworkforme-update
教學中
torecord course-progress(待升級) learn-tracker(新建)
教學後
aiworkforme-update delivery-check(新建) learn-report(新建)

🔍 Skills 缺口分析

階段 功能需求 狀態 說明
備課 構想收集與整理 ✅ 已有 ideatorich v2.0 已實現雙軌輸出
構想合併進主課程 ✅ 已有 merge-docx v2.0 已實現
Kit 自動打包 ⚡ 新建 一鍵將 Starter Kit + 最新課程打包為 ZIP
教學中 學員進度追蹤 🔄 升級 course-progress → learn-tracker,加入學習記錄功能
學生環境一鍵部署 ⚡ 新建 自動配置 Token + 首次部署驗證
學員內容管理 ✅ 已有 tomemo + aiworkforme-update
教學後 交付物自動審核 ⚡ 新建 檢查學生網站是否正確部署、內容是否完整
學習報告生成 ⚡ 新建 根據學員使用記錄生成個人學習報告

⚡ 需新建 Skills(3項)

1. starter-kit-pack(Kit 自動打包)

用途:一鍵將 Starter Kit + 最新課程 docx 打包為 ZIP,供學員下載

觸發方式 「執行 starter-kit-pack」
自動化動作 1. 複製 aiworkforme-starter-kit-3hr/ 模板
2. 更新 .workbuddy/skills/ 為最新版本
3. 嵌入最新 aiworkforme.docx
4. 生成 ZIP 並計算 SHA256
5. 生成交付清單(manifest.json)
審核點 主公確認 manifest.json 內容正確後,批准發布
產出 aiworkforme-kit-v{日期}.zip + manifest.json

2. delivery-check(交付物自動審核)

用途:自動檢查學員部署的網站是否符合交付標準

觸發方式 「執行 delivery-check [學員網址]」
自動化動作 1. 抓取學員網站 HTML
2. 檢查必備元素(標題、內容區塊、部署時間)
3. 比對與標準模板的差異
4. 生成審核報告(合格/需修改/不合格)
審核點 主公查看報告,決定是否批准結業
產出 delivery-check-report.html(可直接分享給學員)

3. learn-report(學習報告生成)

用途:根據學員的 workbuddy 使用記錄,生成個人化學習報告

觸發方式 「執行 learn-report [學員名稱]」
自動化動作 1. 讀取學員的 memory/ 工作日誌
2. 統計使用的 Skills 種類與頻率
3. 分析學習曲線(從第一天到現在)
4. 比對標準三小時課程的完成度
5. 生成個人學習報告
審核點 主公審核後,可直接發給學員
產出 learn-report-{學員名}-{日期}.html

🔄 需升級 Skill(1項)

course-progress → learn-tracker

現有功能:追蹤 AiWorkForMe 課程學習進度與模塊完成狀態

升級方向:加入「學員操作記錄」功能,自動寫入學員的 memory/ 目錄

新增功能 1. 每次執行 Skill 後自動記錄到學員日誌
2. 追蹤學員第一個網站部署時間
3. 記錄學員修改過的檔案
4. 生成學習時間軸視覺化
與現有 Skills 整合 torecord、readrecord、aiworkforme-update

📦 非 Skill 工作項(2項)

1. 學生電腦環境初始化腳本

這是個 PowerShell 腳本,不是 Skill,用於教室環境快速初始化

檔案 student-init.ps1
功能 1. 檢測 PowerShell 版本
2. 配置環境變數(CF_API_TOKEN)
3. 初始化 .workbuddy/ 目錄
4. 執行 env-setup
5. 顯示驗證結果
部署方式 放在 Kit ZIP 的根目錄,學員雙擊執行

2. 交付清單範本(manifest.json)

用途:每個 Kit 附带的元數據文件,方便主公追蹤版本

{
  "version": "1.0.0",
  "date": "2026-04-09",
  "includes": {
    "skills": "all (32)",
    "starter_docx": "aiworkforme.docx",
    "modules": 5,
    "practice_projects": 3
  },
  "checksum": "sha256:xxxxx",
  "instructor_notes": "授課提示..."
}

🔗 完整自動化工作流

┌─────────────────────────────────────────────────────────────────────────────┐
│                              主公備課階段                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│  ideatorich → merge-docx → content-studio → aiworkforme-update             │
│       ↓              ↓              ↓              ↓                       │
│  構想收集      合併進主課程     預覽確認        部署上線                    │
└─────────────────────────────────────────────────────────────────────────────┘
                                    ↓
┌─────────────────────────────────────────────────────────────────────────────┐
│                              Kit 打包階段                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│  starter-kit-pack → 生成 aiworkforme-kit-v{日期}.zip + manifest.json        │
│       ↓                                                                       │
│  主公審核 manifest → 批准發布                                                 │
└─────────────────────────────────────────────────────────────────────────────┘
                                    ↓
┌─────────────────────────────────────────────────────────────────────────────┐
│                              學員上課階段                                     │
├─────────────────────────────────────────────────────────────────────────────┤
│  student-init.ps1 → 環境初始化                                                │
│       ↓                                                                       │
│  student-install → 首次部署驗證(learn-tracker 記錄)                         │
│       ↓                                                                       │
│  學員實作 → torecord/aiworkforme-update → learn-tracker 自動記錄             │
│       ↓                                                                       │
│  delivery-check → 自動審核交付物                                              │
│       ↓                                                                       │
│  主公審核報告 → 批准結業                                                      │
└─────────────────────────────────────────────────────────────────────────────┘
                                    ↓
┌─────────────────────────────────────────────────────────────────────────────┐
│                              結業後階段                                       │
├─────────────────────────────────────────────────────────────────────────────┤
│  learn-report → 生成個人學習報告                                              │
│       ↓                                                                       │
│  主公發送報告給學員                                                           │
└─────────────────────────────────────────────────────────────────────────────┘