dingtalk-document

This skill manages DingTalk knowledge bases and documents through DingTalk's official open-platform APIs. It solves the problem of programmatically working with DingTalk Wiki workspaces and documents: creating knowledge bases, listing workspaces and nodes, creating documents and folders, reading and writing document body content, and managing document member permissions. It is a strategy guide plus a helper script and API reference, triggered by mentions of DingTalk docs, knowledge bases, or related document operations in Chinese or English.

The skill centers on a task-first workflow: identify the operation, validate only the configuration keys that specific task needs, collect any missing values in a single prompt, then obtain a token and operator ID via the bundled dt_helper.sh script. Credentials (AppKey, AppSecret, user ID, and a derived unionId operator ID) are stored and read through the helper, with an explicit rule that credentials must never be printed in full (only a masked prefix is shown when confirming). API calls are issued against api.dingtalk.com endpoints for workspaces, nodes, documents, content blocks, and members; the reference documents read, overwrite, append, create, delete, and member-management operations along with error codes and required app permissions.

It targets developers and operators integrating DingTalk document automation into agent workflows, particularly in Chinese-language enterprise environments. The design shows security-conscious handling: official tooling, cached access tokens with a --nocache refresh on 401, and credential masking. Note that some operations are destructive by nature, such as full-document overwrite (marked irreversible) and document deletion, so care is warranted when invoking those against real content.