# Yida Voc

> 宜搭 VOC（用户反馈）信息整理。将故障、需求、性能问题整理成可提交的高质量反馈材料。适用于用户需要向宜搭平台提交问题反馈时。

- Skill: `openyida/yida-voc` (Agent Skill)
- Install (CLI): `npx skillmds@latest add openyida/yida-voc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openyida/yida-voc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: openyida (https://skillmd.com/u/openyida)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/openyida/yida-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、手机号、身份证、客户数据。
- 如果问题已能在本地复现，明确写出可复现步骤；如果不能复现，写“当前未复现，需补充环境或截图”。