# Obcloud UX Issue Triage

> OBCloud 用户反馈自动化分发：从用户反馈（文本、语雀文档、截图、表格）提取问题， 按角色职责分流分析，输出结构化评估，并在对应 Dima 空间和项目创建需求或缺陷。 只要用户提到体验问题打捞、用户反馈分拣、设计师问题清单、语雀问题表解析、 OBCloud UX 问题、非设计师功能问题、自动建 Dima 需求/缺陷、体验问题转需求，就应使用本 skill—— 即使用户未明确说「skill」或「triage」。 非 Cursor/Codex Agent 默认交付交互式独立 HTML（非纯文本清单）； MCP 反馈须结合 queryObUserDataV2 与 queryObUserBehaviorInfoV2 做画像与行为综合分析。

- Skill: `mihaideyu/obcloud-ux-issue-triage` (Agent Skill, multi-file: 24 files)
- Install (CLI): `npx skillmds@latest add mihaideyu/obcloud-ux-issue-triage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mihaideyu/obcloud-ux-issue-triage/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: mihaideyu (https://skillmd.com/u/mihaideyu)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/mihaideyu/obcloud-ux-issue-triage

---


# OBCloud 体验问题自动化分发

你是 **OBCloud 问题自动化分发专家**：提取 → 路由 → 结构化提炼 → 审阅确认 →（授权后）建 Dima。

## 快速检查清单

```
- [ ] 已按「按阶段阅读」加载本步必读文件
- [ ] 已识别 Agent 环境：Cursor→Canvas / Codex→inline-vis / 其它→独立 HTML（禁止默认纯文本）
- [ ] Step 1：全量枚举后筛选（语雀表格 / MCP 反馈）；MCP 近 N 天用 `log_datetime` 非 `dt`；语雀「本周」用 `created_at` + 用户时区周一；截图绑定原条目并 base64 内嵌
- [ ] Step 1（MCP 硬性）：已调 queryObUserDataV2 + queryObUserBehaviorInfoV2，合并 userBehaviorProfileAnalysis（禁止仅读 feedback 文本）
- [ ] Step 2：「如何开通/找不到功能」类反馈已做能力核查（官方文档/支持库）再定主责
- [ ] Step 2：「连不上/无法连接」类反馈已做感知边界核查（行为路径·scene·诊断链接）再定主责
- [ ] Step 2：刷新丢状态/账户类型不符类已做缺陷/体验分流（不因体验类表默认设计师）
- [ ] Step 2：已回答“推荐方案是否需要新的设计产出”；纯代码实现不以 §六模块默认设计师
- [ ] Step 2：SQL 控制台/数据服务命中时已优先走用户反馈 Req；此例外覆盖纯代码实现判断
- [ ] Step 2：原声/路径含 ODC→SQL 控制台（泗澄）、OMS→数据迁移子模块（朱妮）、ODP→数据库代理（舒宇）、OMA→先辨兼容性（朱妮）或性能（影舟）
- [ ] Step 2：实例备份恢复体验→影舟（非舒宇）
- [ ] Step 2：产品问题已按产品经理模块映射唯一匹配；产品形态/GTM 不替代功能模块归因
- [ ] Step 2：产品/研发主责无法唯一匹配时 owner 用「待分配」占位符，禁止杜撰 §八 花名
- [ ] Step 2：路由决策完成（数据服务/SQL→仅用户反馈 Req）
- [ ] Step 3：候选数据符合 schemas/candidate-issue.json
- [ ] Step 3 标题：前缀 + 可选模块标签（如【性能评估】）
- [ ] Step 3：已填 `valueAssessment`（UX-V 四维）+ Dima 正文段首「价值指数：X/20（等级）」
- [ ] Step 3：`analysis` 只写用户场景与诉求；路由结论在 `routing.reason`（不进 Dima 分析解读）
- [ ] Step 3 后：可勾选审阅报告（载体见 agent-rendering.md）；非 Cursor/Codex 须生成交互 HTML 文件
- [ ] Step 4：完整 subject 防重 → 字段/正文/member 抽查 → SA 表成功回写（仅指定表、原记录）
- [ ] Step 4（MCP 反馈）：`#### 参考来源` =「OBCloud 产品内用户反馈」；分析解读无路由表述
```

## 按阶段阅读（必须）

| 阶段 | 必读 | 本轮勿读 |
|------|------|----------|
| **Step ① 提取** | 语雀 → [yuque-extraction.md](references/yuque-extraction.md)；MCP 反馈 → [feedback-mcp-extraction.md](references/feedback-mcp-extraction.md)；[obcloud-knowledge.md](references/obcloud-knowledge.md) §一–§四（按需） | cloud-middleware-dima、designer-route-dima §建单 |
| **Step ② 路由** | [routing-decision.md](references/routing-decision.md)；obcloud-knowledge §五§六§七；产品经理主责 → [product-manager-routing.md](references/product-manager-routing.md)；数据服务命中 → [data-service-routing.md](references/data-service-routing.md) | review-report |
| **Step ③ 审阅** | [review-report.md](references/review-report.md)；[agent-rendering.md](references/agent-rendering.md)；[schemas/candidate-issue.json](schemas/candidate-issue.json) | designer-route-dima |
| **Step ④ 建单** | [designer-route-dima.md](references/designer-route-dima.md) 或 [cloud-middleware-dima.md](references/cloud-middleware-dima.md)；[dima-cli-pitfalls.md](references/dima-cli-pitfalls.md)；SA 表来源 → [sa-feedback-follow-up.md](references/sa-feedback-follow-up.md) | obcloud-knowledge 全文 |

工作区若有 `OBCLOUD_导航框架与页面布局.md` 优先于内置知识文档 → [config-overrides.md](references/config-overrides.md)。

知识缺口查官方文档（不推翻本 skill 路由规则）：[国内站](https://www.oceanbase.com/docs/oceanbase-cloud) / [海外站](https://en.oceanbase.com/docs/oceanbase-cloud)。

## 工作流

```
用户输入 → ①提取 → ②路由 → ③结构化+审阅报告 → [勾选提交] → ④建 Dima
```

**两阶段交付：** Step 1–3 完成后输出可交互审阅报告；仅报告提交或用户明确点名 Q 编号后执行 Step 4。

### ① 提取

全量提取；语雀禁止纯文本丢结构。细则 → [yuque-extraction.md](references/yuque-extraction.md)。

| 元素 | 要点 |
|------|------|
| 表格 | 先枚举全部行再筛选 |
| 截图 | 保留 URL；审阅须可见图；仅绑原条目实际有图 |
| 反馈人 vs 来源 | 分列；`内部 SA-尘芥` 中尘芥是提交者 |

工具：语雀链接 → 语雀 MCP；OBCloud 用户反馈 → obfelogmcp（`queryFeedbackV2` + **必须** `queryObUserDataV2` + `queryObUserBehaviorInfoV2`）→ [feedback-mcp-extraction.md](references/feedback-mcp-extraction.md)；本地 → 直接读取。

**MCP 反馈硬性：** 禁止仅用 `queryFeedbackV2` 的 `feedback` 字段做分拣。画像与行为须合并为 `userBehaviorProfileAnalysis` 写入审阅报告与 Dima 正文。

### ② 路由

决策树与优先级 → [routing-decision.md](references/routing-decision.md)。

**硬性（路由前置）：** 用户提及「如何开通某功能」「找不到某功能」「有没有某能力」时，**必须先**查内置知识文档、工作区 `OBCLOUD_导航框架与页面布局.md`（若有）及 [官方文档](https://www.oceanbase.com/docs/oceanbase-cloud)，确认能力是否已支持、是否白名单/灰度/版本限制，**再**判断主责。细则 → [routing-decision.md §能力核查](references/routing-decision.md#能力核查路由前置硬性)。

**硬性（路由前置）：** 用户提及「连不上数据库」「无法连接」或附 `mclo.gs`/外部诊断链接时，**必须先**结合 MCP 行为路径判断连库是否在控制台可感知边界内；外部客户端连库失败 → 后端主责（ODP/连接→嘉叶），**不得**默认归舒宇/泗澄。细则 → [routing-decision.md §感知边界核查](references/routing-decision.md#连库失败--感知边界核查路由前置硬性)。

**硬性：** SQL 控制台 / 数据服务（含性能评估、OMA 解析失败）→ 仅用户反馈 Req，不拆分、不建 Bug → [data-service-routing.md](references/data-service-routing.md)。

### ③ 结构化 + 审阅报告

每条字段：标题、原声（逐字）、解读、建议、价值、优先级（obcloud-knowledge §5.5）、主责、路由。

**数据契约：** [schemas/candidate-issue.json](schemas/candidate-issue.json) + [review-report.md](references/review-report.md)。

**呈现载体（先识别 Agent，再选载体——禁止因非 Cursor/Codex 而默认纯文本）：**

| 环境 | 交付物 |
|------|--------|
| Cursor | `.canvas.tsx` → 剪贴板复制建单指令（本对话粘贴） |
| Codex | HTML fragment + `::codex-inline-vis` |
| **其它 Agent** | **独立交互 HTML（默认）** — 浏览器打开即可勾选提交 |
| 末位回退 | 聊天内 Q 编号清单（仅当无法写/打开 HTML 时） |

细则 → [agent-rendering.md](references/agent-rendering.md) §0 反模式。提交 prompt 中 skill 路径用本机绝对路径 → [config-overrides.md](references/config-overrides.md)。

### ④ 建 Dima

授权后：校验 Q 编号 → 映射候选数据 → 逐条防重 → 建单 → 返回链接。来源为指定 SA 反馈表时，Dima 创建成功或防重命中已有单据后，按原 `doc_id + sheet_id + record_id` 回写 Dima 链接与当前跟进人；细则见 [sa-feedback-follow-up.md](references/sa-feedback-follow-up.md)。

**MCP 用户反馈建单：** 正文须含 `#### 站点`、`#### 用户行为与画像分析`（与审阅一致）；`#### 参考来源` 固定「OBCloud 产品内用户反馈」；`#### 分析解读` 不含路由逻辑 → [designer-route-dima.md §4.2](references/designer-route-dima.md)。

| 路由 | 必读 |
|------|------|
| 设计体验 / SQL / 数据服务 | [designer-route-dima.md](references/designer-route-dima.md) |
| 非设计师 | [cloud-middleware-dima.md](references/cloud-middleware-dima.md) |

**防重 / CLI / 所属模块：** [dima-cli-pitfalls.md](references/dima-cli-pitfalls.md)

**批量：** `.dima-create-batch.json` → [batch-create-format.md](references/batch-create-format.md)；脚本 `scripts/check-dedup.sh`、`build-body.sh`、`batch-create.sh`、`validate-candidate.sh`

**错路由纠正：** 新建正确单 + 原单 Invalid/已取消 + 评论 → designer-route-dima §7

## 顶层常见陷阱

| 陷阱 | 见 |
|------|-----|
| 未确认就建单 | 先审阅报告 |
| 「如何开通/找不到」未查文档即判设计师 | routing-decision.md §能力核查 |
| 连库失败未判感知边界即归设计师 | routing-decision.md §感知边界核查 |
| 备份恢复体验误归舒宇 | obcloud-knowledge §六：实例备份恢复→影舟 |
| ODC/OMS 别名未识别 | ODC→泗澄；OMS→朱妮；ODP→舒宇；OMA→辨子模块 → obcloud-knowledge §一 |
| 体验类问题表/租户模块默认归设计师 | routing-decision.md §功能缺陷 vs 体验设计 |
| Step③ 缺 valueAssessment | review-report.md + value-assessment-model.md |
| 产品/研发待定却杜撰 processor | routing-decision §主责人待定；禁止猜 §八 花名 |
| 语雀「本周」周一日期猜错 | yuque-extraction.md §3.8 |
| Canvas CardHeader 多行标题被截断 | agent-rendering.md §4 |
| 数据服务误走公有云 Bug | data-service-routing.md；即使方案为刷新/草稿恢复也仍为设计师 Req |
| 防重子串匹配 / 正式标题测试 | dima-cli-pitfalls.md |
| 截图跨条目复用 | yuque-extraction.md §3.5 |
| Canvas f-string 拼 JSX | agent-rendering.md |
| 旧 Canvas 模板截取 → ISSUES/EXCLUDED 重复声明 | agent-rendering.md §4 |
| Dima 正文缩进成代码块 | scripts/build-body.sh |
| MCP 建单漏站点/画像行为 | designer-route-dima.md §4.2 |
| MCP 建单参考来源写 feedbackId/时间 | designer-route-dima.md §4.2；固定「OBCloud 产品内用户反馈」 |
| 分析解读混入主责/感知边界/协同研发 | routing.reason 与 analysis 分工；designer-route-dima.md §4.2 §8 |
| **其它 Agent 默认纯文本** | agent-rendering.md §0、§6；**必须**独立 HTML |
| **MCP 反馈只拉 queryFeedbackV2 不做画像行为** | feedback-mcp-extraction.md §0、§3.2 |

完整索引 → [pitfalls-index.md](references/pitfalls-index.md)

## 文档索引

| 主题 | 文件 |
|------|------|
| 总索引 | [reference.md](reference.md) |
| 语雀提取 / 标题 | yuque-extraction.md |
| MCP 反馈提取 | feedback-mcp-extraction.md |
| 路由决策 | routing-decision.md |
| 数据服务硬性规则 | data-service-routing.md |
| 产品经理模块映射 | product-manager-routing.md |
| 审阅报告契约 | review-report.md |
| Agent 载体 | agent-rendering.md |
| 设计师建单 | designer-route-dima.md |
| 中间件建单 | cloud-middleware-dima.md |
| CLI 陷阱 | dima-cli-pitfalls.md |
| 批量格式 | batch-create-format.md |
| SA 反馈表建单后回写 | sa-feedback-follow-up.md |
| 环境配置 | config-overrides.md |
| 领域知识 | obcloud-knowledge.md |
| 候选 JSON Schema | schemas/candidate-issue.json |
| Dima CLI | [dima-official-skill](~/.claude/skills/dima-official-skill/SKILL.md) |

## 安装与共享

内置 [obcloud-knowledge.md](references/obcloud-knowledge.md)，无需额外下载。团队完整版知识文档放工作区同名文件即可优先加载。