yida-voc · diff

git:20260507.0db5ec3 to git:20260702.ac3bada

1 added, 9 removed. Audit A to A.

---

name: yida-voc

- description: 宜搭 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、手机号、身份证、客户数据。

- 如果问题已能在本地复现，明确写出可复现步骤；如果不能复现，写“当前未复现，需补充环境或截图”。