feat: add doctor preflight for shortcut readiness

README.md

@@ -266,6 +266,15 @@ lark-cli schema calendar.events.instance_view
 lark-cli schema im.messages.delete
 ```
 
+### Command Preflight
+
+Use `doctor preflight` to check whether a shortcut is ready before executing it. This is especially useful for AI agents that need to know whether config, identity, login, scopes, or risk confirmations are still missing.
+
+```bash
+lark-cli doctor preflight calendar +agenda
+lark-cli doctor preflight im +messages-send --as bot
+```
+
 ## Security & Risk Warnings (Read Before Use)
 
 This tool can be invoked by AI Agents to automate operations on the Lark/Feishu Open Platform, and carries inherent risks such as model hallucinations, unpredictable execution, and prompt injection. After you authorize Lark/Feishu permissions, the AI Agent will act under your user identity within the authorized scope, which may lead to high-risk consequences such as leakage of sensitive data or unauthorized operations. Please use with caution.

README.zh.md

@@ -267,6 +267,15 @@ lark-cli schema calendar.events.instance_view
 lark-cli schema im.messages.delete
 ```
 
+### 命令前置体检
+
+使用 `doctor preflight` 在真正执行 shortcut 前检查是否已具备配置、身份、登录、scope 与风险确认条件，尤其适合 AI agent 在执行前先判断 readiness。
+
+```bash
+lark-cli doctor preflight calendar +agenda
+lark-cli doctor preflight im +messages-send --as bot
+```
+
 ## 安全与风险提示（使用前必读）
 
 本工具可供 AI Agent 调用以自动化操作飞书/Lark 开放平台，存在模型幻觉、执行不可控、提示词注入等固有风险；授权飞书权限后，AI Agent 将以您的用户身份在授权范围内执行操作，可能导致敏感数据泄露、越权操作等高风险后果，请您谨慎操作和使用。

cmd/doctor/doctor.go

@@ -43,6 +43,7 @@ func NewCmdDoctor(f *cmdutil.Factory) *cobra.Command {
 	}
 	cmdutil.DisableAuthCheck(cmd)
 	cmd.Flags().BoolVar(&opts.Offline, "offline", false, "skip network checks (only verify local state)")
+	cmd.AddCommand(NewCmdDoctorPreflight(f))
 
 	return cmd
 }