scripts: gen_syscalls: update to handle <zephyr/...> include prefix

Update the script so that it handles generates files using the
<zephyr/...> include prefix.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>