dingtalk-workspace-cli/internal/cli/schema_hints/selection/doc.json

{
  "version": 1,
  "source": {
    "kind": "explicit",
    "name": "dws-agent-selection/doc",
    "repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
    "channel": "open-source",
    "reviewed": true
  },
  "tools": {
    "doc.add_permission": {
      "agent_summary": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。",
      "use_when": [
        "给单篇文档做节点级授权（与 drive permission add 同能力的 doc 入口）时"
      ],
      "avoid_when": [
        "知识库容器授权用 wiki member add",
        "查/改/移除用 permission list/update/remove"
      ],
      "examples": [
        "dws doc permission add --node <DOC_ID> --users uid1 --role READER --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.add_permission",
        "cobra-help:dws doc permission add",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.add_permission",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.add_permission"
      ]
    },
    "doc.copy_document": {
      "agent_summary": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。",
      "use_when": [
        "用户要复制文档/文件并保留原位置时（尤其保形复制模板：copy + rename + block update）",
        "目标文件夹 --folder 或知识库根 --workspace；都不传则默认「我的文档」"
      ],
      "avoid_when": [
        "要搬走不留副本改用 dws doc move 或 dws drive move",
        "跨钉盘整理文件优先 dws drive copy"
      ],
      "examples": [
        "dws doc copy --node <DOC_ID> --folder <TARGET_FOLDER_ID> --format json",
        "dws doc copy --node <DOC_ID> --workspace <TARGET_WS_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.copy_document",
        "cobra-help:dws doc copy",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.copy_document",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.copy_document"
      ]
    },
    "doc.create_comment": {
      "agent_summary": "创建文档评论",
      "use_when": [
        "在文档上创建不绑定具体划词位置的全文评论，可 --mention 时"
      ],
      "avoid_when": [
        "针对某段选中文本的划词评论改用 create-inline（需 blockId+start/end）",
        "回复已有评论用 reply；删评论用 delete"
      ],
      "examples": [
        "dws doc comment create --node <DOC_ID> --content \"这里需要修改\" --format json",
        "dws doc comment create --node <DOC_ID> --content \"请review\" --mention uid1,uid2 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_comment",
        "cobra-help:dws doc comment create",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_comment",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_comment",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc-comment.create_comment"
      ]
    },
    "doc.create_document": {
      "agent_summary": "创建一篇新的在线文档",
      "use_when": [
        "用户要新建一篇文字在线文档(adoc)，可空文档或带初始 Markdown 时",
        "创建到指定文件夹 --folder、知识库根 --workspace，或默认「我的文档」根目录时"
      ],
      "avoid_when": [
        "创建表格/脑图/白板/多维表/演示改用 dws wiki node create --type <type>（勿用 doc create）",
        "在知识库建空节点实体也可用 wiki node create；本命令侧重可写初始内容的 adoc",
        "导入本地 Word/Markdown 为在线文档改用 dws doc import（若可用）或 upload --convert"
      ],
      "examples": [
        "dws doc create --name \"项目周报\" --format json",
        "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder <FOLDER_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_document",
        "cobra-help:dws doc create",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_document",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_document",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.create_document"
      ]
    },
    "doc.create_file": {
      "agent_summary": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）",
      "use_when": [
        "兼容入口：按类型创建文件节点时（已弃用，改用 wiki node create）"
      ],
      "avoid_when": [
        "请改用 dws wiki node create --workspace <id> --type <type>",
        "纯文字带内容创建用 doc create"
      ],
      "examples": [
        "dws doc file create --name \"项目周报\" --type adoc --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_file",
        "cobra-help:dws doc file create",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_file",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_file",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.create_file"
      ]
    },
    "doc.create_folder": {
      "agent_summary": "创建文件夹",
      "use_when": [
        "兼容入口：创建文件夹（已弃用）时"
      ],
      "avoid_when": [
        "个人空间/钉盘改用 dws drive mkdir；知识库改用 wiki node create --type folder"
      ],
      "examples": [
        "dws doc folder create --name \"项目资料\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_folder",
        "cobra-help:dws doc folder create",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_folder",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_folder",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.create_folder"
      ]
    },
    "doc.create_inline_comment": {
      "agent_summary": "在文档选中文本范围创建划词评论",
      "use_when": [
        "针对块内某段文本创建划词评论（必填 blockId、start、end）时"
      ],
      "avoid_when": [
        "不绑定位置的全文评论用 create",
        "先 block list 取 blockId 与纯文本偏移再调用"
      ],
      "examples": [
        "dws doc comment create-inline --node <DOC_ID> --block-id <BLOCK_ID> --start 0 --end 10 --content \"这里需要修改\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.create_inline_comment",
        "cobra-help:dws doc comment create-inline",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_inline_comment",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc-comment.create_inline_comment"
      ]
    },
    "doc.delete_comment": {
      "agent_summary": "永久删除指定文档中的一条评论",
      "use_when": [
        "用户明确要求永久删除指定文档中的某条评论（已有 commentKey）时"
      ],
      "avoid_when": [
        "只需改文案用 update；回复用 reply；目标评论不明或未确认时不要删"
      ],
      "examples": [
        "dws doc comment delete --node <DOC_ID> --comment-key <COMMENT_KEY> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "internal/cli/schema_command_registry.json#doc.delete_comment",
        "cobra-help:dws doc comment delete --help",
        "skills/mono/references/products/doc/doc-comment.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc-comment.delete_comment"
      ]
    },
    "doc.delete_document": {
      "agent_summary": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。",
      "use_when": [
        "用户明确要求用 doc delete 兼容入口将文档/文件移入回收站，且已确认目标时"
      ],
      "avoid_when": [
        "常规文件删除优先 dws drive delete；本入口仅为兼容",
        "用户未确认或目标不清时不要删",
        "删块用 doc block delete；删评论用 doc comment delete"
      ],
      "examples": [
        "dws doc delete --node <DOC_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.delete_document",
        "cobra-help:dws doc delete",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.delete_document",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.delete_document"
      ]
    },
    "doc.delete_document_block": {
      "agent_summary": "删除块元素（不可逆）",
      "use_when": [
        "用户确认后删除文档中指定块元素时"
      ],
      "avoid_when": [
        "未确认或 blockId 不明时不要删；先 block list",
        "删整篇文档用 doc/drive delete"
      ],
      "examples": [
        "dws doc block delete --node <DOC_ID> --block-id <BLOCK_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.delete_document_block",
        "cobra-help:dws doc block delete",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.delete_document_block",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.delete_document_block",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.delete_document_block"
      ]
    },
    "doc.download_doc_attachment": {
      "agent_summary": "获取文档附件的临时下载链接",
      "use_when": [
        "获取文档正文中附件的临时下载 URL（resourceId 来自 block list attachment）时"
      ],
      "avoid_when": [
        "下载钉盘普通文件用 drive download；导出在线文档用 doc export"
      ],
      "examples": [
        "dws doc media download --node <DOC_ID> --resource-id <RESOURCE_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.download_doc_attachment",
        "cobra-help:dws doc media download",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.download_doc_attachment",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.download_doc_attachment"
      ]
    },
    "doc.download_file": {
      "agent_summary": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。",
      "use_when": [
        "兼容入口：获取文件下载凭证（已迁移场景优先 drive download）时"
      ],
      "avoid_when": [
        "常规下载普通文件改用 dws drive download --output ...",
        "在线文档导出 docx 用 doc export"
      ],
      "examples": [
        "dws doc download --node <NODE_ID> --output ./report.pdf --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.download_file",
        "cobra-help:dws doc download",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.download_file",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.download_file"
      ]
    },
    "doc.get_document_content": {
      "agent_summary": "读取文档内容（Markdown）",
      "use_when": [
        "用户要读取钉钉在线文字文档(adoc)正文（Markdown）时",
        "用户直接粘贴文档 URL 且无其他指令时（默认读内容）"
      ],
      "avoid_when": [
        "非 adoc（表格/多维表/普通文件）不要用本命令；先 doc info 再路由",
        "要元信息用 doc info；要块结构用 doc block list",
        "Markdown 为有损投影：保形复制模板请用 doc copy，不要 read→create"
      ],
      "examples": [
        "dws doc read --node <DOC_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.get_document_content",
        "cobra-help:dws doc read",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.get_document_content",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.get_document_content",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.get_document_content"
      ]
    },
    "doc.get_document_info": {
      "agent_summary": "获取文档元信息（标题/类型/创建者/权限等）",
      "use_when": [
        "用户要查看文档/节点元信息（标题、类型、创建者、权限）时",
        "准备读内容前必须先看 contentType/extension 以路由到 read/sheet/aitable/download 时"
      ],
      "avoid_when": [
        "已确认是 adoc 且只要正文改用 dws doc read",
        "只要目录列表改用 dws drive list / wiki node list"
      ],
      "examples": [
        "dws doc info --node <DOC_ID> --format json",
        "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/<DOC_UUID>\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.get_document_info",
        "cobra-help:dws doc info",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.get_document_info",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.get_document_info",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.get_document_info"
      ]
    },
    "doc.import_get": {
      "agent_summary": "根据 taskId 查询文档导入任务的执行结果",
      "use_when": [
        "查询文档导入任务结果（已有 taskId，导入超时/中断后兜底）时"
      ],
      "avoid_when": [
        "发起导入用 doc import（若入口可用）；不要用本命令代替导入"
      ],
      "examples": [
        "dws doc import get --task-id <TASK_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.import_get",
        "cobra-help:dws doc import get",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "doc.insert_document_block": {
      "agent_summary": "向文档插入块元素",
      "use_when": [
        "在文档中插入新块（段落/标题等）；简单场景用 --text/--heading，复杂块用 --element JSON"
      ],
      "avoid_when": [
        "整篇追加 Markdown 优先 doc update --mode append",
        "插入本地文件附件优先 doc media insert",
        "删块用 block delete；改已有块用 block update"
      ],
      "examples": [
        "dws doc block insert --node <DOC_ID> --text \"这是一段文字\" --format json",
        "dws doc block insert --node <DOC_ID> --heading \"二级标题\" --level 2 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.insert_document_block",
        "cobra-help:dws doc block insert",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.insert_document_block",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.insert_document_block"
      ]
    },
    "doc.list_comments": {
      "agent_summary": "查询文档评论列表",
      "use_when": [
        "查看文档评论列表，可按全文/划词、已解决/未解决过滤时"
      ],
      "avoid_when": [
        "创建全文评论用 comment create；划词用 create-inline；回复用 reply；删除用 delete"
      ],
      "examples": [
        "dws doc comment list --node <DOC_ID> --format json",
        "dws doc comment list --node <DOC_ID> --type inline --resolve-status unresolved --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.list_comments",
        "cobra-help:dws doc comment list",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_comments",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_comments",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc-comment.list_comments"
      ]
    },
    "doc.list_document_blocks": {
      "agent_summary": "查询文档一级块元素列表",
      "use_when": [
        "查看文档一级块结构、拿 blockId，供 insert/update/delete 或划词评论定位时"
      ],
      "avoid_when": [
        "只要全文 Markdown 用 doc read",
        "要改内容分别用 block insert/update/delete"
      ],
      "examples": [
        "dws doc block list --node <DOC_ID> --format json",
        "dws doc block list --node <DOC_ID> --start-index 0 --end-index 5 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.list_document_blocks",
        "cobra-help:dws doc block list",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_document_blocks",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_document_blocks",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.list_document_blocks"
      ]
    },
    "doc.list_nodes": {
      "agent_summary": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。",
      "use_when": [
        "兼容入口：遍历文件夹或知识库直接子节点时（已弃用，日常改用 drive list / wiki node list）"
      ],
      "avoid_when": [
        "日常浏览「我的文档」/钉盘用 dws drive list；知识库用 dws wiki node list"
      ],
      "examples": [
        "dws doc list --format json",
        "dws doc list --folder <FOLDER_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.list_nodes",
        "cobra-help:dws doc list",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_nodes",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_nodes",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.list_nodes"
      ]
    },
    "doc.list_permission": {
      "agent_summary": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。",
      "use_when": [
        "列出文档节点成员权限时"
      ],
      "avoid_when": [
        "增删改权限用 add/update/remove；知识库成员用 wiki member list"
      ],
      "examples": [
        "dws doc permission list --node <DOC_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.list_permission",
        "cobra-help:dws doc permission list",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_permission",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.list_permission"
      ]
    },
    "doc.media_insert": {
      "agent_summary": "上传本地文件并作为附件插入文档",
      "use_when": [
        "把本地文件/图片作为附件块插入文档正文（自动 prepare+PUT+insert）时"
      ],
      "avoid_when": [
        "上传为独立文件用 drive/doc upload，不要与正文附件混淆",
        "下载正文附件用 media download"
      ],
      "examples": [
        "dws doc media insert --node <DOC_ID> --file ./report.pdf --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.media_insert",
        "cobra-help:dws doc media insert",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.media_insert",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "doc.move_document": {
      "agent_summary": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。",
      "use_when": [
        "用户要移动文档/文件且原位置不再保留时"
      ],
      "avoid_when": [
        "要保留副本改用 doc/drive copy",
        "目标未确认时不要 move"
      ],
      "examples": [
        "dws doc move --node <DOC_ID> --folder <TARGET_FOLDER_ID> --format json",
        "dws doc move --node <DOC_ID> --workspace <TARGET_WS_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.move_document",
        "cobra-help:dws doc move",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.move_document",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.move_document"
      ]
    },
    "doc.query_export_job": {
      "agent_summary": "查询文档导出任务结果",
      "use_when": [
        "doc export 超时/中断后，用 jobId 查询导出任务状态与下载链接时"
      ],
      "avoid_when": [
        "常规导出请直接 dws doc export（一体化提交+轮询+下载），不要先查 job"
      ],
      "examples": [
        "dws doc export get --job-id <JOB_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.query_export_job",
        "cobra-help:dws doc export get",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.query_export_job",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.query_export_job"
      ]
    },
    "doc.remove_permission": {
      "agent_summary": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。",
      "use_when": [
        "移除文档节点上指定用户权限时"
      ],
      "avoid_when": [
        "改角色用 update；知识库撤成员用 wiki member remove"
      ],
      "examples": [
        "dws doc permission remove --node <DOC_ID> --users uid1 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.remove_permission",
        "cobra-help:dws doc permission remove",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.remove_permission",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.remove_permission"
      ]
    },
    "doc.rename_document": {
      "agent_summary": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。",
      "use_when": [
        "用户要改文档/文件在列表与链接中展示的名称时"
      ],
      "avoid_when": [
        "改正文标题/章节标题改用 doc block update",
        "不要用 update 或重新 create 来改名"
      ],
      "examples": [
        "dws doc rename --node <DOC_ID> --name \"新名称\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.rename_document",
        "cobra-help:dws doc rename",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.rename_document",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.rename_document"
      ]
    },
    "doc.reply_comment": {
      "agent_summary": "回复文档评论",
      "use_when": [
        "回复已有评论（文字或 --emoji 表情）；commentKey 来自 list/create"
      ],
      "avoid_when": [
        "新建评论用 create/create-inline；删评论用 delete"
      ],
      "examples": [
        "dws doc comment reply --node <DOC_ID> --comment-key <COMMENT_KEY> --content \"同意\" --format json",
        "dws doc comment reply --node <DOC_ID> --comment-key <COMMENT_KEY> --content \"比心\" --emoji --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.reply_comment",
        "cobra-help:dws doc comment reply",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.reply_comment",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.reply_comment",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc-comment.reply_comment"
      ]
    },
    "doc.search_documents": {
      "agent_summary": "搜索文档（不传关键词返回最近访问）",
      "use_when": [
        "兼容入口：按关键词搜文档时（已弃用，日常改用 drive search / wiki node search）"
      ],
      "avoid_when": [
        "全局搜文件用 dws drive search；指定知识库内搜用 dws wiki node search"
      ],
      "examples": [
        "dws doc search --query \"会议纪要\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.search_documents",
        "cobra-help:dws doc search",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.search_documents",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.search_documents",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.search_documents"
      ]
    },
    "doc.template_apply": {
      "agent_summary": "使用指定模板创建新文档",
      "use_when": [
        "使用指定模板创建新文档时"
      ],
      "avoid_when": [
        "先 list/search 拿到模板再 apply；普通空文档用 doc create"
      ],
      "examples": [
        "dws doc template apply --template-id <TPL_ID> --name \"我的周报\" --format json",
        "dws doc template apply --template-id <TPL_ID> --name \"项目方案\" --folder <FOLDER_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.template_apply",
        "cobra-help:dws doc template apply",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.apply_doc_template"
      ]
    },
    "doc.template_list": {
      "agent_summary": "获取当前用户可用的文档模板列表",
      "use_when": [
        "列出当前用户可用的文档模板时"
      ],
      "avoid_when": [
        "按关键词搜模板用 template search；套用模板用 template apply"
      ],
      "examples": [
        "dws doc template list --format json",
        "dws doc template list --source MY --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.template_list",
        "cobra-help:dws doc template list",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.list_doc_templates"
      ]
    },
    "doc.template_search": {
      "agent_summary": "根据关键词搜索文档模板",
      "use_when": [
        "按关键词搜索文档模板时"
      ],
      "avoid_when": [
        "浏览全部模板用 template list；创建文档用 template apply"
      ],
      "examples": [
        "dws doc template search --query \"周报\" --format json",
        "dws doc template search --query \"会议纪要\" --source PUBLIC --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.template_search",
        "cobra-help:dws doc template search",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.search_doc_templates"
      ]
    },
    "doc.update_comment": {
      "agent_summary": "更新指定文档评论的文字内容和可选 @提及用户。",
      "use_when": [
        "修改已有评论正文；可选更新 --mention"
      ],
      "avoid_when": [
        "删除评论用 delete；回复用 reply"
      ],
      "examples": [
        "dws doc comment update --node <DOC_ID> --comment-key <COMMENT_KEY> --content \"已按最新数据修正\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "internal/cli/schema_command_registry.json#doc.update_comment",
        "cobra-help:dws doc comment update --help",
        "skills/mono/references/products/doc/doc-comment.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc-comment.update_comment"
      ]
    },
    "doc.update_document": {
      "agent_summary": "更新文档内容（追加 / 覆盖；覆盖需 --yes）",
      "use_when": [
        "用户要向已有 adoc 追加内容时用 --mode append（更安全）",
        "用户明确要求整篇覆盖替换时用 --mode overwrite（破坏性）",
        "append 且要插到第 N 个 block 前时加 --index N（先 block list）"
      ],
      "avoid_when": [
        "目标不是 adoc 或只要改单个块时改用 doc block update",
        "覆盖模式用户未确认前不要执行；可先 --dry-run 预览",
        "创建新文档用 doc create，不要用 update 冒充创建"
      ],
      "examples": [
        "dws doc update --node <DOC_ID> --content \"# 追加内容\" --mode append --format json",
        "dws doc update --node <DOC_ID> --content-file ./body.md --mode overwrite --dry-run"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.update_document",
        "cobra-help:dws doc update",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_document",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.update_document",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.update_document"
      ]
    },
    "doc.update_document_block": {
      "agent_summary": "更新文档中的指定块",
      "use_when": [
        "修改已有块的文本/标题/样式（已知 blockId）时"
      ],
      "avoid_when": [
        "插入新块用 block insert；删除用 block delete",
        "改文档显示名用 rename；整篇覆盖用 update overwrite"
      ],
      "examples": [
        "dws doc block update --node <DOC_ID> --block-id <BLOCK_ID> --text \"新内容\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.update_document_block",
        "cobra-help:dws doc block update",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_document_block",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.update_document_block"
      ]
    },
    "doc.update_permission": {
      "agent_summary": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。",
      "use_when": [
        "变更文档节点上已有用户角色时"
      ],
      "avoid_when": [
        "新授权用 add；移除用 remove"
      ],
      "examples": [
        "dws doc permission update --node <DOC_ID> --users uid1 --role EDITOR --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.update_permission",
        "cobra-help:dws doc permission update",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_permission",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.update_permission"
      ]
    },
    "doc.upload": {
      "agent_summary": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。",
      "use_when": [
        "把本地文件上传到文档空间/知识库（可 --convert 转在线文档）时"
      ],
      "avoid_when": [
        "钉盘/我的文件上传优先 dws drive upload",
        "插入文档正文附件用 media insert"
      ],
      "examples": [
        "dws doc upload --file ./report.pdf --format json",
        "dws doc upload --file ./data.xlsx --workspace <WS_ID> --convert --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.upload",
        "cobra-help:dws doc upload",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#doc.upload",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "doc.version_list": {
      "agent_summary": "查看文档历史版本列表",
      "use_when": [
        "查看文档历史版本列表以确认版本号时"
      ],
      "avoid_when": [
        "回滚用 version revert（需确认）；保存快照用 version save"
      ],
      "examples": [
        "dws doc version list --node <DOC_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.version_list",
        "cobra-help:dws doc version list",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.list_doc_versions"
      ]
    },
    "doc.version_revert": {
      "agent_summary": "将文档回滚到指定历史版本",
      "use_when": [
        "用户明确要求将 adoc 回滚到指定历史版本（已从 version list 确认版本号）时"
      ],
      "avoid_when": [
        "只看版本列表用 version list；保存快照用 save",
        "版本号未确认或用户未同意回滚时不要执行"
      ],
      "examples": [
        "dws doc version revert --node <DOC_ID> --version 3 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.version_revert",
        "cobra-help:dws doc version revert",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.revert_doc_version"
      ]
    },
    "doc.version_save": {
      "agent_summary": "手动保存文档版本快照",
      "use_when": [
        "手动保存当前文档版本快照时"
      ],
      "avoid_when": [
        "回滚用 revert；只看历史用 list"
      ],
      "examples": [
        "dws doc version save --node <DOC_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=doc.version_save",
        "cobra-help:dws doc version save",
        "Skill:skills/mono/references/products/doc.md",
        "structured-hint:internal/cli/schema_hints/products/doc.json",
        "live-mcp:dws schema doc.save_doc_version"
      ]
    }
  },
  "products": {
    "doc": {
      "agent_summary": "管理钉钉在线文档的正文、块、评论、导入导出、模板与版本",
      "use_when": [
        "创建、读取或编辑在线文档内容，或处理文档块、评论、导入导出、模板和版本时"
      ],
      "avoid_when": [
        "文件、目录、上传下载及节点权限已迁移到 drive；知识库空间和成员使用 wiki；不要用于搜索开放平台开发文档"
      ],
      "reviewed": true,
      "review_reason": "依据真实 CommandRegistry 命令分区与对应产品 Skill 审阅产品级选择边界。",
      "source_refs": [
        "CommandRegistry:product=doc",
        "Skill:skills/mono/references/products/doc.md"
      ]
    }
  }
}