什麼是Meegle CLI

什麼是Meegle CLI

Meegle CLI 是一款命令列工具，可幫助您或 AI 工具更高效地訪問和操作Meegle中的各類資料。Meegle CLI 的核心價值，不在於增加一套新的使用方式，而在於為 AI 與Meegle之間建立穩定、可控、可執行的連線能力。在這一能力支援下，使用者可以將原本需要手動在頁面中完成的部分專案操作，轉化為透過自然語言交由 AI 助手協助完成，從而提升專案協作效率。 基於這項能力，AI 工具可以在授權範圍內完成與Meegle相關的讀取、查詢、建立和更新操作，例如：

• 查詢待辦、需求、任務、評論、工作流和排期等資訊
• 檢視工作項詳情、當前狀態及流程節點
• 建立需求、任務和子任務等專案事項
• 更新標題、優先順序、狀態、評論等欄位內容
• 在關鍵修改前先生成預覽，並在確認後執行

說明：Meegle CLI 已開源，詳情功能概覽見 Meegle CLI。

快速開始

前提條件

執行環境需要 Node.js >= 16（用於執行 CLI 命令）。

1.安裝 CLI

• 方式一：在終端中輸入以下資訊手動安裝
• 方式二：Agent 自動安裝。將以下指令直接複製傳送給你的 AI 工具（如 TRAE、Cursor、Codex、Claude Code），讓它替你完成安裝：

2.安裝 Skill

安裝完成後，npx skills add 會從倉庫讀取 skills/meegle/SKILL.md，寫入本機所有 Agent CLI 的 skill 目錄。每次升級重跑一遍即可拉取最新內容。

3.登入Meegle

請按照環境選擇一種方式登入Meegle。

• 有瀏覽器的本地終端。
• 無 TTY 環境。

說明：在 CI Runner、管道、Claude Code 等沒有 TTY 的非互動式環境中，請改用 Device Code 流程，該流程會輸出一個授權 URL，你可以在瀏覽器中開啟以完成授權。

• 無人值守 CI：跳過 auth login，直接注入環境變數。

4.驗證登入狀態

退出碼 0 表示 token 可用；非 0 時檢視 reason 欄位判斷是未登入還是 token 失效。

最佳實踐

場景一：階段進度梳理

使用場景：每週或每月彙總工作進度時，你需要手動梳理整個工作清單，逐一確認每個事項的狀態，再手動整理成文字總結。 最佳實踐：你可以直接對 AI 工具說：“幫我總結一下本月我一共處理了哪些工作項，還有哪些沒有處理。透過工作項的名稱，幫我總結一下本月的工作要點。” 結果展示：AI 工具會做的事情如下。

• 讀取你本週的待辦、已完成事項和延期事項
• 獲取工作項資訊
• 總結工作要點，輸出結果

場景二：會後快速建立需求和任務

使用場景：會議結束後，團隊往往面臨一個耗時的人工整理環節——需要把會議紀要逐條轉化為專案中的結構化需求和任務，頻繁在筆記、專案系統之間切換。 最佳實踐：你可以直接把會議紀要交給 AI，一句話說明意圖：“根據這段會議紀要，在【xx空間】裡整理出一個需求，並拆成若干子任務。” 結果展示：AI 工具會做的事情如下。

• 建立工作項，並設定標題、優先順序等基礎資訊
• 按流程推進狀態
• 從會議紀要中自動拆分子任務

AI 工具執行結果

Meegle效果

場景三：快速排查延期和風險事項

使用場景：專案推進到中後期時，不需要看所有資訊，而是需要快速找出哪些高優先順序需求還沒完成——這些往往是風險和瓶頸所在。 最佳實踐：你可以對 AI 工具說：“幫我篩一下【xx空間】裡所有高優先順序（P0、P1）但還沒完成的需求，並按優先順序排序，然後分析總結告訴我哪些最需要關注。” 結果展示：此時AI 工具會做的事情如下。

• 查詢待辦事項
• 按優先順序排序
• 分析推薦需要關注的需求

場景四：檢視工作項推進詳情

使用場景 在專案推進過程中，經常需要"深入到單個事項"瞭解進展，例如以下場景：

• 你聽到某個需求的進度可能有問題，想快速確認一下。
• 一個負責人跟你說他的工作被某個需求卡住了，你需要查證。
• 團隊例會上有人提到某個事項有風險，需要馬上深入瞭解。

• 你需要在彙報前快速確認某個關鍵需求的狀態。 最佳實踐 此時你可以直接對 AI 工具說：“幫我看看【xx】需求的資訊，當前狀態是什麼，還有沒有子任務沒完成，把評論資訊也給看看，幫我分析下卡點在哪裡。” 結果展示 此時 AI 工具會幫你查詢的資訊事情：

• 工作項詳情

• 當前工作流節點
• 是否還有未完成的子任務
• 總結分析通常怎麼推進更合理

場景五：團隊資源彙總與排期判斷

使用場景：安排新任務或規劃迭代時，最怕的是資源衝突——團隊關鍵成員在同一時間段已經被過度分配，導致新任務無人承接或進度延誤。 最佳實踐：直接對 AI 說：“幫我在這個【xx空間】檢視使用者1、使用者2的排期情況，有沒有明顯衝突，有新任務進來怎麼排期比較合理，用圖文結合呈現。” 結果展示：AI 將執行的工作如下。

• 檢視相關人員的排期。
• 結合工作項優先順序等總結總結分析人員排期，以及任務安排。
• 產出圖文結合分析報告。

場景六：流轉工作項節點

使用場景：當工作項完成某個階段後，需要推進到下一個流程節點（例如從"研發中"改為"待測試"，或從"待審批"改為"已批准"）。執行過程中涉及幾個問題：

• 不是所有節點都能流轉到任意節點，流程有特定的規則和路徑。
• 某些節點流轉前可能需要填寫特定欄位或獲得審批。

• 批次流轉多個工作項時，容易出現某些專案不符合條件而失敗的情況。 最佳實踐：直接對 AI 工具說：“先告訴我【xx】工作項當前可以流轉到哪些節點，我看了再決定。流轉前需要填什麼必填欄位嗎？” 結果展示：AI 將執行的工作如下。

• 查詢工作項當前的流程節點和所有可流轉的下一步選項

• 告訴你流轉前是否需要補充欄位資訊或獲得審批
• 生成流轉預覽，確認無誤後一鍵推進
• 如果流轉失敗，解釋具體原因（缺少必填欄位、許可權不足、流程規則限制等）

場景七：更新工作項資訊

使用場景：在需求開發過程中，經常需要更新工作項的各種資訊，例如：優先順序、負責人、標籤、截止時間、自定義欄位等。 最佳實踐：直接對 AI 工具說：“幫我把這個需求的標題改為"xx"，把優先順序改成 P0，負責人改成使用者1，然後補一句評論說明理由【xxx】。” 結果展示：AI 將執行的工作如下。

• 單個或批次更新工作項的欄位（標題、優先順序、負責人、標籤、截止時間等）
• 為更新操作補充評論說明，便於團隊瞭解變更原因

常見問題

MCP 和 CLI 有啥區別

Meegle MCP（Model Context Protocol）Server 和 CLI 並不是非此即彼的替代關係，而是 緊密的互補關係 。簡單來說，MCP 是底層的通訊協議，而 CLI 是面向最終消費者（人類使用者和 Agent）的產品化封裝。

維度	Meegle MCP Server	Meegle CLI
核心定位	解決 Agent 與服務的 通訊協議 （Tool 的註冊、發現與呼叫）。	解決通訊之外的 產品體驗 （OAuth 登入、環境一致性、使用者二次構建）。
受眾目標	純機器 / 大語言模型客戶端。	兼顧人類使用者的 直觀可讀 與機器的 結構化解析 。
Token 消耗	相對較高（需將全量 Tool Schema 注入上下文）。	顯著降低 （支援按需內省 Schema，可透過引數精確篩選控制長輸出）。
鑑權與安全	通常依賴 Agent 宿主環境進行配置，容易碎片化。	CLI 層 統一接管 Auth ，保障憑據安全，內建輸入驗證及多種登入方式。
場景編排	僅提供原子化的介面或能力工具。	針對高頻場景提供 內建命令編排 ，一行指令即可完成複雜操作。

我不是開發者，也能用嗎？

可以。對普通使用者來說，更適合把它理解為一項“讓 AI 能連線Meegle並代你辦事”的能力，而不是一個需要專門學習的技術工具。

AI 會不會亂改資料？

推薦透過“先預覽、後確認”的方式來避免誤操作。也就是說，AI 可以先展示準備執行的內容，等你確認後再真正落地。這也是最推薦給普通使用者的使用方式。

AI 的許可權來自哪裡？

來自你的賬號授權。AI 的能力受你本人在Meegle中的許可權約束，並不會額外獲得超出你許可權範圍的訪問能力。

怎樣提問會更有效？

如果你想讓 AI 更快、更準確地理解需求，建議儘量說清楚以下四件事：

• 物件：哪個專案、哪個需求、哪個團隊、哪些成員
• 動作：檢視、彙總、建立、更新、排期、評論
• 範圍：本週、這個月、某個迭代、某個優先順序、某個狀態
• 結果形式：簡要總結、列表、表格、彙報口吻、風險提示

推薦表達模板

你可以參考這個句式：“幫我檢視【物件】的【範圍】資訊，並按【結果形式】輸出。” 或者：“幫我在【物件】裡執行【動作】，先給我看執行計劃，確認後再處理。”

場景	示例表達
查詢類	幫我看一下本週分配給我的待辦。 幫我總結一下我這周已完成、進行中和延期的事項。 查一下這個需求的當前狀態、負責人和子任務進展。 看看這個專案裡所有高優先順序需求目前推進到哪裡了。
建立類	在【xx空間】裡建立一個需求，標題叫“最佳化登入體驗”，優先順序 P1。 根據這份會議紀要，在【xx】空間建立一個需求，並幫我拆成 5 個子任務，並給每個任務起標題。
更新類	把【xx】需求狀態改成研發中。 給【xx】需求補一句評論：已完成評審，今天開始開發。 先告訴我這個【xx】需求下一步能流轉到哪些狀態，我確認後再推進。
分析類	幫我判斷一下這個團隊（使用者）下週的資源是否緊張。 根據當前延期事項，幫我生成一個風險摘要。 把這些需求按緊急程度排序，並說明優先處理建議。

npm install -g @lark-project/meegle 幫我安裝Meegle CLI：https://github.com/larksuite/meegle-cli/blob/main/README.zh-CN.md#ai-agent-skill npx skills add larksuite/meegle-cli -y -g meegle auth login meegle auth login --device-code meegle config set user_access_token "your-user-token" meegle auth status