Agent Skill

讓你的 AI Agent 使用輕湖看板

三個純 Python 檔案即裝即用：無需 pip、無需 cryptography wheel、無需平台二進位。Agent 可列出、領取、建立與完成任務，內容始終在本機端對端加密。

skill v1.0.0

依平台安裝

選擇你的 Agent 平台，在執行 Agent 的機器上執行以下命令。

Skills 目錄: ~/.agents/skills

使用跨 Agent 共享目錄；倉庫級 .zcode/skills 亦可。

第 1 步 · 下載三個檔案並執行離線自檢

mkdir -p ~/.agents/skills/liteboard && cd ~/.agents/skills/liteboard \
  && curl -fsSL https://board.litelake.cn/skill/SKILL.md       -o SKILL.md \
  && curl -fsSL https://board.litelake.cn/skill/liteboard.py   -o liteboard.py \
  && curl -fsSL https://board.litelake.cn/skill/lite_crypto.py -o lite_crypto.py \
  && python3 ~/.agents/skills/liteboard/liteboard.py doctor --offline

需要 Python 3.9+。Windows 通常只有 `python` 沒有 `python3`，下列命令請把 `python3` 換成 `python`。

第 2 步 · 驗證安裝

python3 ~/.agents/skills/liteboard/liteboard.py --version
# 預期輸出：liteboard-skill 1.0.0
python3 ~/.agents/skills/liteboard/liteboard.py doctor --offline

設定

憑證存放在 ~/.lite-lake/lite-board/，不在 Skill 目錄內，更新 Skill 不會覆蓋。

主密碼

由你本人建立並保管該檔案；不要 cat、不要 echo、不要貼進對話。

主密碼

mkdir -p ~/.lite-lake/lite-board
chmod 700 ~/.lite-lake/lite-board
# Ask the user to write the tenant master password into master.key (never echo it).
chmod 600 ~/.lite-lake/lite-board/master.key

API Key 與登入

在 Web 端「設定 → Clients」建立 read_write Client，然後經 stdin 傳入 Key；`--api-key` 可用但不建議。

API Key 與登入

printf '%s\n' "$LITEBOARD_API_KEY" | python3 ~/.agents/skills/liteboard/liteboard.py login --api-key-stdin
# Windows: python ~/.agents/skills/liteboard/liteboard.py login --api-key-stdin

安全規則

不得列印或記錄 master.key、API Key、DEK 與 wrapped_dek，也不得放進模型上下文。破壞性操作先與使用者確認。AES 為查表實作，非嚴格常數時間：僅在可信本機執行。

更新

用 `--version` 對比上方版本徽章；發佈版本更新時重新執行三條 curl 即可，~/.lite-lake/lite-board/ 中的設定不受影響。