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;MCP 反馈 → feedback-mcp-extraction.md;obcloud-knowledge.md §一–§四(按需) | cloud-middleware-dima、designer-route-dima §建单 |
| Step ② 路由 | routing-decision.md;obcloud-knowledge §五§六§七;产品经理主责 → product-manager-routing.md;数据服务命中 → data-service-routing.md | review-report |
| Step ③ 审阅 | review-report.md;agent-rendering.md;schemas/candidate-issue.json | designer-route-dima |
| Step ④ 建单 | designer-route-dima.md 或 cloud-middleware-dima.md;dima-cli-pitfalls.md;SA 表来源 → sa-feedback-follow-up.md | obcloud-knowledge 全文 |
工作区若有 OBCLOUD_导航框架与页面布局.md 优先于内置知识文档 → config-overrides.md。
知识缺口查官方文档(不推翻本 skill 路由规则):国内站 / 海外站。
工作流
用户输入 → ①提取 → ②路由 → ③结构化+审阅报告 → [勾选提交] → ④建 Dima
两阶段交付: Step 1–3 完成后输出可交互审阅报告;仅报告提交或用户明确点名 Q 编号后执行 Step 4。
① 提取
全量提取;语雀禁止纯文本丢结构。细则 → yuque-extraction.md。
| 元素 | 要点 |
|---|---|
| 表格 | 先枚举全部行再筛选 |
| 截图 | 保留 URL;审阅须可见图;仅绑原条目实际有图 |
| 反馈人 vs 来源 | 分列;内部 SA-尘芥 中尘芥是提交者 |
工具:语雀链接 → 语雀 MCP;OBCloud 用户反馈 → obfelogmcp(queryFeedbackV2 + 必须 queryObUserDataV2 + queryObUserBehaviorInfoV2)→ feedback-mcp-extraction.md;本地 → 直接读取。
MCP 反馈硬性: 禁止仅用 queryFeedbackV2 的 feedback 字段做分拣。画像与行为须合并为 userBehaviorProfileAnalysis 写入审阅报告与 Dima 正文。
② 路由
决策树与优先级 → routing-decision.md。
硬性(路由前置): 用户提及「如何开通某功能」「找不到某功能」「有没有某能力」时,必须先查内置知识文档、工作区 OBCLOUD_导航框架与页面布局.md(若有)及 官方文档,确认能力是否已支持、是否白名单/灰度/版本限制,再判断主责。细则 → routing-decision.md §能力核查。
硬性(路由前置): 用户提及「连不上数据库」「无法连接」或附 mclo.gs/外部诊断链接时,必须先结合 MCP 行为路径判断连库是否在控制台可感知边界内;外部客户端连库失败 → 后端主责(ODP/连接→嘉叶),不得默认归舒宇/泗澄。细则 → routing-decision.md §感知边界核查。
硬性: SQL 控制台 / 数据服务(含性能评估、OMA 解析失败)→ 仅用户反馈 Req,不拆分、不建 Bug → data-service-routing.md。
③ 结构化 + 审阅报告
每条字段:标题、原声(逐字)、解读、建议、价值、优先级(obcloud-knowledge §5.5)、主责、路由。
数据契约: schemas/candidate-issue.json + review-report.md。
呈现载体(先识别 Agent,再选载体——禁止因非 Cursor/Codex 而默认纯文本):
| 环境 | 交付物 |
|---|---|
| Cursor | .canvas.tsx → 剪贴板复制建单指令(本对话粘贴) |
| Codex | HTML fragment + ::codex-inline-vis |
| 其它 Agent | 独立交互 HTML(默认) — 浏览器打开即可勾选提交 |
| 末位回退 | 聊天内 Q 编号清单(仅当无法写/打开 HTML 时) |
细则 → agent-rendering.md §0 反模式。提交 prompt 中 skill 路径用本机绝对路径 → config-overrides.md。
④ 建 Dima
授权后:校验 Q 编号 → 映射候选数据 → 逐条防重 → 建单 → 返回链接。来源为指定 SA 反馈表时,Dima 创建成功或防重命中已有单据后,按原 doc_id + sheet_id + record_id 回写 Dima 链接与当前跟进人;细则见 sa-feedback-follow-up.md。
MCP 用户反馈建单: 正文须含 #### 站点、#### 用户行为与画像分析(与审阅一致);#### 参考来源 固定「OBCloud 产品内用户反馈」;#### 分析解读 不含路由逻辑 → designer-route-dima.md §4.2。
| 路由 | 必读 |
|---|---|
| 设计体验 / SQL / 数据服务 | designer-route-dima.md |
| 非设计师 | cloud-middleware-dima.md |
防重 / CLI / 所属模块: dima-cli-pitfalls.md
批量: .dima-create-batch.json → 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
文档索引
| 主题 | 文件 |
|---|---|
| 总索引 | 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 |
安装与共享
内置 obcloud-knowledge.md,无需额外下载。团队完整版知识文档放工作区同名文件即可优先加载。