Skip to content

feat(drive): document copy workflow guidance - #2184

Open
SongHantian wants to merge 3 commits into
larksuite:mainfrom
SongHantian:auto-research-sync/01KYVM5CMVBXCSZWETFR6Y4VAQ/mr-1358-5fb17c0d
Open

feat(drive): document copy workflow guidance#2184
SongHantian wants to merge 3 commits into
larksuite:mainfrom
SongHantian:auto-research-sync/01KYVM5CMVBXCSZWETFR6Y4VAQ/mr-1358-5fb17c0d

Conversation

@SongHantian

@SongHantian SongHantian commented Aug 4, 2026

Copy link
Copy Markdown
Collaborator

Summary

Document the Drive file copy workflow so agents use the native copy API with stable parameters and avoid unnecessary schema, inspect, or metadata calls.

Changes

  • Added a dedicated Drive copy reference covering source selection, fixed drive files copy parameters, wiki/folder URL handling, post-copy editing boundaries, and error recovery.
  • Updated the Drive skill routing guidance for copy operations, title search uniqueness, authentication diagnostics, and the files.copy API exception.

Test Plan

  • git diff --check

Related Issues

Auto research task: 01KYVM5CMVBXCSZWETFR6Y4VAQ

Summary by CodeRabbit

  • New Features

    • Added guidance for copying Lark Drive files and online documents, including Wiki pages and folders.
    • Added step-by-step instructions for selecting source files, validating copy requests, editing copied content, and recovering from errors.
    • Improved search guidance for title and keyword matching, folder enumeration, and duplicate result handling.
  • Bug Fixes

    • Refined authentication checks to run only when needed or when authorization issues occur.
    • Clarified copy workflows for more reliable results.

@CLAassistant

CLAassistant commented Aug 4, 2026

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@coderabbitai

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 3283e846-ff26-426c-960b-10e218d51cf3

📥 Commits

Reviewing files that changed from the base of the PR and between 12742be and 8b0422f.

📒 Files selected for processing (1)
  • skills/lark-drive/SKILL.md

📝 Walkthrough

Walkthrough

This PR updates the Lark Drive skill documentation. It changes authentication diagnostics, defines title search rules, routes copying through a fixed contract, adds a schema exception for drive files copy, and documents copy source selection, token handling, editing, and error recovery.

Changes

Lark Drive Skill Documentation

Layer / File(s) Summary
Auth diagnostic and search rule updates
skills/lark-drive/SKILL.md
Authentication guidance is now read only for explicit identity checks or structured authentication-related errors. Search guidance uses drive +search for title and keyword queries, restricts files list to folder-child enumeration, stops on strict duplicate titles, and forbids positional parameters.
Copy workflow contract and reference document
skills/lark-drive/SKILL.md, skills/lark-drive/references/lark-drive-copy.md
Copy operations use the fixed contract in the new reference before execution. Schema lookup occurs only after structured parameter errors. The reference defines source selection, token and type handling, URL handling, post-copy edits, and error recovery. Export-then-import copying is prohibited.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

  • larksuite/cli#2159: Covers the same Lark Drive authentication, copy, search, and schema guidance changes.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description check ✅ Passed The description includes all required sections and clearly documents the scope, changes, verification command, and related task.
Title check ✅ Passed The title clearly and concisely identifies the main change: documenting the Drive copy workflow.
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

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

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added domain/ccm PR touches the ccm domain size/M Single-domain feat or fix with limited business impact labels Aug 4, 2026

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
skills/lark-drive/references/lark-drive-copy.md (1)

17-22: 🗄️ Data Integrity & Integration | 🔵 Trivial | 🏗️ Heavy lift

Add executable coverage for the fixed copy contract.

Lines 17-22 define the exact drive files copy request, but tests/cli_e2e/drive/coverage.md reports no workflow test for this command. Add a contract test that verifies --file-token, data.folder_token, data.name, and data.type, including rejection of a missing folder_token. Otherwise, a CLI change can silently invalidate this reference and the routing in skills/lark-drive/SKILL.md.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@skills/lark-drive/references/lark-drive-copy.md` around lines 17 - 22, Add
executable contract coverage for the `drive files copy` request documented in
`lark-drive-copy.md`, covering `--file-token`, `data.folder_token`, `data.name`,
and `data.type`. Include a negative case that rejects a missing `folder_token`,
and register the workflow in `tests/cli_e2e/drive/coverage.md` so changes to the
CLI contract or `skills/lark-drive/SKILL.md` routing are detected.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@skills/lark-drive/references/lark-drive-copy.md`:
- Around line 46-50: 在“错误恢复”部分补充 drive files copy 的未知结果处理:对超时、连接重置、5xx
等可能已到达服务端的传输失败不得自动重试;优先使用可用的幂等机制或结果核对,无法核对时先征得用户确认再重试,并保留现有确定性错误的停止规则。

---

Nitpick comments:
In `@skills/lark-drive/references/lark-drive-copy.md`:
- Around line 17-22: Add executable contract coverage for the `drive files copy`
request documented in `lark-drive-copy.md`, covering `--file-token`,
`data.folder_token`, `data.name`, and `data.type`. Include a negative case that
rejects a missing `folder_token`, and register the workflow in
`tests/cli_e2e/drive/coverage.md` so changes to the CLI contract or
`skills/lark-drive/SKILL.md` routing are detected.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91003c75-5e28-485a-be69-926189f4f313

📥 Commits

Reviewing files that changed from the base of the PR and between 811d37e and 9188319.

📒 Files selected for processing (2)
  • skills/lark-drive/SKILL.md
  • skills/lark-drive/references/lark-drive-copy.md

Comment thread skills/lark-drive/references/lark-drive-copy.md
@github-actions

github-actions Bot commented Aug 4, 2026

Copy link
Copy Markdown

🚀 PR Preview Install Guide

🧰 CLI update

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

🧩 Skill update

npx skills add SongHantian/cli#auto-research-sync/01KYVM5CMVBXCSZWETFR6Y4VAQ/mr-1358-5fb17c0d -y -g

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@skills/lark-drive/SKILL.md`:
- Line 13: 更新认证与确认路由规则,将未结构化但明确表示登录态失败的 Drive/API 错误(包括 `1061005 auth failed`
等资源引用中的错误)纳入读取 `../lark-shared/SKILL.md` 的认证诊断路径;保留 `invalid token`、`not
found`、`unsupported type` 及租户安全策略等确定性业务错误不触发诊断。
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: bd261e7f-b4d8-41a7-9b0f-905020f8231e

📥 Commits

Reviewing files that changed from the base of the PR and between 9188319 and 12742be.

📒 Files selected for processing (2)
  • skills/lark-drive/SKILL.md
  • skills/lark-drive/references/lark-drive-copy.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • skills/lark-drive/references/lark-drive-copy.md

Comment thread skills/lark-drive/SKILL.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

domain/ccm PR touches the ccm domain size/M Single-domain feat or fix with limited business impact

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants