yida-voc · git:20260702.ac3bada · 2026-07-02 · sha256 b6b4d6e85b5218fc

yida-voc git:20260702.ac3badaA

Immutable. This exact content is served forever at /api/v1/blob/b6b4d6e85b5218fc.

---
name: yida-voc
description: 宜搭 VOC(用户反馈)信息整理。将故障、需求、性能问题整理成可提交的高质量反馈材料。适用于用户需要向宜搭平台提交问题反馈时。
---

# VOC 信息整理

## 严格禁止 (NEVER DO)

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

## 适用场景

**正向触发**:

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

## 信息采集

优先收集可验证信息:

```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、手机号、身份证、客户数据。
- 如果问题已能在本地复现,明确写出可复现步骤;如果不能复现,写“当前未复现,需补充环境或截图”。