IoT Bug Skill

Overview

本 skill 用于通过 data-agent-skill 查询 IoT 相关项目或人员的 bug 数据，并将结果按状态、严重度、是否关闭 等维度进行分类汇总展示，输出适合日常查询、群内同步、周会汇报和负责人跟踪的结构化 bug 看板。本 skill 主要解决以下场景：

按项目查看当前 bug 总览
按负责人查看名下 bug 分布
查看未关闭 bug 清单
查看 S / A / B / C 严重度分布
查看标准状态分布
快速整理适合汇报的 bug 看板内容本 skill 不直接负责底层数据抓取，而是默认依赖 data-agent-skill 提供 bug 数据查询能力。

Dependency Requirement

在使用本 skill 前，必须先确认 data-agent-skill 是否已安装。

安装检查原则

已安装：继续执行查询与看板输出
未安装：停止后续查询，引导用户先安装
安装链接：
https://platform-eaglelab.tcl.com/skill-page/skill/21

执行要求

若用户明确表示 未安装，则不继续查询
若用户未说明是否安装，应先提醒确认
若当前环境中已经可以正常使用 data-agent-skill，则可直接继续执行查询

Supported Query Perspectives

本 skill 支持两类核心查询视角：

1. 按项目查询

适用于查看某个项目整体 bug 情况，包括：

bug 总数
未关闭数
已关闭数
按状态分布
按严重度分布
重点 bug 清单
最近更新 bug 清单

2. 按负责人查询

适用于查看某位负责人名下的 bug 情况，包括：

关联 bug 总数
未关闭数
已关闭数
按状态分布
按严重度分布
待优先处理 bug
最近更新 bug

Standard Status Model

状态分类应优先基于以下标准状态值进行统计与展示：

new
assigned
SCCB
monitor
backlog
failed
ready to test
ready to release
inprogress
invalid
more info requested
closed

状态处理规则

输出时优先保留标准状态原文
若返回结果中存在非标准状态值，统一归入 other
closed 视为关闭状态
除 closed 之外，其余状态默认视为未关闭状态
若存在状态字段缺失，应明确说明“状态字段缺失，统计可能不完整”

Severity Model

严重度分类应基于以下标准等级，并按从重到轻排序展示：

严重度处理规则

输出时必须按 S > A > B > C 顺序展示
若存在非标准严重度值，统一归入 other
若存在 S 或 A 级且未关闭 bug，应优先突出显示
若严重度字段缺失，应明确说明“严重度字段缺失，统计可能不完整”

Workflow Decision Tree

如果用户未说明查询维度：先确认是按项目还是按 负责人 查询
如果用户未确认 data-agent-skill 是否已安装：先提醒确认安装状态
如果未安装 data-agent-skill：停止后续查询，引导先完成安装
如果已安装且查询条件明确：调用 data-agent-skill 获取 bug 数据
获取数据后：按状态、严重度、是否关闭进行分类统计，并根据查询维度输出对应看板
如果数据不足以完成统计：明确说明缺失字段，不强行编造结果

Step 1: 确认前置依赖

在执行任何 bug 查询前，先确认 data-agent-skill 是否可用。

处理原则

如果用户明确表示未安装：
- 停止后续查询
- 返回安装链接
- 引导先安装后重试
如果用户未说明是否已安装：
- 先做简短提醒
- 若当前上下文已知可正常调用 data-agent-skill，则可以直接继续，不必反复追问
如果已知当前环境可调用 data-agent-skill：
- 直接进入查询流程

Step 2: 确认查询维度与筛选条件

至少确认以下之一：

项目名称 / 项目标识
负责人姓名 / 工号 / 账号可补充确认的筛选条件包括：
时间范围
bug 状态范围
严重度范围
是否仅统计未关闭 bug
是否需要返回 bug 链接
是否需要明细表

Step 3: 调用 data-agent-skill 查询数据

确认依赖已安装且查询条件完整后，调用 data-agent-skill 获取对应 bug 数据。

查询要求

返回字段应尽量包含：

bug ID / 编号
标题
所属项目
负责人
当前状态
严重度
创建时间
更新时间
bug 链接

空结果处理

如果返回结果为空，应明确提示：

未查询到符合条件的 bug 数据
建议检查项目名、人员名或筛选条件是否准确

Step 4: 分类统计与看板整理

获取 bug 数据后，至少执行以下统计：

4.1 按是否关闭统计

必须给出：

bug 总数
未关闭 bug 数
已关闭 bug 数默认规则：
状态为 closed → 记为已关闭
其他状态 → 记为未关闭
若无状态字段 → 明确标注无法准确判断关闭情况

4.2 按状态分类

状态统计必须优先基于以下标准状态值：

new
assigned
SCCB
monitor
backlog
failed
ready to test
ready to release
inprogress
invalid
more info requested
closed 输出建议：
各状态 bug 数量
各状态占比（可选）
若有必要，列出每个状态下的重点 bug
非标准状态归入 other

4.3 按严重度分类

严重度统计必须使用以下标准等级，并按从重到轻排序展示：

S
A
B
C 输出建议：
各严重度 bug 数量
各严重度占比（可选）
优先突出 S、A 级 bug
非标准严重度归入 other

Step 5: 按不同维度输出看板

根据用户选择的维度，输出不同结构的看板内容。

5.1 项目 Bug 看板

适用场景：用户希望查看某个项目整体 bug 情况。

建议展示内容

项目名称
bug 总数
未关闭 bug 数
已关闭 bug 数
按状态分布
按严重度分布
高优先关注 bug 列表
最近更新 bug 列表

参考结构

项目 Bug 看板

项目：{项目名称}
Bug 总数：{总数}
未关闭：{数量}
已关闭：{数量}

状态分布

new: x
assigned: x
SCCB: x
monitor: x
backlog: x
failed: x
ready to test: x
ready to release: x
inprogress: x
invalid: x
more info requested: x
closed: x
other: x

严重度分布

S: x
A: x
B: x
C: x
other: x

重点 Bug

#{bug_id} {标题} | 状态：{状态} | 严重度：{严重度} | 链接：{链接}

5.2 负责人 Bug 看板

适用场景：用户希望查看某位负责人相关 bug 情况。

建议展示内容

负责人名称
关联 bug 总数
未关闭 bug 数
已关闭 bug 数
按状态分布
按严重度分布
待优先处理 bug 列表
最近更新 bug 列表

参考结构

负责人 Bug 看板

负责人：{姓名/账号}
Bug 总数：{总数}
未关闭：{数量}
已关闭：{数量}

状态分布

new: x
assigned: x
SCCB: x
monitor: x
backlog: x
failed: x
ready to test: x
ready to release: x
inprogress: x
invalid: x
more info requested: x
closed: x
other: x

严重度分布

S: x
A: x
B: x
C: x
other: x

待优先处理 Bug

#{bug_id} {标题} | 项目：{项目} | 状态：{状态} | 严重度：{严重度} | 链接：{链接}

Output Guidelines

输出时应遵循以下原则：

先说明是否已确认 data-agent-skill 依赖
再说明查询维度（项目 / 负责人）与筛选条件
再输出统计结果
状态展示优先使用标准状态值原文
严重度展示必须按 S > A > B > C 排序
看板内容必须与查询维度一致，不混合项目视角和负责人视角
若数据不足以支撑统计，应明确说明缺失字段
若存在 S 或 A 级且未关闭 bug，应优先突出显示
若用户要求“未关闭 bug 清单及链接”，应优先返回明细表与链接
若结果较多，先给汇总，再给重点项和链接

Recommended Response Style

建议默认使用以下输出顺序：

一句话结论
查询维度与筛选条件
bug 总数 / 未关闭 / 已关闭
状态分布
严重度分布
重点 bug
最近更新 bug
bug 明细表（如用户需要）

示例风格

结论先行
重点突出
尽量结构化
便于直接复制到飞书 / 周报 / 群消息中使用

Usage

使用前检查

确认 data-agent-skill 是否已安装
若未安装，先通过以下链接安装：
https://platform-eaglelab.tcl.com/skill-page/skill/21
安装完成后，再执行 bug 查询

Resources

references/

references/bug-dashboard-template.md：Bug 看板输出模板与推荐话术
可补充：
- bug 状态定义说明
- 严重度定义说明
- 字段映射说明
- 常见查询问法示例

Final Principle

本 skill 的核心目标不是替代 data-agent-skill，而是： 在已有查询能力之上，把 bug 数据整理成“更适合人看、适合汇报、适合跟踪”的结构化看板输出。

iot-bug-skill

IoT Bug Skill

Overview

Dependency Requirement

安装检查原则

推荐提醒话术

执行要求

Supported Query Perspectives

1. 按项目查询

2. 按负责人查询

Standard Status Model

状态处理规则

Severity Model

严重度处理规则

Workflow Decision Tree

Step 1: 确认前置依赖

处理原则

Step 2: 确认查询维度与筛选条件

推荐提问示例

Step 3: 调用 data-agent-skill 查询数据

推荐调用表达

按项目

按负责人

带筛选条件

查询要求

空结果处理

Step 4: 分类统计与看板整理

4.1 按是否关闭统计

4.2 按状态分类

4.3 按严重度分类

Step 5: 按不同维度输出看板

根据用户选择的维度，输出不同结构的看板内容。

5.1 项目 Bug 看板

建议展示内容

参考结构

项目 Bug 看板

状态分布

严重度分布

重点 Bug

最近更新

5.2 负责人 Bug 看板

建议展示内容

参考结构

负责人 Bug 看板

状态分布

严重度分布

待优先处理 Bug

最近更新

Output Guidelines

Recommended Response Style

示例风格

Usage

使用前检查

推荐输入示例

推荐执行话术

Resources

references/

Final Principle