Refactor: scheduler: best practices for clone_create_probe()

Rename to pcmk__clone_create_probe(), declare in library-private header,
add a doxygen block, and improve error-checking, comments, and formatting.