name: qiwei-official-doc

description: 通过企业微信官方 CLI 创建普通文档、读取或覆写 Markdown，并将真实企微文档沉淀到本地知识库后逐篇生成 AI 摘要、要点、决策和待办候选。适用于创建企微文档、读取 doc.weixin.qq.com/doc/ 链接、文档知识归档和 AI 文档分析；在线表格、智能表格和智能文档应路由到对应方法。

企业微信官方普通文档

本技能只处理 URL 形如 https://doc.weixin.qq.com/doc/* 的普通文档，通过 qiwei_official_* MCP 工具调用官方 CLI。

以下类型不由本技能直接处理：

URL	类型
`/sheet/*`	在线表格
`/smartsheet/*`	智能表格
`/smartpage/*`	智能文档

前置检查

调用 qiwei_official_status；
未安装时调用 qiwei_official_prepare；
未初始化时停止业务调用，把返回的初始化命令交给用户完成扫码；
调用 qiwei_official_help 核对当前方法参数。

支持的方法

意图	category	method
创建普通文档	`doc`	`create_doc`
读取 Markdown 内容	`doc`	`get_doc_content`
用 Markdown 覆写正文	`doc`	`edit_doc_content`

创建文档

创建普通文档时：

{
  "category": "doc",
  "method": "create_doc",
  "args": {
    "doc_type": 3,
    "doc_name": "项目周报"
  }
}

create_doc 只创建空白文档。用户同时给出正文时，创建成功后再调用 edit_doc_content 写入 Markdown。返回 docid 和 URL。

读取内容

使用 docid 或 URL 二选一定位，type 固定为 2：

{
  "docid": "DOC_ID",
  "type": 2
}

读取是异步任务：

首次不传 task_id；
task_done=false 时保存返回的 task_id；
携带同一 task_id 继续调用；
task_done=true 后返回完整 Markdown 内容。

覆写正文

edit_doc_content 会替换全部正文，参数中的 content_type 固定为 1。

执行前：

如果用户未明确要求覆盖，先读取现有内容；
说明该操作会替换全部正文；
展示变更摘要并取得确认；

再调用：

{
"category": "doc",
"method": "edit_doc_content",
"args": {
"docid": "DOC_ID",
"content": "# 新正文",
"content_type": 1
}
}

文档知识沉淀

在 4320 Dashboard 的“知识库 → 企微文档知识沉淀 → 文档工作台”中执行：

创建普通文档并写入 Markdown，或用 docid/链接读取已有文档；
对 get_doc_content 返回的异步任务持续使用同一 task_id，完成后再保存；
将真实文档原文、docid、链接和同步时间写入 outputs/knowledge/docs/；
AI 分析与读取分开，逐篇触发摘要、关键要点、明确决策、风险和有原文证据的待办候选；
AI 失败时保留真实原文并标记失败，不补写伪结论。
有原文证据的行动项进入“统一任务中心”的 AI 候选区；只有人工点击确认后才转为正式内部任务，不自动创建企微待办。

错误处理

851002 incompatible doc type：重新识别 URL 类型，不要继续用普通文档方法；
未初始化：提示官方 CLI 初始化，不调用原有 qiwei_login_*；
方法或 schema 变化：重新调用 qiwei_official_help；
不展示机器人 Secret、Authorization 或本地加密配置内容。
文档读取权限暂缺时保留已确认成功的创建/写入结果，并允许在工作台重新读取复核；不能把本地写入内容伪装成官方读回结果。