bpm

Manage BPM workflow tickets including status updates, detail queries, cancellation, and process logs.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill bpm-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bpm
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/bpm
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill bpm-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Engineers and approvers on the ByteDance BPM (流程平台) workflow platform often need to check ticket status, advance approvals, or cancel tickets without manually navigating the web UI across multiple regional environments. This Skill exposes all core BPM ticket operations through a single CLI interface. ## Core Features & Use Cases - Ticket Query & Detail: Retrieve full ticket details by workflow_id, or list tickets filtered by tenant, creator, assignee, finished state, and time range. - Approval Actions: Query available operations (get_op_keys) and advance ticket status (approve, reject, next step) with concurrency-safe current_status checks. - Multi-Region Support: Automatically maps vregion aliases (cn, sg, us, ttp, euttp) to the correct BPM domain and JWT type across CN, I18N, and TTP environments. - Use Case: An on-call engineer receives a BPM workflow ID in an alert and needs to check its current approval node, view process logs, and approve it on the Singapore environment without logging into the web console. ## Quick Start Ask the agent to get the detail of BPM ticket 879450 and list its process logs using the bpm skill.

Frequently Asked Questions about bpm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I approve or advance a BPM workflow ticket from the command line?

First call get_op_keys with the workflow_id to see available operations for the current status, then call update_status with the target status node and op_key such as approve or next. Pass current_status to guard against concurrent state changes.

How to list BPM tickets by creator or assignee?

Use the list_records action with creator, assignee, or multi_assignee filters, optionally combined with finished state (0 unfinished, 1 finished, 2 force-closed), target_system tenant, and time range. Results are paginated via page and page_size up to 999.

Does the BPM skill support international or TikTok environments?

Yes, the vregion parameter selects among nine regions including Singapore-Central, US-East, US-TTP, and EU-TTP, with aliases like sg, us, and ttp. The correct domain and JWT type (CN, I18N, or TTP-US) are chosen automatically.

Why does BPM update_status fail with Status has been changed error?

This error indicates a concurrency conflict where the ticket state changed between your read and write. Re-fetch the ticket detail, pass the latest state in the current_status parameter, and retry the update_status call.

What permissions are needed to cancel a BPM ticket?

Only the tenant administrator or the ticket creator can force-close an unfinished ticket using the cancel action. If you receive a permission denied error, verify your role or run gdpa-cli login for the correct region.