[clang-tools-extra] [clang-tidy] Add check to diagnose coroutine-hostile RAII objects (PR #68738)

[Piotr Zegar via cfe-commits]

https://github.com/PiotrZSL approved this pull request.

Except few nits mainly in documentation, this looks fine for me.

https://github.com/llvm/llvm-project/pull/68738