build-professional-workbench

超快速的多职业工作台构建 Skill

构建以角色为中心的运营产品，而不是换了名称的仪表盘外壳。存在现有架构时，应予以保留。对于全新的纯 Web 构建，请从 assets/reference-workbench-template/ 开始，然后彻底替换其中的教育参考领域。

开始

1. 将请求归类为新建、扩展、重新设计或审计。
2. 推断职业、组织、角色、用户、工作对象、生命周期、决策、风险、审批、隐私边界和部署模式。仅在缺失选项会实质性改变产品时提问。
3. 只阅读所需的参考资料：
   • 新建项目时，始终阅读 deployment-modes.md。
   • 对于外壳、模块和页面规范，阅读 workbench-architecture.md。
   • 阅读 profession-profiles.md，以选择或组合领域模式。
   • 对于 KPI、图表和分析页面，阅读 dashboard-catalog.md。
   • 对于视觉设计、动效、画布、导航或响应式工作，阅读 design-interaction.md。
   • 只要用户可以创建、编辑、删除、排列、批注、导入或附加数据，就阅读 local-persistence.md。
   • 生成记录和进行最终验收前，阅读 data-and-validation.md。
4. 对于新的离线项目，运行：

python3 scripts/scaffold_professional_workbench.py <target> --profile <profile> --profession "..." --organization-name "..." --role-name "..." --user-name "..." --deployment-mode local-offline

5. 将脚手架视为起点。只有在所有路由、记录、工作流、图表、控件、持久化路径和领域残留检查都通过后，才能交付。

建模职业

• 定义该角色的主要名词：案件、客户、患者、项目、候选人、账户、内容、资产、实验、订单、事件或同类对象。
• 定义生命周期状态、负责人、交接、截止日期、决策、异常情况、证据和审批。
• 区分个人工作、团队运营、共享资源、分析和管理/合规。
• 清晰呈现组织、角色、周期、区域、团队或业务组合背景。
• 在导航中使用明确的中文文本标签；图标仅用于辅助表达含义。
• 从 profession-profiles.md 中选择一种职业画像，或为混合角色组合多种画像。只保留真实角色所支持的职责。

构建完整页面

• 为每个导航项构建完整页面，包含标题、背景信息、操作、丰富的记录、状态和一个独特的分析仪表盘。
• 避免占位内容、仅有三行的表格、反复改名的卡片、装饰性图表和不受支持的按钮。
• 使用确定且连贯的演示记录，并标注为模拟数据。
• 提供适当的正常、空、加载、警告、错误、禁用、逾期、冲突、审批和确认状态。
• 记录密集型页面应支持搜索、筛选、排序，并通过分页或受控滚动限制内容范围。
• 允许直接编辑主要记录。创建、更新和删除操作必须写入同一数据源，并供表格、详情、导出和仪表盘使用。
• 日期、范围、筛选和分段控件必须对真实记录生效。仅具视觉效果的控件属于缺陷。
• 导出当前筛选后的记录，并使用稳定的表头。导入时应验证格式、行结构、数量限制以及合并/替换意图；先预览，失败时保持当前数据不变。
• 在列表、详情、工作流和仪表盘页面中追踪主要工作对象。

分配不同的仪表板

• 为每个页面设置不同的业务问题、KPI 组合、图表组合、诊断分析、交互方式和配色变体。
• 时间数据使用趋势图，类别数据使用条形图，密度数据使用热力图，流向使用桑基图，关系使用网络图，画像使用雷达图或平行坐标图，日程使用甘特图，分布使用直方图或箱线图。
• 每个仪表板由一个主图表、3–4 个 KPI、一个辅助诊断、一种排名或分段视图、范围控件、工具提示和简洁的解读组成。
• 将图表绑定到同一批可见记录，并提供易于访问的文本摘要。
• 对财务、医疗、法律、安全和合规输出，只能将其视为决策支持，绝不能视为自主的专业判断。

应用 Quiet Luxury A

• 除非用户选择其他视觉方向，否则将内置的 css/premium-minimal.css 用作最终级联层。
• 使用暖象牙色背景、墨绿色排版、低饱和度鼠尾草绿点缀、衬线展示标题、系统无衬线控件、细分隔线和宽敞留白。
• 优先采用编辑式层级和对齐布局，避免嵌套的圆角卡片和厚重阴影。
• 保持整体界面平和且带有文字标签。使用浅色分析仪表板；深石墨色仅用于空间主视觉或无限画布。
• 热力图保持密集但低调，使用五种方形单元格等级。
• 在有助于清晰呈现状态时，使用悬停查看、焦点、选择、下钻、详情抽屉、模态框、平移/缩放和渐进式披露。
• 动效应简短、可中断，并在 prefers-reduced-motion 下禁用。
• 保留键盘访问、可见焦点、语义化控件、触控布局以及打印/报告视图。
• 根据新的组织和职业调整 --workbench-folio、上下文选择器和主视觉文案。
• 参考主视觉图片以文本形式嵌入 js/hero-media.js，这样 Skill 仍兼容 Red Skill，生成的网站也能完全离线运行。

要求本地优先持久化

• 验证后，自动将创建、编辑、删除、重新排序、批注、草稿、偏好设置和布局变更保存到当前计算机。
• 在首次有意义的渲染前恢复已保存的状态。显示保存提示但未成功写入，属于缺陷。
• 小型 JSON 记录和草稿使用内置的 js/local-persistence.js。附件、大型集合和离线队列使用 IndexedDB。
• 为每个工作台单独设置命名空间，为存储记录添加版本，并在架构变更时添加迁移。
• 显示正在保存、已保存、失败和配额状态。绝不静默丢弃写入失败的数据。
• 提供带版本号的 JSON 导出、经过验证的原子导入（支持合并/替换语义）、附件管理和经确认的清除操作。回滚任何部分应用的导入。
• 将演示种子数据与个人记录分开。不要存储机密，也不要声称浏览器存储经过加密。
• 对于 local-offline，说明其仅限单设备和单浏览器。对于 team-server 或 enterprise，使用经身份验证的 API，并以服务器数据库作为事实来源；参见 deployment-modes.md。

使用内置实现

参考模板提供纯 HTML/CSS/JavaScript，不使用 CDN，包含多区域文本导航、56 个模块条目、密集记录、Quiet Luxury A、空间主视觉、无限画布、活动热力图、自定义光标、路由动效、22 种图表类型、可编辑表格、带命名空间的 localStorage、自动保存、带版本号的备份/导入、对话框、表单、响应式行为和打印样式。

替换所有参考领域名称、导航、记录、工作流、KPI、模拟身份和主视觉文案。绝不要只改标题，就发布一个非教育类工作台。

验证

1. 准备将此 Skill 上传至 Red Skill 时，运行 python3 scripts/validate_redskill_package.py .。
2. 对生成的工作台运行 python3 scripts/validate_professional_workbench.py <project-path>。
3. 运行原生语法或构建检查。
4. 验证每个导航项都能跳转到完整页面，并显示独立的仪表板。
5. 验证记录密度、跨页面一致性、操作筛选器、表单、详情、工作流状态和键盘访问。
6. 验证本地资源和离线交付时的 file:// 行为。
7. 验证添加 → 重新加载、编辑 → 重新加载、删除 → 重新加载、导出 → 清除 → 导入、拒绝格式错误的导入以及存储故障报告。
8. 如果可以使用 Node.js，运行 node scripts/test_local_persistence.js <project-path>。
9. 对于非教育类配置文件，要求彻底清除教育领域的残留内容。
10. 浏览器环境可用时，执行视觉和交互 QA；绝不能将文件存在或语法检查通过等同于视觉验收。
11. 报告路径、部署模式、职业、角色、模块和仪表板覆盖情况、CRUD／筛选／导入／导出结果、持久化结果、验证情况及剩余限制。

护栏

• 不得推断对外部写入、审批、消息、交易或发布拥有授权。
• 不得将模拟记录呈现为真实数据，也不得暴露敏感标识符。
• 未经专业人员审核，不得自动化高风险决策。
• 离线交付物不得使用外部 CDN。
• 在所选部署模式通过架构、安全和验收关卡之前，保持 production_ready 为 false。
• 除非用户提出请求，或当前的网站构建说明要求托管，否则不得发布或部署。