Issue Register

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

问题登记技能

触发条件

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

配置

读取 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 可能静默失败）
• 标题前缀统一用 【问题登记】
• 创建和更新都必须同步更新总览笔记