pmai-publish-to-lark

Publishes local Markdown documents to Feishu cloud docs with fine-grained updates.

4|Updated May 26, 2026
One-click install
npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-publish-to-lark-yyg501
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pmai-publish-to-lark
Source: https://github.com/YYG501/PM-AI-Harness/tree/main/skills/publish-to-lark
Command: npx skills add https://github.com/YYG501/PM-AI-Harness --skill pmai-publish-to-lark-yyg501

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing local Markdown specs and PRDs to Feishu cloud documents often destroys existing images, comments, whiteboards, and attachments when done as a full overwrite. This Skill publishes or updates Feishu documents while preserving native content, and detects remote-side changes to avoid silent conflicts. ## Core Features & Use Cases - First-time publish and fine-grained update: Creates a new Feishu document when no binding exists, or performs minimal-diff writeback that preserves images, comments, whiteboards, and attachments on existing documents. - Table cell merging: Automatically merges repeated and continuation cells in GFM tables after publishing, copying rich-text content into anchor cells so multi-line requirement descriptions stay visible. - Concurrency guardrails: Tracks published revision IDs and source hashes in frontmatter; when the remote document has diverged, it writes nothing and hands off to the review workflow. - Use Case: After finalizing a module spec locally, run the publish command to push it to the team's Feishu wiki; later edits update only changed sections without wiping colleague comments. ## Quick Start Publish the file docs/modules/checkout-spec.md to Feishu using the publish-to-lark skill with document type spec.

Frequently Asked Questions about pmai-publish-to-lark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a Markdown file to a Feishu document?

Run the publish command with the Markdown path, for example /pmai-publish-to-lark docs/spec.md. On first publish you must provide a target wiki node or folder token plus a title, or configure defaults in .claude/lark-publish.json.

How to update a Feishu doc without losing comments and images?

Use the default fine-grained update mode, which diffs against the last aligned baseline and writes only changed sections. Full overwrite happens only when the user explicitly requests it, preserving native Feishu content otherwise.

What lark-cli version is required for Feishu publishing?

lark-cli 1.0.27 or higher is required because that release switched to fine-grained scope names. The preflight check verifies installation, version, login status, and scopes like docx:document:write_only before publishing.

What happens if the Feishu document was edited remotely?

If the remote revision has advanced beyond the stored baseline or the baseline is missing, the skill writes nothing and hands off to the lark-review workflow. This prevents silently overwriting changes made directly in Feishu.

Why are my Markdown tables merged incorrectly in Feishu?

The heuristic merger treats empty cells as continuation rows, which breaks data tables like permission matrices where empty means no data. Add a <!-- lark:no-merge --> comment directly above that table to skip merging for it.