feishu-cli-data について
Feishu Sheets と Bitable を操作するためのワークフロー Skill です。URL の判定、実行 ID の選択、書き込み前のプレビュー、画像セルの扱いに関するルールを示します。
主な機能
- 01Sheet と Bitable の作業を振り分け
- 02表の読み書きと書式設定
- 03フィールド、レコード、ビューの管理
- 04書き込み前の dry-run
- 05ネイティブ画像セルの書き込み手順
活用シーン
- 01Feishu URL に応じた手順の選択
- 02Bitable の一括編集前にフィールド型を確認
- 03書き込みをプレビューしてから実行
- 04Sheet のネイティブ画像セルへの画像追加
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ riba2534/ feishu-cli --skill feishu-cli-dataインストール後、Claude Code で/feishu-cli-dataを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/evals.jsonevals/fixtures/select-field.jsonreferences/workflows/bitable/workflow.mdreferences/workflows/sheet/workflow.mdreferences/workflows/sheet/references/basic-commands.md詳細
プロジェクトの README より飞书表格与多维表格
加载工作流后,将其中 references/、scripts/、templates/、examples/ 相对路径按该
workflow.md 所在目录解析;执行脚本时使用解析后的实际路径,不要依赖当前 shell 目录。
路由
| 意图 | 读取文件 |
|---|---|
| Sheet 创建、读写、样式、筛选视图、下拉、图片、导入导出 | references/workflows/sheet/workflow.md |
| Bitable/Base 表、字段、记录、视图、权限、表单、工作流 | references/workflows/bitable/workflow.md |
执行规则
- 先识别 URL:
/sheets/是 Sheet,/base/是 Bitable。 - Sheet 使用 spreadsheet token + sheet ID;Bitable 统一使用
--base-token,身份通过--as bot|user|auto控制。 - 写操作先用
--dry-run(命令支持时),批量操作先用少量记录验证字段类型。 - 不要把 Bitable field create 的 body 额外包进
field对象;直接使用命令帮助要求的字段 JSON。 - Sheet 写入单元格图片规则:单个图片使用
sheet image write-image <spreadsheet_token> <sheet_id> --range <cell> --image <path|url>;批量图片统一使用sheet image write-batch <spreadsheet_token> <sheet_id> --manifest <file|-|json>。严禁用 V2sheet write写=IMAGE(...)字符串公式,也严禁在sheet import-md中使用 Markdown 图片语法![](),两者均无法生成可渲染的原生图片单元格。命令统一支持本地路径与 HTTPS URL,写入原生图片单元格后均自动通过 V3read-rich回读验证image_token。
コメント
Markdown 対応