duplicate-event-merge
Merge duplicate video event candidates from the same camera, event type, ROI, related tracks, or overlapping time window. Use after event-rule-engine and before evidence generation or external output
SKILL.mdskills/custom/video_surveillance/duplicate-event-merge/SKILL.md
GitHubDuplicate Event Merge
Execution Priority
Prioritize calling this skill's scripts/run.py entrypoint first. Only write custom code after the script result is unsuitable or the script cannot cover the requested task.
Input Resolution
If event candidates are missing but the user provided a video or upstream analysis request, do not write custom duplicate merging or event generation code. First call event-rule-engine/scripts/run.py to produce candidate events, then call this skill to merge duplicates. Only ask for input when no event candidates can be produced or inferred.
Atomic CLI
Run this skill directly with its own script. The script does not call other skill scripts and does not depend on shared src, tools, or registry modules.
python duplicate-event-merge/scripts/run.py --events-json <events.json> --output <merged_events.json>
Parameters: --events-json, --output.
Workflow
- Read event candidates.
- Build duplicate keys from camera, event type, ROI, and related tracks.
- Merge confidence and time range.
- Return canonical events and duplicate mapping.
Available Implementation
This skill is implemented as an atomic standalone script in its own scripts/run.py. The script contains the executable logic for this skill and must not import shared src, tools, or registry modules.
Inputs
events: list of Event Candidate dictionaries
Outputs
Returns:
events: canonical merged eventsduplicates: mappings ofmain_event_idtomerged_event_id
Failure Modes
The current implementation tolerates empty input and returns empty outputs.
Constraints
Do not drop evidence metadata from the canonical event.