docs: guide document copy skill usage

[wittam-01]

Summary

Clarify that online Lark document copies should use the Drive file copy API instead of export/import or fetch/create reconstruction. This guides agents toward the native copy flow when users ask for document duplicates.

Changes

• Route document-copy requests from lark-doc to lark-drive and explicitly name lark-cli drive files copy.
• Add lark-drive guidance for online document copy, including wiki inspect handling, copy parameters, and confirmation-required retry behavior.
• Mark drive files copy as the preferred API resource for online document duplicates.

Test Plan

• Unit tests pass (not run; skill documentation-only change)
• Manual local verification confirms the lark-cli drive files copy flow works as expected
• node scripts/skill-format-check/index.js

Related Issues

• None

Summary by CodeRabbit

• Documentation
  • Clarified the recommended way to create a document copy (“save as copy”).
  • Added guidance to use the direct file copy capability instead of reconstructing content via export/import or fetch/create steps.
  • Expanded instructions for validating copy parameters and correctly handling high-risk flows that require user confirmation before retrying.

[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: 10755625-1c5a-4f43-83ea-2edd5374a94a

📥 Commits

Reviewing files that changed from the base of the PR and between 39be4c8 and 5bc9d97.

📒 Files selected for processing (2)

• skills/lark-doc/SKILL.md
• skills/lark-drive/SKILL.md

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

• skills/lark-doc/SKILL.md

---

📝 Walkthrough

Walkthrough

Two skill docs add copy-document routing guidance. lark-doc points copy requests to lark-drive, and lark-drive adds copy handling rules plus updated files.copy API guidance.

Changes

Copy document routing rules

Layer / File(s)	Summary
Copy routing rules and API guidance skills/lark-doc/SKILL.md, skills/lark-drive/SKILL.md	lark-doc adds a quick-decision bullet for copy requests. lark-drive adds copy-routing rules covering lark-cli drive files copy, schema verification, wiki token handling with drive +inspect, confirmation_required retry flow, and updated files.copy guidance.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested labels

documentation

Suggested reviewers

• fangshuyu-768

Poem

🐇 I saw a copy rule take flight,
With drive files copy shining bright.
No detours, no fuss,
Just clear paths for us,
And docs now hop along just right.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title is concise and clearly points to the document-copy skill guidance update.
Description check	✅ Passed	The description matches the template with Summary, Changes, Test Plan, and Related Issues sections filled in.
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.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/guide-drive-copy-skill

---

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.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.73%. Comparing base (22108c3) to head (5bc9d97).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1673      +/-   ##
==========================================
+ Coverage   74.71%   74.73%   +0.02%     
==========================================
  Files         810      811       +1     
  Lines       81881    81965      +84     
==========================================
+ Hits        61178    61258      +80     
- Misses      16135    16138       +3     
- Partials     4568     4569       +1     

☔ View full report in Codecov by Harness.
📢 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.

[github-actions]

🚀 PR Preview Install Guide

🧰 CLI update

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

🧩 Skill update

npx skills add larksuite/cli#docs/guide-drive-copy-skill -y -g