Issue Register

SKILL.md

---
name: issue-register
description: 问题登记技能。在为知笔记的"工作/项目名/问题登记"目录下创建标准化问题登记笔记，并维护问题登记总览。触发词："登记问题"、"记录问题"、"登记一下问题"、"问题登记"。
---

# 问题登记技能

## 触发条件
用户说"登记问题"、"记录问题"、"登记一下问题"、"问题登记"时触发。

## 配置
读取 `config.md` 获取：
- 默认项目名称和分类路径
- 总览笔记的 docGuid

当前默认：**徐工财务**（路径 `/工作/徐工财务/问题登记/`）

## 处理流程

### 1. 确定项目名称
读取 `config.md` 中的默认项目，直接使用，不询问。仅当用户明确指定其他项目时才覆盖。

### 2. 收集问题信息
按以下字段收集（如果用户一次提供了多个字段，跳过已提供的项）：

| 字段 | 说明 | 示例 |
|------|------|------|
| 问题标题 | 一句话概括问题 | ETL任务执行超时 |
| 问题描述 | 详细描述问题现象 | 每日凌晨3点的增量同步任务连续3天超时失败 |
| 发现时间 | 什么时候发现的（默认取系统当前日期） | 2026-05-14 |
| 报告人 | 谁发现的（默认：王凤祥） | 张三 |
| 严重程度 | 🔴严重 🟡一般 🟢轻微 | 🟡一般 |
| 影响范围 | 影响哪些模块/业务 | 数据同步模块 |
| 当前状态 | 待处理/处理中/已解决（默认：待处理） | 待处理 |
| 负责人 | 谁负责跟进 | 李四 |
| 备注 | 补充信息 | 客户已知晓 |

### 3. 日期处理
⚠️ **必须取系统当前日期**，用 `date '+%Y-%m-%d'` 获取，不要手填！

### 4. 创建问题笔记

使用 wiznote 技能创建协作笔记（创建后需调用 update_collaboration_note 确保内容写入）：

```python
# 创建
result = api.create_collaboration_note(title, blocks, category)
# 确认写入
api.update_collaboration_note(result['docGuid'], blocks)
```

分类路径：`/工作/{项目名}/问题登记/`

Markdown 模板：

```markdown
# 【问题登记】{问题标题}

## 基本信息

| 项目 | 内容 |
|------|------|
| 发现时间 | {日期} |
| 报告人 | {报告人} |
| 严重程度 | {严重程度} |
| 当前状态 | {当前状态} |
| 负责人 | {负责人} |

## 问题描述

{问题描述}

## 影响范围

{影响范围}

## 处理记录

| 日期 | 处理内容 | 处理人 | 状态变更 |
|------|---------|--------|---------|
| {日期} | 问题登记 | {报告人} | → 待处理 |

## 备注

{备注}
```

### 5. 更新总览笔记（关键步骤！）

⚠️ **每次创建或更新问题后，必须同步更新总览笔记！**

从 `config.md` 读取总览笔记 docGuid，更新其内容。

总览 Markdown 模板（使用列表卡片式，不用表格）：

```markdown
# {项目名} · 问题登记总览

> 最后更新：{当前日期时间}

---

## {序号}. {问题标题}
- **状态：** {当前状态}　**严重程度：** {严重程度}　**负责人：** {负责人}
- **登记时间：** {登记时间}　**最新更新：** {最新更新时间}

---

## 统计

- **总计：** {N} 个问题
- 🔴 严重：{X} ｜ 🟡 一般：{Y} ｜ 🟢 轻微：{Z}
- 待处理：{A} ｜ 处理中：{B} ｜ 已解决：{C}
```

**已解决问题标记：**
使用为知笔记原生 `style-strikethrough` 属性给标题加删除线。找到对应 heading block 的 text 数组，给 insert 项加 `"attributes": {"style-strikethrough": true}`。
```markdown
## {序号}. {问题标题}（已解决）
- **状态：** ✅已解决　**严重程度：** {严重程度}　**负责人：** {负责人}
- **登记时间：** {登记时间}　**最新更新：** {最新更新时间}
```

**更新逻辑：**
1. 读取所有已登记问题笔记（通过搜索 `【问题登记】` 获取列表）
2. 逐个读取问题笔记内容，提取状态、严重程度、负责人等
3. 已解决的问题标题后加「（已解决）」标识
4. 重新生成总览列表并更新

### 6. 更新问题操作

用户说"更新问题 XXX"时：
1. 搜索对应问题笔记
2. 收集要更新的字段
3. 更新问题笔记内容
4. **同步更新总览笔记**

可更新的字段：问题标题、问题描述、严重程度、影响范围、当前状态、负责人、备注、追加处理记录。

## 注意事项

- 分类路径不存在时先创建
- 日期必须用 `date` 命令获取，不要手填
- 创建笔记后必须调用 `update_collaboration_note` 确认内容写入（已知限制：仅 create 时 WebSocket 可能静默失败）
- 标题前缀统一用 `【问题登记】`
- **创建和更新都必须同步更新总览笔记**