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

[Piotr Zegar via cfe-commits]

https://github.com/PiotrZSL requested changes to this pull request.

>From functional point of view doesn't look do bad.
My main concerns is about that 3 nested for-loops and ifs, this need to be refactored to show more clear that it's trying to match varDecl defined before suspension point.

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