feishu-bitable-task-manager — Claude Code skill
feishu-bitable-task-manager controls task records in Feishu Bitable through TypeScript CLI scripts to claim, fetch, sync, and update queue items.
MIT 103 installs ★ 2 updated 2026-02-28
npx skills add httprunner/skills --skill feishu-bitable-task-manager -a claude-codeWhat feishu-bitable-task-manager does
This skill exposes CLI utilities designed for Feishu Bitable task-status tables. It executes scripts/bitable_task.ts, scripts/drama_fetch.ts, and scripts/drama_sync_task.ts via npx tsx. You get dedicated subcommands to query pending jobs, push batched updates using JSONL payloads, and derive fresh tasks from primary source tables.
The claim command runs safely across concurrent worker machines and handles only one item per run. Missing FEISHU_APP_ID, FEISHU_APP_SECRET, or TASK_BITABLE_URL environment variables will immediately break API calls to Feishu.
What it helps with
- fetch task batches filtered by status, application, or business ID
- claim a single pending job safely across concurrent workers
- bulk update task records using JSONL input files
- generate queue tasks directly from source Feishu Bitable tables
Example prompts for the agent
- Fetch 10 pending tasks from Feishu Bitable for today
- Claim an available task for device serial worker-42 in scene search
- Sync records from the source drama table into our task table skipping duplicates
How to install feishu-bitable-task-manager
1Skills CLI (Vercel)
npx skills add httprunner/skills --skill feishu-bitable-task-manager -a claude-code2Manually: put the files in place
~/.claude/skills/feishu-bitable-task-manager/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/feishu-bitable-task-manager/
1Skills CLI (Vercel)
npx skills add httprunner/skills --skill feishu-bitable-task-manager -a codex2Manually: put the files in place
.agents/skills/feishu-bitable-task-manager/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add httprunner/skills --skill feishu-bitable-task-manager -a cursor2Manually: put the files in place
.cursor/skills/feishu-bitable-task-manager/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install httprunner/skills feishu-bitable-task-manager2Manually: put the files in place
.github/skills/feishu-bitable-task-manager/SKILL.md1Skills CLI (Vercel)
npx skills add httprunner/skills --skill feishu-bitable-task-manager -a gemini-cli2Platform CLI
gemini skills install https://github.com/httprunner/skills --path feishu-bitable-task-managerManually: put the files in place
.devin/skills/feishu-bitable-task-manager/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add httprunner/skills --skill feishu-bitable-task-manager -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about feishu-bitable-task-manager
How to install feishu-bitable-task-manager in Claude Code?
Run npx skills add httprunner/skills --skill feishu-bitable-task-manager -a claude-code in your terminal.
What does feishu-bitable-task-manager do?
It interfaces your coding agent with Feishu Bitable, allowing task querying, worker claiming, and structured batch record creation.
Which environment variables are required?
You must export FEISHU_APP_ID, FEISHU_APP_SECRET, and TASK_BITABLE_URL. FEISHU_BASE_URL and TASK_FIELD_* column overrides remain optional.
Source text
SKILL.md · MIT
--- name: feishu-bitable-task-manager description: Manage task records in Feishu Bitable (飞书多维表格) using a fixed task-status table schema and TASK_FIELD_* overrides. Use to fetch/claim/update/create tasks, look up drama metadata by BookID, or derive tasks from a source Bitable (JSON/JSONL in/out). --- # Feishu Bitable Task Manager Use this skill to read/write tasks in a Feishu Bitable “task status table” while staying compatible with its schema conventions. ## Path Convention Canonical install and execution directory: `~/.agents/skills/feishu-bitable-task-manager/`. Run commands from this directory: ```bash cd ~/.agents/skills/feishu-bitable-task-manager ``` One-off (safe in scripts/loops from any working directory): ```bash (cd ~/.agents/skills/feishu-bitable-task-manager && npx tsx scripts/bitable_task.ts --help) ``` ## Quick start Run: ```bash npx tsx scripts/bitable_task.ts <subcommand> [flags] ``` ## Required env - `FEISHU_APP_ID`, `FEISHU_APP_SECRET` - `TASK_BITABLE_URL` - Optional: `FEISHU_BASE_URL` - Optional: `TASK_FIELD_*` (override task table column names) ## Key defaults (compat rules) - Treat date presets as literal strings: `Today`, `Yesterday`, `Any` (`Any` means no date constraint). - Prefer fetching by `--task-id` / `--biz-task-id` when possible (it overrides `--app/--scene/--status/--date`). - Ignore view filtering by default; use view filtering only when explicitly enabled (see `references/task-fetch.md`). - Keep only decoded rows with `TaskID != 0` and at least one of `Params/ItemID/BookID/URL/UserID/UserName`. - Allow comma-separated priority lists for `--status` / `--scene`. - `fetch` supports `--limit`; earlier scene/status values are filled first when `--limit` is set. - `claim` is single-task only; do not use `--limit`. `--candidate-limit` only controls candidate attempts (see `references/task-claim.md`). - `fetch` and `claim` both split comma-separated `--scene` values and query each scene in order (do not treat the full CSV as one literal scene). - When ingesting JSON/JSONL, pass through keys that match column names; map `CDNURL`/`cdn_url` into `Extra` when present. ## Commands ### Fetch ```bash npx tsx scripts/bitable_task.ts fetch --app com.smile.gifmaker --scene 综合页搜索 --status pending --date Today --limit 10 npx tsx scripts/bitable_task.ts fetch --task-id "1326,1327" --raw npx tsx scripts/bitable_task.ts fetch --biz-task-id ext-20240101-001 --raw ``` ### Claim (multi-worker safe) ```bash npx tsx scripts/bitable_task.ts claim \ --app com.tencent.mm \ --scene 个人页搜索,综合页搜索 \ --device-serial <serial> \ --status pending,failed \ --date Today \ --candidate-limit 5 ``` Claim behavior details are in `references/task-claim.md`. ### Update ```bash npx tsx scripts/bitable_task.ts update --task-id 180413 --status running --device-serial <serial> --dispatched-at now npx tsx scripts/bitable_task.ts update --input updates.jsonl ``` ### Create ```bash npx tsx scripts/bitable_task.ts create \ --input tasks.jsonl \ --app com.smile.gifmaker \ --scene 单个链接采集 \ --status pending \ --date YYYY-MM-DD \ --skip-existing BizTaskID ``` ### Drama Fetch (read-only) Fetch rows from source drama Bitable by optional BookID filter. Use `--format meta` when callers need normalized drama metadata fields: ```bash npx tsx scripts/drama_fetch.ts --bitable-url "<DRAMA_BITABLE_URL>" --book-id "id1,id2" --format meta ``` ### Derive tasks from a source Bitable (原始多维表格) `sync` accepts either `--input` or `--bitable-url` (optionally with `--book-id`) and handles task creation: ```bash npx tsx scripts/drama_sync_task.ts \ --bitable-url "https://.../base/SOURCE_APP?table=SOURCE_TABLE" \ --task-url "https://.../base/TASK_APP?table=TASK_TABLE" \ --app com.smile.gifmaker \ --extra "test" \ --params-list \ --limit 10 \ --skip-existing \ --date 2026-02-10 ``` `--date YYYY-MM-DD` sets the task date for created records and for `--skip-existing` dedup filtering. Defaults to today when omitted. Params mode flags (mutually exclusive): - `--params-list` — one task per source row; `Params` is a JSON array of all search terms, e.g. `["好一个乖乖女","段休冥 鹿鸣于"]`. - `--params-split` — one task **per search term**; uses the same dedup logic as `--params-list` but creates separate tasks, each with a plain string `Params`. - `--params-actor` — one task per source row; `Params` uses only `主角名`. ## Resources - Read `references/task-fetch.md` for filters, pagination, validation, and field mapping. - Read `references/task-claim.md` for cross-machine safe task claiming. - Read `references/task-update.md` for status updates, timing fields, and batch update rules. - Read `references/task-create.md` for create payload rules and batch create behavior. - Read `references/feishu-integration.md` for Feishu API endpoints and request/response payloads. - Use `scripts/bitable_task.ts` / `scripts/drama_fetch.ts` / `scripts/drama_sync_task.ts` as the source of truth for flags and behavior.
© httprunner · MIT · httprunner/skills