shiboken: recommend opt paths in build helpers

Shiboken asks other packages to use Cellar paths to Python's include
path. Rewrite these to use opt paths so that building against shiboken
still works after upgrading Python.

Resolves #34783.