feat(whiteboard): pin whiteboard-cli to v0.2.11 in lark-whiteboard skill

[zkh-bytedance]

Summary

Related Issues

• None

Summary by CodeRabbit

• Documentation
  • Updated whiteboard CLI references to use @larksuite/whiteboard-cli@^0.2.11 across docs and examples.
  • Enhanced image preparation guide with strict constraints, source-specific retrieval guidance, unified download/upload notes, and expanded troubleshooting for token/domain mismatches.
  • Improved command examples to include a two-phase (dry-run + confirm) workflow for safer whiteboard operations.

[github-actions]

🚀 PR Preview Install Guide

🧰 CLI update

npm i -g https://pkg.pr.new/larksuite/cli/@larksuite/cli@bd45b69eec38ea2b29b3d9f7d87f53c30b87ac58

🧩 Skill update

npx skills add larksuite/cli#feat/whiteboard-skill-cli-v0.2.11 -y -g

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 82b10886-14b5-4a37-a62d-134377b6fa1d

📥 Commits

Reviewing files that changed from the base of the PR and between ac4bbbe and bd45b69.

📒 Files selected for processing (13)

• skills/lark-whiteboard/SKILL.md
• skills/lark-whiteboard/references/image.md
• skills/lark-whiteboard/references/lark-whiteboard-update.md
• skills/lark-whiteboard/references/layout.md
• skills/lark-whiteboard/references/schema.md
• skills/lark-whiteboard/routes/dsl.md
• skills/lark-whiteboard/routes/mermaid.md
• skills/lark-whiteboard/routes/svg.md
• skills/lark-whiteboard/scenes/bar-chart.md
• skills/lark-whiteboard/scenes/fishbone.md
• skills/lark-whiteboard/scenes/flywheel.md
• skills/lark-whiteboard/scenes/line-chart.md
• skills/lark-whiteboard/scenes/treemap.md

✅ Files skipped from review due to trivial changes (13)

• skills/lark-whiteboard/SKILL.md
• skills/lark-whiteboard/scenes/fishbone.md
• skills/lark-whiteboard/scenes/line-chart.md
• skills/lark-whiteboard/scenes/treemap.md
• skills/lark-whiteboard/scenes/bar-chart.md
• skills/lark-whiteboard/references/lark-whiteboard-update.md
• skills/lark-whiteboard/references/layout.md
• skills/lark-whiteboard/scenes/flywheel.md
• skills/lark-whiteboard/routes/mermaid.md
• skills/lark-whiteboard/routes/svg.md
• skills/lark-whiteboard/references/image.md
• skills/lark-whiteboard/references/schema.md
• skills/lark-whiteboard/routes/dsl.md

---

📝 Walkthrough

Walkthrough

This PR updates lark-whiteboard documentation: (1) clarifies image media upload requirements and troubleshooting (must obtain whiteboard-domain media tokens via docs +media-upload before referencing images), and (2) bumps all @larksuite/whiteboard-cli example invocations from ^0.2.10 to ^0.2.11.

Changes

Whiteboard CLI Documentation Update

Layer / File(s)	Summary
Image media upload workflow clarification skills/lark-whiteboard/references/image.md	Mandates uploading images with docs +media-upload --parent-type whiteboard --parent-node <target-board> to obtain whiteboard-domain media tokens; adds a table of image acquisition methods (local, URL, docx_image token, external Drive token), removes an old curl download example, and updates common-errors to attribute 500 (2891001) and disappearing images to non-whiteboard-domain tokens and token/board mismatches.
Whiteboard CLI version ^0.2.11 bump skills/lark-whiteboard/SKILL.md, skills/lark-whiteboard/references/lark-whiteboard-update.md, skills/lark-whiteboard/references/layout.md, skills/lark-whiteboard/references/schema.md, skills/lark-whiteboard/routes/dsl.md, skills/lark-whiteboard/routes/mermaid.md, skills/lark-whiteboard/routes/svg.md, skills/lark-whiteboard/scenes/bar-chart.md, skills/lark-whiteboard/scenes/fishbone.md, skills/lark-whiteboard/scenes/flywheel.md, skills/lark-whiteboard/scenes/line-chart.md, skills/lark-whiteboard/scenes/treemap.md	Replaces @larksuite/whiteboard-cli@^0.2.10 with @^0.2.11 in all example invocations for validation, rendering, OpenAPI conversion, icon listing, and scene rendering instructions.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• larksuite/cli#649: Also updates whiteboard-cli version references in lark-whiteboard docs.
• larksuite/cli#617: Prior whiteboard-cli version change in documentation.
• larksuite/cli#502: Earlier whiteboard documentation and workflow refactor related to image/media handling.

Suggested labels

domain/ccm

Suggested reviewers

• syh-cpdsss
• ZKHelloworld

Poem

🐰 I hopped through docs to tidy the trail,
Tokens now find the whiteboard's own vale,
CLI versions bumped, commands hum in tune,
Images land rightly beneath the same moon,
A rabbit nods—clear docs make builders sail.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The PR description lacks critical required sections: no Summary motivation/scope explanation, no Changes list detailing the updates, and no Test Plan validation details.	Add a Summary explaining why v0.2.11 is needed, list the specific documentation files updated, and describe how the changes were tested or verified.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically describes the main change: pinning whiteboard-cli to v0.2.11 across lark-whiteboard skill documentation files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/whiteboard-skill-cli-v0.2.11

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 65.85%. Comparing base (1ee7f22) to head (bd45b69).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #850   +/-   ##
=======================================
  Coverage   65.85%   65.85%           
=======================================
  Files         517      517           
  Lines       48761    48761           
=======================================
  Hits        32113    32113           
  Misses      13885    13885           
  Partials     2763     2763           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.