Skip to content

feat: add markdown shortcuts and skill docs #716

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wittam-01 wants to merge 2 commits into from
Closed

feat: add markdown shortcuts and skill docs #716

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
14be4ab
feat: add markdown shortcuts and skill docs
wittam-01 Apr 29, 2026
6cb35c8
feat: add drive version shortcuts
wittam-01 Apr 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

[中文版](./README.zh.md) | [English](./README.md)

The official [Lark/Feishu](https://www.larksuite.com/) CLI tool, maintained by the [larksuite](https://github.com/larksuite) team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Slides, Calendar, Mail, Tasks, Meetings, and more, with 200+ commands and 23 AI Agent [Skills](./skills/).
The official [Lark/Feishu](https://www.larksuite.com/) CLI tool, maintained by the [larksuite](https://github.com/larksuite) team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Slides, Calendar, Mail, Tasks, Meetings, Markdown, and more, with 200+ commands and 23 AI Agent [Skills](./skills/).
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot Apr 29, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

The skill count needs to be updated.

This line still says 23 AI Agent Skills, but the table below now lists 24 after adding lark-markdown. Please update the numeric references here and the matching 23 counters later in the file.

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 9, Update the README references that still say "23" to
"24": change the phrase "23 AI Agent [Skills]" in the introductory sentence to
"24 AI Agent [Skills]" and update any other literal "23" counters elsewhere in
the file (e.g., table summaries or badges that count skills) to "24" so they
match the added lark-markdown entry; search for the string "23" and replace the
occurrences that refer to skill counts, leaving unrelated "23" values untouched.


[Install](#installation--quick-start) · [AI Agent Skills](#agent-skills) · [Auth](#authentication) · [Commands](#three-layer-command-system) · [Advanced](#advanced-usage) · [Security](#security--risk-warnings-read-before-use) · [Contributing](#contributing)

Expand All @@ -28,6 +28,7 @@ The official [Lark/Feishu](https://www.larksuite.com/) CLI tool, maintained by t
| 💬 Messenger | Send/reply messages, create and manage group chats, view chat history & threads, search messages, download media |
| 📄 Docs | Create, read, update, and search documents, read/write media & whiteboards |
| 📁 Drive | Upload and download files, search docs & wiki, manage comments |
| 📝 Markdown | Create, fetch, and overwrite Drive-native `.md` files |
| 📊 Base | Create and manage tables, fields, records, views, dashboards, workflows, forms, roles & permissions, data aggregation & analytics |
| 📈 Sheets | Create, read, write, append, find, and export spreadsheet data |
| 🖼️ Slides | Create and manage presentations, read presentation content, and add or remove slides |
Expand Down Expand Up @@ -139,6 +140,7 @@ lark-cli auth status
| `lark-im` | Send/reply messages, group chat management, message search, upload/download images & files, reactions |
| `lark-doc` | Create, read, update, search documents (Markdown-based) |
| `lark-drive` | Upload, download files, manage permissions & comments |
| `lark-markdown` | Create, fetch, and overwrite Drive-native Markdown files |
| `lark-sheets` | Create, read, write, append, find, export spreadsheets |
| `lark-slides` | Create and manage presentations, read presentation content, and add or remove slides |
| `lark-base` | Tables, fields, records, views, dashboards, data aggregation & analytics |
Expand Down
4 changes: 3 additions & 1 deletion README.zh.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

[中文版](./README.zh.md) | [English](./README.md)

飞书官方 CLI 工具，由 [larksuite](https://github.com/larksuite) 团队维护 — 让人类和 AI Agent 都能在终端中操作飞书。覆盖消息、文档、多维表格、电子表格、幻灯片、日历、邮箱、任务、会议等核心业务域，提供 200+ 命令及 23 个 AI Agent [Skills](./skills/)。
飞书官方 CLI 工具，由 [larksuite](https://github.com/larksuite) 团队维护 — 让人类和 AI Agent 都能在终端中操作飞书。覆盖消息、文档、多维表格、电子表格、幻灯片、日历、邮箱、任务、会议、Markdown 等核心业务域，提供 200+ 命令及 23 个 AI Agent [Skills](./skills/)。
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot Apr 29, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

The skill count is stale after adding lark-markdown.

This intro still says 23 AI Agent Skills, but the table below now lists 24. Please sync the numeric references here and the matching 23 counters later in the file.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~9-~9: 数量词修饰并列短语，可能产生歧义
Context: ...团队维护 — 让人类和 AI Agent 都能在终端中操作飞书。覆盖消息、文档、多维表格、电子表格、幻灯片、日历、邮箱、任务、会议、Markdown 等核心业务域，提供 ...

(s5)

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@README.zh.md` at line 9, The README Chinese intro text still states "23 AI
Agent Skills" but the skills list includes the new lark-markdown for a total of
24; update the numeric references in README.zh.md (the introductory sentence
containing "23 AI Agent Skills" and any other occurrences of "23" used as
counters) to "24" so they match the skills table and the added lark-markdown
entry.


[安装](#安装与快速开始) · [AI Agent Skills](#agent-skills) · [认证](#认证) · [命令](#三层命令调用) · [进阶用法](#进阶用法) · [安全](#安全与风险提示使用前必读) · [贡献](#贡献)

Expand All @@ -28,6 +28,7 @@
| 💬 即时通讯 | 发送/回复消息、创建和管理群聊、查看聊天记录与话题、搜索消息、下载媒体文件 |
| 📄 云文档 | 创建、读取、更新文档、搜索文档、读写素材与画板 |
| 📁 云空间 | 上传和下载文件、搜索文档与知识库、管理评论 |
| 📝 Markdown | 创建、读取、覆盖更新 Drive 中的原生 `.md` 文件 |
| 📊 多维表格 | 创建和管理数据表、字段、记录、视图、仪表盘、自动化流程、表单、角色权限，数据聚合分析 |
| 📈 电子表格 | 创建、读取、写入、追加、查找和导出表格数据 |
| 🖼️ 幻灯片 | 创建和管理演示文稿、读取演示文稿内容，以及新增或删除幻灯片页面 |
Expand Down Expand Up @@ -140,6 +141,7 @@ lark-cli auth status
| `lark-im` | 发送/回复消息、群聊管理、消息搜索、上传下载图片与文件、表情回复 |
| `lark-doc` | 创建、读取、更新、搜索文档（基于 Markdown） |
| `lark-drive` | 上传、下载文件，管理权限与评论 |
| `lark-markdown` | 创建、读取、覆盖更新 Drive 中的原生 Markdown 文件 |
| `lark-sheets` | 创建、读取、写入、追加、查找、导出电子表格 |
| `lark-slides` | 创建和管理演示文稿、读取演示文稿内容，以及新增或删除幻灯片页面 |
| `lark-base` | 多维表格、字段、记录、视图、仪表盘、数据聚合分析 |
Expand Down
4 changes: 2 additions & 2 deletions internal/core/types.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ func ResolveEndpoints(brand LarkBrand) Endpoints {
}
default:
return Endpoints{
Open: "https://open.feishu.cn",
Accounts: "https://accounts.feishu.cn",
Open: "https://open.feishu-pre.cn",
Accounts: "https://accounts.feishu-pre.cn",
Comment on lines +43 to +44
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot Apr 29, 2026

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical

Do not switch the default Feishu brand to pre-production endpoints.

ResolveEndpoints() feeds every normal Feishu request URL, so this reroutes standard --brand feishu API/auth traffic to open.feishu-pre.cn / accounts.feishu-pre.cn. That is a global behavior break, and it also leaves MCP on prod, so the default environment becomes inconsistent.

Suggested fix 
 		return Endpoints{
-			Open:     "https://open.feishu-pre.cn",
-			Accounts: "https://accounts.feishu-pre.cn",
+			Open:     "https://open.feishu.cn",
+			Accounts: "https://accounts.feishu.cn",
 			MCP:      "https://mcp.feishu.cn",
 		}
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Open: "https://open.feishu-pre.cn",
Accounts: "https://accounts.feishu-pre.cn",
return Endpoints{
Open: "https://open.feishu.cn",
Accounts: "https://accounts.feishu.cn",
MCP: "https://mcp.feishu.cn",
}
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@internal/core/types.go` around lines 43 - 44, The default Feishu endpoints
were changed to pre-production hosts (Open: "https://open.feishu-pre.cn",
Accounts: "https://accounts.feishu-pre.cn") which causes ResolveEndpoints() to
route normal `--brand feishu` traffic to preprod; revert these Open and Accounts
values back to the production Feishu endpoints (restore the prod hostnames) in
the types/endpoint mapping and ensure ResolveEndpoints() continues to select the
prod mapping for the default `feishu` brand so MCP and other services remain
consistent.

MCP: "https://mcp.feishu.cn",
}
}
Expand Down
Loading
Loading