超快速的多職業工作台構建 Skill
Build a role-centered operational product, not a renamed dashboard shell. Preserve an existing architecture when present. For a new pure-Web build, start from assets/reference-workbench-template/, then replace its education reference domain completely.
開始
- 將請求分類為新建、擴充、重新設計或審計。
- 推斷職業、組織、角色、使用者、工作物件、生命週期、決策、風險、審批、隱私邊界與部署模式。僅在缺少的選擇會實質改變產品時才提問。
- 僅閱讀所需參考文件：
- 對於新建專案，務必閱讀 deployment-modes.md。
- 針對 shell、模組與頁面合約，閱讀 workbench-architecture.md。
- 選擇或合併領域模式時，閱讀 profession-profiles.md。
- 針對 KPI、圖表與分析頁面，閱讀 dashboard-catalog.md。
- 進行視覺、動畫、畫布、導航或響應式設計時，閱讀 design-interaction.md。
- 每當使用者可以建立、編輯、刪除、排列、註解、匯入或附加資料時，閱讀 local-persistence.md。
- 在記錄生成與最終驗收前，閱讀 data-and-validation.md。
- 對於新的離線專案，執行：
python3 scripts/scaffold_professional_workbench.py <target> --profile <profile> --profession "..." --organization-name "..." --role-name "..." --user-name "..." --deployment-mode local-offline
- 將骨架生成視為起點。在所有路由、記錄、工作流程、圖表、控制項、持久化路徑及領域殘留檢查通過之前，不得交付。
建立職業模型
- 定義角色的主要名詞：案件、客戶、病人、專案、候選人、帳戶、內容、資產、實驗、訂單、事故或等效物件。
- 定義生命週期狀態、擁有者、交接、截止期限、決策、異常條件、證據與審批。
- 區分個人工作、團隊操作、共享資源、分析以及管理/合規。
- 保持組織、角色、期間、區域、團隊或投資組合的上下文可視。
- 在導航中使用明確的中文文字標籤；圖示僅用來強化意義。
- 從 profession-profiles.md 中選擇一個設定檔，或合併多個設定檔以應對混合角色。僅保留該真實角色所支援的職責。
構建完整頁面
- 為每個導航項目提供一個完整的頁面，包含標題、上下文、操作、密集的記錄、狀態以及一個獨特的分析儀表板。
- 避免使用佔位符、三列表格、重複的更名卡片、裝飾性圖表及不支援的按鈕。
- 使用確定性且連貫的示範記錄，並標註為模擬資料。
- 包含適當的正常、空白、載入、警告、錯誤、停用、逾期、衝突、審批與確認狀態。
- 記錄密集的頁面應可搜尋、可篩選、可排序，並以分頁或受控滾動為邊界。
- 主要記錄應可直接編輯。建立、更新與刪除必須使用與表格、詳細資料、匯出及儀表板相同的資料來源。
- 日期、範圍、篩選器與區段控制項必須作用於真實記錄。僅視覺效果的控件屬於缺陷。
- 匯出當前篩選結果，並使用穩定的表頭。匯入時驗證格式、列形狀、限制與合併/取代意圖；先預覽，失敗時保持當前資料不變。
- 在列表、詳細資料、工作流程與儀表板頁面之間追蹤主要工作物件。
分配獨特儀表板
- 為每個頁面提供不同的業務問題、KPI 集、圖表組合、診斷、互動方式及顏色變體。
- 時間使用趨勢圖，類別使用長條圖，密度使用熱力圖，流程使用桑基圖，關係使用網路圖，輪廓使用雷達圖或平行座標圖，排程使用甘特圖，分佈使用直方圖或盒鬚圖。
- 每個儀表板由一個主導圖表、3–4 個 KPI、一個次要診斷、一個排名或分區視圖、範圍控制項、工具提示與簡潔的解讀組成。
- 將圖表繫結到相同的可見記錄，並提供可存取的文字摘要。
- 將財務、醫療、法律、安全與合規輸出視為決策支援，絕非自主專業判斷。
套用寧靜奢華 A
- 除非使用者選擇其他視覺方向，否則使用內建的
css/premium-minimal.css作為最終的階層疊加層。 - 保持溫暖的象牙色背景、墨綠色排版、低飽和鼠尾草色強調色、襯線字體顯示標題、無襯線系統字體控制項、精細分割線與充裕的留白。
- 偏好編輯器層級的分層與對齊，而非嵌套圓角卡片與厚重陰影。
- 保持外觀冷靜並以文字標籤為主。使用淺色分析儀表板；僅在空間主視覺或無限畫布中使用深石墨色。
- 保持熱力圖密集但低調，使用五個正方形單元格層級。
- 使用懸停檢查、聚焦、選取、向下鑽取、詳細資訊抽屜、模態框、平移/縮放與漸進式揭露，以釐清狀態。
- 保持動畫短暫、可中斷，並在
prefers-reduced-motion下停用。 - 保留鍵盤存取、可見聚焦、語意化控制項、觸控佈局及列印/報告檢視。
- 將
--workbench-folio、上下文選擇器與主視覺語言調整為新的組織與職業。 - 參考主視覺圖片以文字形式嵌入於
js/hero-media.js中，以便此 Skill 保持與 Red Skill 相容，且生成的網站完全離線。
要求離線優先持久化
- 驗證後，自動將建立、編輯、刪除、重新排序、註解、草稿、偏好設定與佈局變更儲存至當前電腦。
- 在第一次有意義的渲染之前恢復已儲存的狀態。沒有成功寫入的儲存提示屬於缺陷。
- 對於小型 JSON 記錄與草稿，使用內建的
js/local-persistence.js。對於附件、大型集合與離線佇列，使用 IndexedDB。 - 為每個工作台設置命名空間，對儲存的記錄進行版本化管理，並在 schema 變更時加入遷移邏輯。
- 顯示儲存中、已儲存、失敗與配額狀態。絕不靜默地丟棄失敗的寫入。
- 提供版本化的 JSON 匯出、經過驗證的原子化匯入（支援合併/取代語意）、附件管理與已確認的清除。對於任何部分應用的匯入，執行回滾。
- 將示範種子資料與個人記錄分開。不儲存機密，也不聲稱瀏覽器儲存已加密。
- 對於
local-offline，揭露單一裝置與單一瀏覽器的限制。對於team-server或enterprise，使用經過驗證的 API 與伺服器資料庫作為記錄系統；參見 deployment-modes.md。
使用內建實作
參考範本提供純 HTML/CSS/JavaScript，無需 CDN、多區域文字導航、56 個模組入口、密集記錄、寧靜奢華 A、空間主視覺、無限畫布、活動熱力圖、自訂游標、路由動畫、22 種圖表系列、可編輯表格、命名空間化的 localStorage、自動儲存、版本化備份/匯入、對話框、表單、響應式行為與列印樣式。
替換所有參考領域的名稱、導航、記錄、工作流程、KPI、模擬身份與主視覺用語。絕不能僅透過更改標題來交付非教育領域的工作台。
驗證
- 當準備將此 Skill 上傳至 Red Skill 時，執行
python3 scripts/validate_redskill_package.py .。 - 針對生成的工作台，執行
python3 scripts/validate_professional_workbench.py <project-path>。 - 執行原生語法或建置檢查。
- 確認每個導航入口皆對應到一個完整頁面並獲得一個獨特儀表板。
- 驗證記錄密度、跨頁一致性、操作篩選器、表單、詳細資料、工作流程狀態與鍵盤存取。
- 驗證本地資產與
file://行為是否支援離線交付。 - 驗證新增 → 重新載入、編輯 → 重新載入、刪除 → 重新載入、匯出 → 清除 → 匯入、格式錯誤匯入拒絕以及儲存失敗報告。
- 當 Node.js 可用時，執行
node scripts/test_local_persistence.js <project-path>。 - 針對非教育領域的設定檔，要求零教育領域殘留。
- 當瀏覽器介面可用時，進行視覺與互動 QA；絕不能將檔案存在或語法成功等同於視覺驗收。
- 報告路徑、部署模式、職業、角色、模組與儀表板覆蓋率、CRUD/篩選/匯入/匯出結果、持久化結果、驗證結果以及剩餘邊界。
護欄
- 不要推斷對外部寫入、審批、訊息、交易或發佈的權限。
- 不要將模擬記錄呈現為真實資料或暴露敏感識別符。
- 未經專業審查，不要自動化高風險決策。
- 對於離線交付物，不要使用外部 CDN。
- 在選定部署模式的架構、安全與驗收關卡通過之前，保持
production_ready為 false。 - 除非使用者要求或主動的網站建置指示需要託管，否則不要發佈或部署。