问题登记技能#

触发条件#

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

配置#

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