Skip to content

docs: add markdown domain template - #1293

Merged
fangshuyu-768 merged 1 commit into
mainfrom
codex/add-markdown-domain-template
Jun 5, 2026
Merged

docs: add markdown domain template#1293
fangshuyu-768 merged 1 commit into
mainfrom
codex/add-markdown-domain-template

Conversation

@fangshuyu-768

@fangshuyu-768 fangshuyu-768 commented Jun 5, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • add a dedicated skill-template/domains/markdown.md snippet so the markdown domain is represented alongside the other business-domain templates
  • carry over the merged markdown skill guidance for identity, quick routing, core boundaries, and out-of-scope Drive management cases
  • align cross-links in the new template with the existing skill-template/domains relative-path conventions

Context

The markdown skill updates from #1279 were merged into skills/lark-markdown/SKILL.md, but there was no corresponding domain template entry under skill-template/domains. This follow-up fills that gap on top of the latest main branch.

Testing

  • git diff --check

Summary by CodeRabbit

  • Documentation
    • Added Markdown domain documentation covering usage conventions, supported operations (create, diff, fetch, patch, overwrite), history retrieval, and operational scope limitations.

@coderabbitai

coderabbitai Bot commented Jun 5, 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

Run ID: 73e9643d-1bd8-4277-93ee-5eabffd8b461

📥 Commits

Reviewing files that changed from the base of the PR and between f3949f0 and 87a0bbb.

📒 Files selected for processing (1)
  • skill-template/domains/markdown.md

📝 Walkthrough

Walkthrough

This PR adds a new domain specification document for Markdown files within the skill template. The document establishes execution identity requirements, lists supported CLI operations (create, diff, fetch, patch, overwrite), clarifies the actual behavior of patch operations, and delineates which operations belong in the related lark-drive domain.

Changes

Markdown Domain Specification

Layer / File(s) Summary
Domain specification and operational boundaries
skill-template/domains/markdown.md
New domain specification document that clarifies Markdown file handling scope, requires --as user execution identity, documents supported lark-cli markdown commands, explains markdown +patch semantics (download, local replace, full-file overwrite), enforces non-empty content validation, and routes version history, imports, and cloud space operations to lark-drive.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • larksuite/cli#1279: Both PRs add/adjust Markdown skill documentation with overlapping scope on execution identity guidance and markdown +patch behavior constraints.

Suggested labels

size/M

Suggested reviewers

  • wittam-01

Poem

🐰 A Markdown map now marks the way,
With boundaries bright and rules to say:
Patch, fetch, and diff—what CLI can do,
And when to hop to lark-drive too! 📝

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the main change: adding a markdown domain template documentation to the project.
Description check ✅ Passed The PR description provides comprehensive context with summary, changes, and testing information, closely following the required template structure.
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 codex/add-markdown-domain-template

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 and usage tips.

@github-actions github-actions Bot added the size/S Low-risk docs, CI, test, or chore only changes label Jun 5, 2026
@codecov

codecov Bot commented Jun 5, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 70.33%. Comparing base (f3949f0) to head (87a0bbb).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #1293   +/-   ##
=======================================
  Coverage   70.33%   70.33%           
=======================================
  Files         672      672           
  Lines       65322    65322           
=======================================
  Hits        45941    45941           
  Misses      15728    15728           
  Partials     3653     3653           

☔ 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

github-actions Bot commented Jun 5, 2026

Copy link
Copy Markdown

🚀 PR Preview Install Guide

🧰 CLI update

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

🧩 Skill update

npx skills add larksuite/cli#codex/add-markdown-domain-template -y -g

@fangshuyu-768
fangshuyu-768 merged commit a75420f into main Jun 5, 2026
22 checks passed
@fangshuyu-768
fangshuyu-768 deleted the codex/add-markdown-domain-template branch June 5, 2026 07:48
tuxedomm pushed a commit to zhumiaoxin/cli that referenced this pull request Jun 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/S Low-risk docs, CI, test, or chore only changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants