飞书文档API技能

**Quick judgment** Mature, feature-rich Feishu Docx automation skill that covers most practical needs around document lifecycle, content conversion, and permissions. Well-suited for teams already standardized on Feishu/Lark who want programmable document workflows. **Strengths & capabilities** - Supports full CRUD for Feishu Docx documents plus folder listing and keyword search. - Handles block-level operations (list, insert child blocks, update, delete, batch delete) with automatic pagination, enabling manipulation of large or structured documents. - Provides Markdown/HTML → Feishu block conversion via Feishu APIs and local helpers (markdownToBlocks, blocksToMarkdown), making it easy to publish or sync content from developer-friendly formats. - Includes permission operations (add permission members, list members), supporting automated access management. - Implements access token caching and refresh, identifies Feishu-specific expiry codes, and includes limited automatic retries with backoff for rate limiting and transient server errors. **Key risks / limitations** - **Destructive operations**: Full content replacement, block deletion, and document deletion (via Drive API) can cause irreversible data loss if misused. Workflows should include safeguards (backups, dry-runs, or review steps) before destructive calls. - **Permission scope risk**: The Feishu app must have broad permissions (docs:doc, drive:drive, drive:file). Misconfigured permission flows or overly privileged apps could expose sensitive documents if combined with aggressive sharing automation. - **External dependency**: Reliability and latency depend on Feishu’s APIs (rate limits, regional access, service availability). Heavy or high-frequency workflows must consider rate limiting (429) and 5xx behaviors despite built-in retries. - **Operational setup**: Requires correct configuration of FEISHU_APP_ID/FEISHU_APP_SECRET and Feishu app permissions. Non-technical users may struggle without tooling or wrappers. **Recommended scenarios** - CI/CD or internal automation that publishes Markdown/HTML documents (design docs, release notes, technical specs) into Feishu Docx on every change. - Bots or services that regularly append updates to existing documents (daily standup notes, weekly reports, incident timelines) while keeping structure consistent. - Internal admin tools for managing document lists within folders and keeping permissions synchronized with team membership. - Migration or synchronization flows between external content sources (repos, wikis) and Feishu, leveraging the conversion utilities and block-level control.