Mote 技能
mote 技能教導 AI 代理程式 何時以及如何 使用 Mote 發布 Markdown——它本身不包含上傳實作(而是驅動 CLI 或 MCP 工具)。
技能可透過 skills 生態系統 CLI 安裝。
安裝
npx skills add flc1125/mote
有用的變體:
# 預覽儲存庫提供的內容
npx skills add flc1125/mote --list
# 安裝至特定代理程式
npx skills add flc1125/mote -a claude-code -a codex
# 非互動模式 (CI)
npx skills add flc1125/mote --skill mote -g -a claude-code -y
該技能存放於此儲存庫的 skills/mote/SKILL.md。
它包含了 agents/openai.yaml 中的 Codex 顯示元數據以及 assets/ 中捆綁的 Mote 圖示,
因此即使只安裝技能目錄,品牌標識仍然可用。
其他客戶端可以在沒有此可選 UI 元數據的情況下使用 SKILL.md。
品牌素材維護在 docs/assets 中;更改後請執行 node scripts/brand/sync.mjs。
現有的品牌檢查也會驗證技能的圖示副本。
功能說明
一旦安裝,當代理程式被要求線上發布 Markdown 或建立可分享的 URL 時,它將會:
- 檢查本地圖片並選擇一個已配置的發布路徑。
publish_markdown接受文字和遠端圖片 URL;本地圖片則需要 CLI 或本地publish_markdown_file,且路徑會相對於 Markdown 檔案解析。 - 發布並解析結果
- 原樣返回 URL
它同時編碼了護欄:絕不發布憑證/機密(Mote URL 是功能性的,文件是不可變的), 尊重大小限制,並如實報告錯誤。
僅閱讀、編輯或預覽本地文件不會觸發布。 指向其他本地文件的連結不會自動發布那些文件。 關於公式、圖表及其他擴充,請參閱相容性參考 和即時範例。不支援的語法在發布成功時仍可保持為可讀原始碼。
需求
技能本身僅是指令——發布仍然需要:
- mote-cli 套件或原始碼建置,並具有明確的身份驗證配置或有效的 Mote OAuth 登入(請參閱 CLI 參考 和 身份驗證)。自託管使用者應保留其預期的實例配置,或
- 已連接的 Mote MCP 伺服器(請參閱 MCP 指南)
只有本地伺服器暴露 publish_markdown_file。身份驗證失敗必須向使用者回報;技能不會建立憑證、未經授權啟動瀏覽器登入、讀取其他客戶端的鑰匙圈或切換到舊的令牌。明確要求登入協助的請求可以在使用者授權範圍內處理。不要在未解決是否成功的情況下,在逾時或未知結果後重複發布。