维表智联项目管理

概述

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

适用产品：

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

执行前必读

• ✅ 当前技能负责项目内业务资源落地，不负责完整系统方案拆解；系统级需求先用 dimens-system-orchestrator。
• ✅ SDK、HTTP、Web、BFF、Node.js 接入问题先用 dimens-sdk。
• ✅ 用户提到 sdk.ai.*、response.data、模型下拉、图片不显示、视频任务轮询、Provider 或 Vite 代理时，属于开发者接入问题；直接路由到 dimens-sdk/references/ai-examples.md 与 dimens-sdk/references/capability-status.md。
• ✅ Windows 下生成或修改中文文件时，必须遵守 ../windows-utf8.md：用 UTF-8 写入，禁止 cmd echo / 默认重定向写中文正文，写完读回确认没有 ??。
• ✅ 每次准备使用 dimens-cli 前，必须先在当前终端执行 npm -g install @bintel/dimens-cli@latest 升级全局 CLI；升级成功后再执行 dimens-cli --version 或 dimens-cli --help 确认可用，确保用户每次使用的都是最新版本。
• ✅ 创建工作表和字段时必须使用 --custom-id <suffix>（MCP 使用 customId）指定自定义 ID 后缀；缺少后缀时 CLI/MCP 必须在本地拒绝请求，不得让后端回退随机 ID。最终 ID 始终由后端按 projectId_suffix 生成，CLI/技能不得自行拼接或提交最终 sheetId/fieldId。
• ✅ sheet create 的目录、文档、报表、画布等非工作表资源不使用 customId；只有 type=sheet（或未指定类型而按工作表处理）强制要求后缀。
• ✅ 当前后端在缺少 customId 时仍会调用随机 ID 生成器（工作表 generateId('sheet')、字段 generateId('field')）；这是后端兼容默认，不是 CLI 期望路径，调用侧必须先拦截。
• ✅ 自定义字段 ID 只在当前 sheetId 内校验唯一；不同工作表可以使用相同字段后缀。遇到 RESOURCE_ID_CONFLICT 时更换后缀，不要误判为项目或团队全局冲突。
• ✅ 自定义 ID 创建成功后，必须用 sheet info 或 column list 回查服务端返回的真实 sheetId/fieldId；不要把团队 ID 当作 ID 前缀。
• ✅ 项目内查询、创建、更新、上传、验证等操作优先推荐并执行 dimens-cli 命令；自定义 URL 只作为上下文解析或 CLI 未覆盖时的补充路径，不作为首选解决方案。
• ✅ 表、字段、视图、行、字典等资源操作强制通过 dimens-cli 完成。复杂字段配置、选项树和批量数据先生成并校验 JSON，再使用 --options、--config、--values 或 --file 提交；禁止阅读 CLI 源码后生成 Python/Node/HTTP 脚本替代命令。Python 仅可用于明确授权的外部数据清洗，不能直接写入维表。
• ✅ 执行任何写操作前先确认认证、teamId、projectId 与资源归属。
• ✅ 当用户消息或当前页面携带维表 URL 时，先解析 URL 上下文。格式 http://localhost:3000/#/{teamId}/{projectId}/{sheetId}；例如 http://localhost:3000/#/TTFFEN/PM394YD/sh_lTyerp8gwW8QSVD1 表示 teamId=TTFFEN、projectId=PM394YD、sheetId=sh_lTyerp8gwW8QSVD1。用户说“当前页面/当前表/这个表”时优先使用这些 ID。
• ✅ 更新类操作统一遵循“先读取当前数据 -> 修改目标字段 -> 再提交更新”。
• ✅ 项目资源默认按“三驾马车”理解：表格、文档、报表。
• ✅ 报表创建当前走项目菜单 sheet/create type=report；返回的 reportId 等于 sheetId。
• ✅ 用户只给自然语言目标时，先把目标归类到业务域，再给 CLI 步骤；不要直接编造不存在的命令或字段。
• ✅ 如果上下文、权限或资源 ID 缺失，先列出缺口和最小补齐命令，再继续执行或给方案。
• ✅ 用户涉及 richtext 富文本字段或 json 字段时，必须读取 references/table/references/richtext-json-fields.md；这两类字段必须走专用命令，不能按普通文档或普通单元格处理。
• ✅ 设计 select / multiSelect 时，先判断选项是否会跨多个表、字段或流程复用；单一位置即使要求唯一也直接使用普通下拉，只有明确复用才创建项目数据字典。字典编码规则与命令详见 references/table/project-dictionary.md。
• ✅ 字段内置选项 id 和项目字典选项 value 优先使用选项名称对应的英文语义编码（如 active、maintenance、offline），不要默认生成 1、2、3 这类纯数字编码；创建字段时跳过维表自带的创建人、创建时间、更新人、更新时间系统字段，不重复生成同名业务字段。

职责边界

快速路由表

默认处理顺序

1. 识别用户目标：查询、创建、更新、排查、导入、生成画布或验证。
2. 只要后续会执行或给出 dimens-cli 命令，先验证是否是最新版本，如果不是则升级。
3. 先看 references/key-auth/overview.md，确认认证方式。
4. 再看 references/team/overview.md，明确 teamId / projectId / baseUrl。
   • 如果用户给了 /#/{teamId}/{projectId}/{sheetId} 页面 URL，直接从 URL 得到 teamId/projectId/sheetId，只补查缺失或需要校验的部分。
5. 项目容器问题看 references/project/overview.md。
6. 数据模型问题看 references/table/overview.md。
   • 涉及 richtext 或 json 字段时继续读取 references/table/references/richtext-json-fields.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. 任何创建表或字段的方案都必须先给出 JSON 数据契约，再给出对应 dimens-cli 命令和回查命令；不能把脚本执行当作资源创建步骤。

输出契约

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

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

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

高风险跑偏点

• 不要把 dimens-manager 当成系统级需求分析器。
• 不要在 dimens-manager 内推断 sdk.ai.* 的方法签名、response.data 层级、前端 Provider 或 Vite 实现；这类问题转到 dimens-sdk，manager 只保留 teamId/projectId、资源归属和业务验收边界。
• 不要在 Windows 下用 echo 中文 > file、未指定编码的 Out-File 或默认重定向写中文文件；这会导致中文变成 ??。
• 不要把 API Key 当成独立权限体系；Key 登录后仍继承绑定用户权限。
• 不要脱离团队和项目上下文处理表格、权限、工作流、报表。
• 不要在用户已经给出维表页面 URL 时继续笼统追问当前团队、项目或表；先解析 URL，缺哪一段只追问哪一段。
• 不要把人员/部门字段粗暴退化成普通下拉字段。
• 不要用 doc update 写富文本字段；富文本正文是 HTML，必须使用 richtext-field save。
• 不要用 row set-cell、row create 或 row update 写 JSON 字段；必须区分 inline/extended 后使用 json-field save。
• 不要跳过报表预检链直接创建复杂图表。
• 不要把业务工作流画布直接等同于可执行工作流；可执行链路仍要回到工作流章节。
• 不要把 AI 生成的审批流程文字等同于已发布审批工作流；必须补齐图草案、项目挂载、workflow 字段入口和审批运行验证。
• 不要为审批流编造节点类型；AI 自动审批放在 approval 节点配置里，项目表回写用已存在的 mul_update_row，不要生成 action、sync_workflow_cell 或 approval_ai_review。
• 不要只生成 id/type/label 空节点；每个审批节点都要按 approval-node-parameters.md 补齐必填参数。
• 不要只看 CLI 命令执行成功就判断权限生效；还要关注缓存失效、权限快照和前端刷新。

常见错误与修正

干跑测试样本

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

• 项目内资源创建和回查。
• 权限或团队上下文缺失时的补齐路径。
• 报表、工作流、画布这类需要预检或版本回查的复杂链路。
• 富文本与 JSON 专用字段的创建、首次保存、读取、二次更新和错误命令拦截。

参考文档

• ../windows-utf8.md
• README.md
• references/key-auth/overview.md
• references/team/overview.md
• references/project/overview.md
• references/table/overview.md
• references/table/project-dictionary.md
• references/table/references/richtext-json-fields.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