维表智联业务管理技能（dimens-manager）

适用产品：

• 产品名称：维表智联
• 开发方：方块智联工作室
• 官网：https://dimens.bintelai.com/

执行前必读

• ✅ 当前技能负责项目内业务资源落地，不负责完整系统方案拆解；系统级需求先用 dimens-system-orchestrator。
• ✅ SDK、HTTP、Web、BFF、Node.js 接入问题先用 dimens-sdk。
• ✅ Windows 下生成或修改中文文件时，必须遵守 ../windows-utf8.md：用 UTF-8 写入，禁止 cmd echo / 默认重定向写中文正文，写完读回确认没有 ??。
• ✅ 每次准备使用 dimens-cli 前，必须先在当前终端执行 npm -g install @bintel/dimens-cli@latest 升级全局 CLI；升级成功后再执行 dimens-cli --version 或 dimens-cli --help 确认可用，确保用户每次使用的都是最新版本。
• ✅ 项目内查询、创建、更新、上传、验证等操作优先推荐并执行 dimens-cli 命令；自定义 URL 只作为上下文解析或 CLI 未覆盖时的补充路径，不作为首选解决方案。
• ✅ 执行任何写操作前先确认认证、teamId、projectId 与资源归属。
• ✅ 更新类操作统一遵循“先读取当前数据 -> 修改目标字段 -> 再提交更新”。
• ✅ 项目资源默认按“三驾马车”理解：表格、文档、报表。
• ✅ 报表创建当前走项目菜单 sheet/create type=report；返回的 reportId 等于 sheetId。
• ✅ 用户只给自然语言目标时，先把目标归类到业务域，再给 CLI 步骤；不要直接编造不存在的命令或字段。
• ✅ 如果上下文、权限或资源 ID 缺失，先列出缺口和最小补齐命令，再继续执行或给方案。
• ✅ 创建项目内资源时，不能只看命令返回 success；目录必须 sheet tree 回查，表格必须逐表 column list 获取真实 fieldId，行数据必须写后 row page 验证 data 非空，报表必须跑 preview / query-widget / query。
• ✅ sheet create --folder-id 当前不能作为最终归位证据；创建后如果 parentId 为空、菜单树不在目标目录或目录为空，立即用 sheet move --folder-id 修正并再次 sheet tree。
• ✅ 字段 ID 是表级独立生成的系统 ID；同名字段在不同表也不能复用。行数据 JSON 只能使用目标表 column list 返回的真实 fieldId。

职责边界

快速路由表

默认处理顺序

1. 识别用户目标：查询、创建、更新、排查、导入、生成画布或验证。
2. 只要后续会执行或给出 dimens-cli 命令，先验证是否是最新版本，如果不是则升级。
3. 先看 references/key-auth/overview.md，确认认证方式。
4. 再看 references/team/overview.md，明确 teamId / projectId / baseUrl。
5. 项目容器问题看 references/project/overview.md。
6. 数据模型问题看 references/table/overview.md。
7. 访问控制问题看 references/permission/overview.md。
8. 自动化和 AI 流程问题看 references/workflow/overview.md。
• 审批工作流 AI 自动生成必须继续看 references/workflow/references/approval-generation.md。
• 审批工作流节点类型必须继续对照 references/workflow/references/approval-existing-cases.md，不能生成不存在的节点。
• 审批工作流节点参数必须继续看 references/workflow/references/approval-node-parameters.md，不能只输出空节点。
9. 统计分析和看板问题看 references/report/overview.md。
10. 画布、白板、流程图、PPT 画布和 AI 一键生成画布看 references/canvas/overview.md。
11. 输出前按“CLI 已升级、命令链、必要参数、验证命令、风险点”检查一遍。
12. 如果是项目初始化或批量建表，最后必须执行一次全量验收：sheet tree 确认无空目录，逐表 column list 确认字段，逐表 row page 确认非空数据，逐报表 query-widget/query 确认可出数。

输出契约

处理项目内业务资源时，默认输出下面 4 类信息：

1. 目标域：命中哪个章节，例如表格、权限、报表、画布。
2. 前置条件：认证状态、teamId/projectId、资源 ID、权限要求。
3. 执行链路：优先给 dimens-cli 命令；更新类必须体现“先读再改再更”。
4. 验证链路：给出回查命令和通过标准；权限、报表、画布不能只看创建成功。

如果用户要求直接执行，但缺少必要上下文，先输出缺口和补齐命令，不要假装已经完成。

高风险跑偏点

• 不要把 dimens-manager 当成系统级需求分析器。
• 不要在 Windows 下用 echo 中文 > file、未指定编码的 Out-File 或默认重定向写中文文件；这会导致中文变成 ??。
• 不要把 API Key 当成独立权限体系；Key 登录后仍继承绑定用户权限。
• 不要脱离团队和项目上下文处理表格、权限、工作流、报表。
• 不要把人员/部门字段粗暴退化成普通下拉字段。
• 不要跳过报表预检链直接创建复杂图表。
• 不要把业务工作流画布直接等同于可执行工作流；可执行链路仍要回到工作流章节。
• 不要把 AI 生成的审批流程文字等同于已发布审批工作流；必须补齐图草案、项目挂载、workflow 字段入口和审批运行验证。
• 不要为审批流编造节点类型；AI 自动审批放在 approval 节点配置里，项目表回写用已存在的 mul_update_row，不要生成 action、sync_workflow_cell 或 approval_ai_review。
• 不要只生成 id/type/label 空节点；每个审批节点都要按 approval-node-parameters.md 补齐必填参数。
• 不要只看 CLI 命令执行成功就判断权限生效；还要关注缓存失效、权限快照和前端刷新。
• 不要只看 sheet create --folder-id 就判断资源已进入目录；必须 sheet tree 回查，必要时 sheet move。
• 不要复用其它表的 fieldId 写入当前表；row batch-create 即使返回成功，也可能因为字段 ID 错误导致业务 data 为空。
• 不要把空目录、空表、行 data:{}、空报表留到用户反馈后再修；这些都属于执行阶段必须主动发现的问题。

常见错误与修正

干跑测试样本

维护本技能时使用 test-prompts.json 做 dry-run 复测，至少覆盖：

• 项目内资源创建和回查。
• 权限或团队上下文缺失时的补齐路径。
• 报表、工作流、画布这类需要预检或版本回查的复杂链路。

参考文档

• ../windows-utf8.md
• README.md
• references/key-auth/overview.md
• references/team/overview.md
• references/project/overview.md
• references/table/overview.md
• references/permission/overview.md
• references/workflow/overview.md
• references/workflow/references/approval-generation.md
• references/workflow/references/approval-existing-cases.md
• references/workflow/references/approval-node-parameters.md
• references/report/overview.md
• references/canvas/overview.md