---
name: yida-voc
description: 宜搭 VOC（用户反馈）信息整理技能。用于把故障、需求、性能问题整理成可提交的高质量反馈材料。不适用于：编造复现步骤、替用户确认平台内部结论、直接修复应用配置。
---

# VOC 信息整理

## 严格禁止 (NEVER DO)

- 不要编造日志、截图、组织 ID、应用 ID、表单 ID、时间线或复现结果。
- 不要把推测写成事实；无法确认的信息统一标记为“待补充”。
- 不要承诺平台修复时间、内部处理人或根因，除非用户提供了明确证据。
- 不要在未征得用户同意时提交外部工单或反馈；本技能默认只整理材料。

## 适用场景

**正向触发**：

- “帮我提一个 VOC/反馈/工单”
- “整理这个 bug 反馈”
- “把这个需求写成反馈”
- “这个宜搭页面很慢，帮我反馈”

**不适用场景**：

| 场景 | 应使用技能 |
|------|-----------|
| 本地诊断环境问题 | `openyida doctor` 或相关诊断技能 |
| 修改宜搭应用配置 | 对应的创建/配置技能 |
| 查询/写入表单数据 | `yida-data-management` |

## 信息采集

优先收集可验证信息：

```bash
openyida --version
node -v
openyida env --json
openyida doctor --report markdown
```

如涉及具体应用或页面，补充：

- `appType`
- `formUuid` / `processCode` / `reportId`
- 发生时间（含时区）
- 影响范围（单人、多人、整个组织）
- 复现步骤
- 期望结果
- 实际结果
- 截图、录屏、报错文本、接口响应片段（用户提供时引用）

## 模板：故障反馈

```markdown
# VOC：故障反馈

## 摘要
一句话描述问题和影响范围。

## 环境
- OpenYida 版本：待补充
- Node.js 版本：待补充
- AI 工具/终端：待补充
- 组织/环境：待补充
- appType：待补充
- formUuid/processCode/reportId：待补充

## 复现步骤
1. 待补充
2. 待补充
3. 待补充

## 期望结果
待补充

## 实际结果
待补充

## 影响范围
待补充

## 已尝试排查
- 待补充

## 附件/证据
- 截图：待补充
- 日志/报错：待补充
- 诊断报告：待补充
```

## 模板：需求反馈

```markdown
# VOC：需求反馈

## 摘要
一句话说明希望新增或优化的能力。

## 背景
当前业务场景、用户角色、使用频率。

## 当前痛点
- 待补充

## 期望能力
- 待补充

## 验收标准
1. 待补充
2. 待补充

## 业务价值
效率、成本、稳定性、体验或规模化收益。

## 替代方案
当前是否有临时绕法，以及绕法的问题。
```

## 模板：性能反馈

```markdown
# VOC：性能反馈

## 摘要
页面/接口/操作在什么场景下明显变慢。

## 环境与对象
- appType：待补充
- formUuid/reportId/pageId：待补充
- 数据量：待补充
- 使用端：PC / 移动端 / 钉钉内 / 浏览器，待补充

## 性能现象
- 首屏耗时：待补充
- 操作响应耗时：待补充
- 是否偶发：待补充

## 复现步骤
1. 待补充
2. 待补充

## 影响
待补充

## 证据
- 录屏/截图：待补充
- 控制台报错：待补充
- Network 慢请求：待补充
```

## 写作要求

- 事实和推测分开写。
- 用户没提供的信息保留“待补充”，不要为了完整性补故事。
- 有命令输出时只摘录关键字段，不粘贴敏感 cookie、token、手机号、身份证、客户数据。
- 如果问题已能在本地复现，明确写出可复现步骤；如果不能复现，写“当前未复现，需补充环境或截图”。
