board-setup

看板设置

创建并配置 monday.com 看板，搭建合适的结构，包括正确的列类型、有意义的分组和初始条目。在 monday.com 中，看板是团队追踪各种工作流的核心工作区，例如项目交付、销售流程、Bug 分类、内容制作、活动规划等。此技能提供所需的领域知识，帮助你构建井然有序且符合团队实际工作方式的看板。

工作流

步骤 1：了解需求

开始创建前，先向用户确认：

1. 要追踪什么？（任务、项目、Bug、潜在客户、请求、活动等）
2. 工作会经历哪些阶段？（例如：待办 > 进行中 > 审核 > 已完成）
3. 每个条目需要哪些信息？（负责人、截止日期、优先级、状态、预算等）
4. 有多少人会使用这个看板？

如果用户只提出了“创建一个项目看板”之类的简短请求，请根据使用场景采用合理的默认设置，并在创建前确认结构。

步骤 2：设计看板结构

根据需求，规划：

• 看板名称——清晰且具有描述性
• 分组——代表工作流阶段、类别或时间段
• 列——每个条目的数据字段（请参阅下文的“列类型选择”）

第 3 步：创建看板

强烈建议：使用一次调用，通过 creationPrompt 创建看板。 create_board 接受自由文本 creationPrompt，monday 会据此设计分组、列和标签。这比逐次调用来构建结构更快、更可靠，也能避免冗长的构建序列在中途调用失败后留下不完整的看板和重复的列。除非用户需要提示词无法表达的精确结构，否则每次创建新看板都应使用它。

调用 create_board 并提供：

• boardName：描述性名称

• boardKind："public"（所有团队成员均可见）或 "private"（仅订阅者可见）

• workspaceId（如果用户指定了文件夹，还需提供 folderId）

• creationPrompt：将第 2 步的设计用通俗语言描述出来——看板追踪的内容、工作流阶段、每个项目所需的字段（包括 Priority、Stage 等字段的标签集），以及任何初始项目。不要在提示词中加入自动化——不会根据提示词创建自动化。之后使用 create_automation 逐一添加，并通过 list_automations 验证。例如：

  为移动团队创建一个错误追踪看板。错误依次经过 New、Triaged、In Progress、Fixed、Verified。每个错误都需要指定负责人、严重程度（Low、Medium、High、Critical）、截止日期、重现步骤和受影响的平台（iOS、Android、Web）。初始项目：Android 上的登录按钮无响应、上传照片时崩溃。

返回结果后，请根据设计核对看板——creationPrompt 虽然大部分情况下准确，但并非万无一失。 调用 get_board_info、get_board_items_page（设置 includeColumns: true）和 list_automations，然后检查：

1. 分组顺序和 top_group。 分组可能会乱序返回，像 “Done” 这样的终结分组可能会排在最上方——新项目会添加到 top_group。使用 update_group 调整顺序（参见第 4 步中的 relative_position_before），将工作流的第一阶段置顶。
2. 列类型。 字段返回的类型可能不正确（例如，网站字段返回为 text，而不是 link）。使用 create_column 添加正确类型的列，复制所有值，并告知用户可以删除旧列。
3. 标签。 修正错误或缺失的标签集（参见“更改现有状态列上的标签”）。
4. 初始项目。 检查所要求的每个值——有些值可能为空。通过一次 update_items 调用补齐缺失内容。
5. 未请求的自动化。 create_board 可能会添加用户未要求的自动化，例如 monday AI 在下拉菜单上添加的“分类”规则。这类规则会在每个新项目上运行，并消耗 AI 积分。告知用户添加了哪些内容，并询问是否要关闭；可以使用 manage_automations 停用工作流，但有些自动化无法通过 API 修改——请引导用户前往看板的 Automations 面板操作。
6. Name 列的标题——如果设计要求，请将其重命名为 “Deal”、“Account” 等。

仅使用第 4–6 步补齐缺失内容。不要重建看板。用一句话告知用户你修正了什么。

如果 create_board 失败或超时，不要立即再次调用——看板可能已经创建。先使用 search 搜索看板名称，只有确认看板不存在时才重试；再次发送请求会创建重复看板。

不使用 creationPrompt 时，你会得到一个空看板；请按第 4–6 步构建看板。

第 4 步：创建分组

如果 creationPrompt 已经创建了所需的分组，请跳过此步骤。

为每个工作流阶段或类别调用 create_group。

将新分组放在默认分组上方。 新建的 monday 看板会附带一个名为 “Group Title”（ID 为 topics）的默认空分组。若要将工作流分组按正确顺序放在看板顶部，请在每次调用 create_group 时传入 positionRelativeMethod: "before_at" 和 relativeTo: "topics"。按工作流顺序创建分组（第一个创建的分组会成为看板上的第一个分组，也是 top_group——新项目默认会添加到此分组）。

最后清理默认分组。 创建好工作流分组后，默认的 topics 分组就成了多余的空分组，会让用户感到困惑。调用 all_monday_api 并使用 delete_group mutation 删除它：mutation { delete_group(board_id: <id>, group_id: "topics") { id } }。如果跳过此步骤，看板底部会留下一个游离的空分组。

使用 all_monday_api 通过 update_group mutation 重命名或重新排序分组（没有 change_group_title mutation，而且 update_group 需要选择集，否则会失败）：

• 重命名：mutation { update_group(board_id: <id>, group_id: "<group_id>", group_attribute: title, new_value: "New name") { id title } }
• 移到另一个分组上方：group_attribute: relative_position_before, new_value: "<other_group_id>"（或 relative_position_after），并选择 { id position }。

也可以将默认的 topics 分组重命名为第一个工作流分组，而不删除它。

create_group 只接受其 groupColor 枚举中列出的精确十六进制值；相近的色调会被拒绝。

常见的分组模式：

按工作流阶段划分（最常见）：

• “待办”、“进行中”、“审核中”、“已完成”

按优先级划分：

• “紧急”、“高优先级”、“中优先级”、“低优先级”

按时间段划分：

• “本周”、“下周”、“待办事项”

按团队／部门划分：

• “工程”、“设计”、“产品”、“QA”

按类别划分：

• “Bug”、“功能”、“改进”、“技术债务”

第 5 步：添加列

如果使用了 creationPrompt，只添加 get_board_info 显示缺少的列。否则，请为每个数据字段调用 create_column。每列需指定：

• boardId：第 3 步中的看板 ID
• title：显示名称
• columnType：monday.com 列类型（参见下文“列类型选择”）
• columnSettings：列需要自定义标签时，使用 JSON 字符串化的标签配置（参见下文“状态列的自定义标签”）

按以下顺序添加列（从左到右排列在看板上）：

1. 状态列（工作流状态）
2. 人员列（负责人／受指派人）
3. 日期或时间线列（截止日期／持续时间）
4. 优先级列（如有需要）
5. 其他数据列（文本、数字、链接等）

重命名名称（第一）列。 update_column 会拒绝更改 name 列的标题（“Name columns can only be updated with the width parameter”）。请改用 all_monday_api：mutation { change_column_title(board_id: <id>, column_id: "name", title: "Task") { id title } }。可以用这种方式将其标记为“交易”、“Bug”、“请求”等，以匹配模板。

状态列的自定义标签

未设置 columnSettings 的 status 列始终使用 monday 的默认标签：“Working on it”（橙色）、“Done”（绿色）、“Stuck”（红色）。这对于主要工作流的 Status 列来说没问题，但对于模板需要的其他状态列则不合适——Priority、Severity、Stage 和 Risk 最终都会使用令人困惑的默认标签，除非在创建时传入自定义标签。

将 columnSettings 作为 JSON 字符串传入，格式如下：

{"labels": [{"label": "<name>", "color": "<color_token>", "index": <0..n>}, ...]}

每个条目都需要 label、color 和 index（其他字段为可选）。color 标记是 monday 的 StatusColumnColors 枚举中的字符串。各类别的常用标记：

• 平和／较低：sky、bright_blue、aquamarine、saladish
• 中等／进行中：working_orange、egg_yolk、purple
• 较高／警告：dark_orange、sunset、lipstick
• 严重／受阻：stuck_red、dark_red、bright_green（仅用于“approved”）
• 完成／成功：done_green、grass_green

以下模板中使用的参考标签集：

• Priority： [{"label":"Low","color":"sky","index":0},{"label":"Medium","color":"working_orange","index":1},{"label":"High","color":"dark_orange","index":2},{"label":"Critical","color":"stuck_red","index":3}]
• Severity： 与 Priority 相同。
• Pipeline stage（CRM）： 标签集应与命名分组（Lead、Qualified、Proposal、Negotiation、Closed Won、Closed Lost）一致，以便项目状态与分组保持同步。
• Risk： [{"label":"Low","color":"saladish","index":0},{"label":"Medium","color":"egg_yolk","index":1},{"label":"High","color":"dark_orange","index":2}]

如果用户请求的状态列含义并非工作流（如“Priority”“Severity”“Risk”“Stage”“Health”“Confidence”等），则默认使用 Low／Medium／High／Critical 等级，除非用户指定所需标签。说明所用的默认值，以便用户可以覆盖。

对于主要工作流的 Status 列，不要设置 columnSettings——默认值符合大多数用户的预期。

格式和颜色。 发送扁平的 {"labels": [...]} 对象。get_column_type_info 显示的架构包含在 settings 键中——不要照搬这个包装层：create_column 可以接受，但 update_column 会拒绝。color 必须是上述列表中的标记（或其数值）；#00c875 这类十六进制代码会被拒绝。

**如果使用自定义标签的 create_column 返回 INTERNAL_SERVER_ERROR，**不要重复发送相同的负载。先创建不带 columnSettings 的列，然后使用 update_column 设置标签（如下所述）。

更改现有状态列的标签

update_column 会替换列的整个标签列表：

1. 调用 get_board_info，并为该列设置 filters.columns.ids，以获取其 revision 和当前的 settings.labels。
2. 发送所有要保留的标签，每个标签都带上现有的 id、label、color 和 index。省略的标签会被删除。
3. 添加新标签时不要带 id——随意编造的 ID 会被拒绝（“Label ids: 5 do not exist”）。新标签可以重复使用已被占用的颜色。
4. 后续更新使用响应中的新 revision。

不支持更改现有标签的颜色：调用会报告成功，但颜色不会改变。要更改颜色，请告知用户在 monday 的列标签编辑器中操作。

步骤 6：创建初始项目（可选）

如果用户提供了初始项目，且看板上还没有这些项目，则应在一次 create_items 调用中创建它们（每次最多 20 个），而不是为每个项目分别调用一次 create_item。请遵循任务管理技能中的列值格式规则。

第 7 步：展示结果

用通俗的语言报告创建了什么，不要叙述 API 调用。包含 MCP 工具返回的直接 URL。

总结创建的内容：

已创建看板：[Board Name]

• URL：[看板 URL]
• 类型：[公开/私有]

分组：

1. 待办
2. 进行中
3. 审核中
4. 已完成

列：

列	类型	用途
状态	状态	工作流状态
负责人	人员	项目负责人
截止日期	日期	截止时间
优先级	状态	重要程度
备注	文本	补充背景

然后建议 2-3 个合理的后续步骤：

• “要我添加一些初始项目以便开始吗？”
• “要我邀请团队成员加入这个看板吗？”
• “要我创建一个仪表板来跟踪这个项目吗？”
• “要我设置一个用于收集请求的表单吗？”

列类型选择

选择合适的列类型至关重要。如果需要状态列时使用文本列，就会失去筛选、分组和自动化功能。

完整的列类型参考，请参阅 references/column-types-guide.md。

常见需求的快速选择指南：

你的需求	列类型	为什么不选文本？
工作流状态（待办、进行中、已完成）	status	支持颜色标记、按状态筛选和自动化
负责人	people	关联 monday.com 用户，并支持工作量视图
截止日期	date	支持日历视图、时间线视图和逾期检测
日期范围（开始到结束）	timeline	在时间线视图中显示时长条
重要程度	status（标签为“优先级”）	支持颜色标记、筛选和排序
工作量估算	numbers	支持求和、平均值和公式计算
类别标签	dropdown	从预定义选项中多选
是/否标记	checkbox	可视化切换，支持筛选
自由格式备注	text	简单的文本输入
长描述	long_text	支持格式设置的富文本
文件附件	file	可直接上传和预览文件
网页链接	link	显示可点击的 URL 和文本
电子邮件地址	email	可点击的 mailto 链接
电话号码	phone	可点击的 tel 链接
预算/成本	numbers	支持货币格式和公式
评分	rating	以 1-5 星直观显示评分
进度	progress	根据子项目或关联列显示可视化进度条

了解计划层级

大多数列类型适用于所有 monday 计划。有两种列类型受到计划限制，技能应妥善处理：

• Formula 列——仅限 Pro 和 Enterprise 计划。如果用户使用 Free / Basic / Standard 计划并要求创建公式列（例如：“我想创建一列，根据数量和价格计算总成本”），请说明该功能受计划限制，并建议以下替代方案之一：
  • 使用 numbers 列，由用户手动更新
  • 使用 text 列，将用户从其他位置复制粘贴的计算结果填入其中
  • 改为在文档/仪表板技能的输出中添加公式计算
• 看板级别的 AI / 自动化功能——部分功能受计划限制。使用 create_automation 创建自动化，每次调用设置一个触发器；然后使用 list_automations 逐一读取，确认触发器和条件与请求一致。如果因计划或试用限制导致调用被拒绝，请说明自动化需要付费计划，并引导用户前往看板的 Automations 面板。

如果用户不确定自己的计划，请先使用标准列创建看板，并提出可在其计划支持时稍后添加公式列。

按使用场景划分的看板模板

项目跟踪器

• **分组：**待办、进行中、审核中、已完成
• **列：**状态、负责人（人员）、截止日期（日期）、优先级（状态，自定义标签：低/中/高/紧急）、备注（文本）

错误跟踪

• 分组： 新建、已分类、进行中、已修复、已验证
• 列： 状态、负责人（人员）、严重程度（状态，自定义标签：低/中/高/严重）、截止日期（日期）、复现步骤（long_text）、环境（下拉菜单）

销售/CRM 管道

• 分组： 线索、已确认、提案、谈判、赢单、丢单
• 列： 阶段（状态，自定义标签与分组名称对应：线索/已确认/提案/谈判/赢单/丢单）、负责人（人员）、公司（文本）、交易金额（数字）、成交日期（日期）、来源（下拉菜单）

内容日历

• 分组： 创意、制作中、审核中、已发布
• 列： 状态、作者（人员）、发布日期（日期）、内容类型（下拉菜单）、渠道（下拉菜单）、链接（链接）

活动策划

• 分组： 策划、后勤、营销、活动当天、活动后
• 列： 状态、负责人（人员）、时间线（时间线）、预算（数字）、优先级（状态）、备注（文本）

Sprint 看板

• 分组： 待办事项、当前 Sprint、进行中、已完成
• 列： 状态、负责人（人员）、故事点（数字）、Sprint（下拉菜单）、截止日期（日期）、类型（状态）

请求/受理

• 分组： 新请求、审核中、已批准、进行中、已完成
• 列： 状态、请求者（人员）、指派对象（人员）、优先级（状态）、截止日期（日期）、请求类型（下拉菜单）、描述（long_text）

错误预防与补救

• 如果 create_board 因权限问题失败，建议使用用户拥有管理员权限的现有工作区，或询问用户想使用哪个工作区。
• 如果列类型被拒绝（例如，非 Pro 方案不支持公式），请说明方案限制，并建议使用其他列类型。
• 创建前检测名称冲突。 monday 允许在同一工作区中创建两个同名看板，这会造成使用上的困扰。调用 create_board 前，先使用请求的看板名称，在目标工作区范围内调用 search。如果已存在同名看板，请询问用户是使用现有看板、添加后缀创建（例如“看板名称 (2)”，还是选择其他名称。跳过此检查并创建重复看板属于失败。
• 如果 columnSettings JSON 格式错误，create_column 会返回错误。标签格式要求使用由 {label, color, index} 对象组成的数组，而不是名称到颜色的映射表。请参阅上文“状态列的自定义标签”。
• 已保存视图中的日期筛选条件（create_view_table / update_view_table）与项目筛选条件接受的值不同。使用 between 搭配两个纯 YYYY-MM-DD 日期；使用 greater_than / lower_than 搭配 "TODAY"；或使用 within_the_next / within_the_last 搭配 ["DAYS", 7]。视图中不接受 any_of 搭配 ["EXACT", "<date>"]，即使 get_column_type_info 指南中列出了这种用法也不行——该指南适用于 get_board_items_page 筛选条件。

使用的工具

• search — 在 create_board 之前预检看板名称是否冲突，并检查失败的 create_board 是否仍然创建了看板
• get_column_type_info — 了解可用的列类型及其架构（包括状态列的 columnSettings 结构）
• create_board — 创建看板；最好使用 creationPrompt，让 monday 一次调用就构建好结构
• create_group — 向看板添加分组
• create_column — 添加类型正确且配置了自定义 columnSettings 的列，用于 Priority / Severity / Stage / Risk 等
• update_column — 更改现有状态列中的标签（完整标签列表、现有 ID）
• get_board_info — 在调用 update_column 之前读取列的 revision 和当前标签
• create_items — 一次调用即可添加初始项目（可选）
• create_view_table — 创建带筛选条件的已保存表格视图（可选）
• get_board_items_page — 检查 creationPrompt 后初始项目的值
• update_items — 填充生成的看板中仍为空白的初始项目值
• create_automation — 看板创建后，为每项请求添加自动化
• list_automations — 验证新建的自动化，并找出 create_board 添加的未请求自动化
• manage_automations — 停用未请求或错误的自动化
• all_monday_api — 删除默认的 topics 分组、重命名或重新排序分组（update_group），以及重命名 Name 列（change_column_title）

其他资源

• references/column-types-guide.md — monday.com 所有列类型的完整指南，介绍每种类型的用途和配置选项