用途：定义 Multica 后端中 mention 链接的实际行为，说明该不该提及由运行环境说明决定，本文只讲“提及会做什么”。
链接格式：@Label。解析器只接受 member、agent、squad、issue 四种 type 加 all 哨兵；id 组只接受十六进制字符与短横线，或字面量 all。
各类型行为：agent（uuid 来自 agent.id）会为该 agent 入队一次运行；squad（squad.id）解析其 leader_id 并为 leader agent 入队；member（member.user_id）仅渲染链接，不入队；issue（issue.id）仅渲染链接，始终安全。project 类型不在解析器内，仅作可导航链接，永不触发运行。
用法：名字不是 UUID，先用命令查询——成员用 multica workspace member list --output json 取 user_id；agent 用 multica agent list --output json 取 id；squad 用 multica squad list --output json 取 id。名字歧义或缺失时不要猜测，直接在评论里说明。
@all：@all，面向 issue 所有人，不触发特定 agent，并抑制 assignee 的自动 on-comment 触发及其他隐式路由；同一评论中的显式 @agent/@squad 仍正常触发。
预览与抑制：可用 POST /api/issues/{id}/comments/trigger-preview 预览触发；创建或编辑评论可传 suppress_agent_ids 后置过滤。
不会发生的情况：名字代替 UUID 的链接静默失效；格式正确但无人拥有的 UUID 解析后在查找阶段以 invocation_not_allowed 阻止；非 UUID 的 id 以 target_unavailable 阻止；目标已有待处理任务时合并或延迟而非重复运行；已归档或无运行时的 agent 被阻止。以上均不返回错误响应，结果只在 trigger_outcomes 中体现。能力门禁为 canInvokeAgent，可见不等于可提及。
限制：member 提及是否真正送达通知在 Go 评论处理器中没有对应代码路径，资料未证实。