decc-desrpc

Query and manage DECC DES-RPC channels, data rules, and field annotations for cross-region RPC routing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing cross-region RPC routing on the DECC platform requires navigating channels, data rules, version drafts, and DES field annotation requirements, where a single mislabeled field or premature submission can trigger an audit cycle lasting one to two weeks. This Skill lets you query and configure DES-RPC Caller/Callee Channels, data rules, and versions using business names like caller, callee, method, and VGeo instead of internal IDs. ## Core Features & Use Cases - Channel and Rule Queries: List DES-RPC channels, data rules (RPC methods / HTTP paths), and version histories, and inspect caller-to-callee routing across sites and VGeos. - End-to-End DES Tagging Workflow: Load IDL from BAM, parse it into json_schema, tag leaf fields with sync/catalog/entity/reason/description, and update version metadata before submission. - Two-Phase Submit Guard: submit_data_version first returns a full preview with schema completeness summary, and only submits the audit ticket after explicit human confirmation. - Use Case: You need to route a new RPC method between ROW-TT and EU. Create the channel and data rule, load and parse the IDL, tag all fields per the DES spec, review the generated preview, then confirm submission of the audit ticket. ## Quick Start Ask the agent to list all DES-RPC channels matching a service name in a given VGeo, for example by requesting to show channels like desrpc.test in ROW-TT.

Frequently Asked Questions about decc-desrpc

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

FAQPage Schema
How do I check cross-region RPC routing between a caller and callee service?

Use the query_caller_channel action with the callee channel name, optionally filtered by caller, method, caller_site, and callee_site. It returns the caller channels, sites, and per-method routing states showing how traffic flows between regions.

How do I tag DES fields on an RPC method before audit submission?

Run load_idl then parse_idl to build the json_schema, then call tag_fields with mode, catalog, entity, reason, and description. Use field_overrides with dotted paths like _response.item.p1 to set per-field descriptions before submitting.

Why does submit_data_version not actually submit on the first call?

The first call without confirmed:true returns a preview block containing version details, direction pairs, and a schema completeness summary instead of submitting. Only after a human reviews the preview and explicitly approves should you re-call with confirmed:true to create the audit ticket.

Why does DECC report description is empty even after tagging fields?

DECC validates node.description at the field top level, not des.description. If the description was written under the des object, submission fails; rerun tag_fields so descriptions are written to the correct location on both _request and _response sides.

What should I do when load_idl fails with endpoint not found?

This error means BAM has no IDL version for that RPC method. Confirm with the service owner whether a new IDL version should be created on BAM, then retry load_idl once the IDL exists.

Can I update a data version that is no longer in draft state?

update_data_version only works on draft versions. If the latest version is applied, reviewing, or cancelled, pass auto_create_if_no_draft:true so the agent creates a new draft version and applies your updates to it.