docs (v1)
PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.
CODEBLOCK0
Helper Commands
| Command | Description |
|---|
+write | Append text to a document |
API Resources
documents
- batchUpdate — Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests.
- create — Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document.
- get — Gets the latest version of the specified document.
Discovering Commands
Before calling any API method, inspect it:
CODEBLOCK1
Use gws schema output to build your --params and --json flags.
技能名称: gws-docs
详细描述:
docs (v1)
前置条件: 请阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则。若文件缺失,请运行 gws generate-skills 创建。
bash
gws docs <资源> <方法> [标志]
辅助命令
API 资源
documents
- batchUpdate — 对文档应用一个或多个更新。每个请求在应用前都会经过验证。如果任何请求无效,则整个请求将失败,且不会应用任何内容。部分请求会返回回复,提供关于如何应用的信息;其他请求无需返回信息,每个此类请求返回空回复。回复的顺序与请求顺序一致。
- create — 使用请求中提供的标题创建空白文档。请求中的其他字段(包括任何提供的内容)将被忽略。返回创建的文档。
- get — 获取指定文档的最新版本。
发现命令
在调用任何 API 方法之前,请先检查它:
bash
浏览资源和方法
gws docs --help
检查方法的必需参数、类型和默认值
gws schema docs.<资源>.<方法>
使用 gws schema 的输出构建你的 --params 和 --json 标志。