feishu-bitable-task-manager

Feishu Bitable タスクマネージャー

Feishu Bitable の「タスクステータステーブル」でタスクを読み書きする際に、このスキルを使用すると、スキーマの規約との互換性を保てます。

パスの規約

標準のインストールおよび実行ディレクトリ：~/.agents/skills/feishu-bitable-task-manager/。このディレクトリからコマンドを実行してください：

cd ~/.agents/skills/feishu-bitable-task-manager

単発実行（任意の作業ディレクトリからスクリプトやループで安全に実行できます）：

(cd ~/.agents/skills/feishu-bitable-task-manager && npx tsx scripts/bitable_task.ts --help)

クイックスタート

次を実行します：

npx tsx scripts/bitable_task.ts <subcommand> [flags]

必須の環境変数

• FEISHU_APP_ID、FEISHU_APP_SECRET
• TASK_BITABLE_URL
• 任意：FEISHU_BASE_URL
• 任意：TASK_FIELD_*（タスクテーブルの列名を上書きします）

主なデフォルト設定（互換性の規則）

• 日付プリセットは文字列リテラルとして扱います：Today、Yesterday、Any（Any は日付の制約なしを意味します）。
• 可能な場合は --task-id / --biz-task-id による取得を優先します（これらを指定すると --app/--scene/--status/--date は上書きされます）。
• デフォルトではビューのフィルタリングを無視します。明示的に有効にした場合のみビューのフィルタリングを使用します（references/task-fetch.md を参照）。
• デコード後の行のうち、TaskID != 0 かつ Params/ItemID/BookID/URL/UserID/UserName のいずれかを含むものだけを保持します。
• --status / --scene では、カンマ区切りの優先順位付きリストを使用できます。
• fetch は --limit に対応しています。--limit が設定されている場合、先に指定されたシーン／ステータスの値から入力されます。
• claim は単一タスクのみを対象とします。--limit は使用しないでください。--candidate-limit は候補の試行回数のみを制御します（references/task-claim.md を参照）。
• fetch と claim はどちらも、カンマ区切りの --scene 値を分割して、各シーンを順番に照会します（CSV 全体を単一のシーン文字列として扱わないでください）。
• JSON/JSONL を取り込む場合、列名と一致するキーはそのまま渡します。CDNURL / cdn_url がある場合は Extra にマッピングします。

コマンド

取得

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

確保（複数ワーカーでも安全）

npx tsx scripts/bitable_task.ts claim \
  --app com.tencent.mm \
  --scene 个人页搜索,综合页搜索 \
  --device-serial <serial> \
  --status pending,failed \
  --date Today \
  --candidate-limit 5

確保の動作の詳細は references/task-claim.md を参照してください。

更新

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

作成

npx tsx scripts/bitable_task.ts create \
  --input tasks.jsonl \
  --app com.smile.gifmaker \
  --scene 单个链接采集 \
  --status pending \
  --date YYYY-MM-DD \
  --skip-existing BizTaskID

ドラマの取得（読み取り専用）

オプションの BookID フィルターを指定して、ソースのドラマ用 Bitable から行を取得します。正規化されたドラマのメタデータフィールドが必要な呼び出し元は、--format meta を使用してください：

npx tsx scripts/drama_fetch.ts --bitable-url "<DRAMA_BITABLE_URL>" --book-id "id1,id2" --format meta

ソース Bitable（元の多次元テーブル）からタスクを作成

sync は --input または --bitable-url（必要に応じて --book-id も指定）を受け付け、タスクの作成を処理します：

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 は、作成するレコードのタスク日付と --skip-existing による重複除外フィルタリングの日付を設定します。省略した場合は今日がデフォルトになります。

Params モードのフラグ（相互に排他的）：

• --params-list — ソースの各行につき 1 つのタスクを作成します。Params はすべての検索語を含む JSON 配列です（例：["好一个乖乖女","段休冥 鹿鸣于"]）。
• --params-split — 検索語ごとに 1 つのタスクを作成します。--params-list と同じ重複排除ロジックを使用しますが、各タスクは通常の文字列 Params を持ちます。
• --params-actor — ソースの各行につき 1 つのタスクを作成します。Params には 主角名 のみを使用します。

リソース

• フィルター、ページネーション、検証、フィールドマッピングについては references/task-fetch.md を参照してください。
• マシン間で安全にタスクを確保する方法については references/task-claim.md を参照してください。
• ステータスの更新、タイミングフィールド、一括更新の規則については references/task-update.md を参照してください。
• 作成ペイロードの規則と一括作成の動作については references/task-create.md を参照してください。
• Feishu API のエンドポイントとリクエスト／レスポンスのペイロードについては references/feishu-integration.md を参照してください。
• フラグと動作の正確な情報は、scripts/bitable_task.ts / scripts/drama_fetch.ts / scripts/drama_sync_task.ts を参照してください。