wecom-doclisted
Install: claude install-skill ai-dvps/comate
<objective>
Manage WeCom documents, smartpages (formerly "智能主页" / "智能文档"), uploads, and smartsheets through the `wecom doc:*` subcommands. Help the agent route URLs to the correct tool family, build oclif flag commands, and poll async export/read tasks to completion.
</objective>
<quick_start>
Read a document or sheet:
```bash
wecom doc:get-doc-content --docid DOCID --type 2
```
Create a document:
```bash
wecom doc:create-doc --doc-type 3 --doc-name "Weekly Report"
```
Upload an image to a document:
```bash
wecom doc:upload-doc-image --docid DOCID --file-path "images/chart.png"
```
Get smartsheet metadata:
```bash
wecom doc:smartsheet-get-sheet --docid DOCID
```
Add a record to a smartsheet:
```bash
wecom doc:smartsheet-add-records --docid DOCID --sheet-id SHEET --records '[{"field_values":{"Field1":"Value1"}}]'
```
Export every smartsheet in a document to one `.xlsx` file:
```bash
wecom doc:smartsheet-export-excel --docid DOCID --output ./export.xlsx
```
If `wecom` is not in PATH, use `npx wecom` or `${WECOM_CLI_PATH}`.
</quick_start>
<workflow>
1. **Verify CLI version**: Before any operation, check the installed CLI version:
```bash
wecom --version
```
Expected: `1.2.0` or higher. If lower, advise the user to update:
```bash
npm install -g @webank/wecom@latest
```
If `wecom` is not found, check `npx wecom --version` or `${WECOM_CLI_PATH} --version`.
If the CLI is not installed at all, advise installation:
```bash
npm install -g