Refactor: scheduler: split pcmk__group_apply_coloc_score()

... into two functions, for code isolation and readability.
Also, add a doxygen block and improve argument validation.