code-comments

SKILL.md

Write documentation that lives with the code it describes. Plain language. No jargon. Explain the why, not the what.

Co-location wins. Documentation in separate files drifts out of sync. Comments next to code stay accurate because they're updated together.

The "why" test: Before writing a comment, ask: "Does this explain why this code exists or why it works this way?" If it only restates what the code does, skip it.

明確で平易なコードコメントと、コードと一緒に存在するドキュメントを作成します。インライン ドキュメント (ファイル ヘッダー、関数ドキュメント、アーキテクチャ上の決定、説明コメントなど) が必要なコードを作成またはレビューするときに使用します。人間の読者と、同じ場所にあるコンテキストの恩恵を受ける AI コーディング アシスタントの両方向けに最適化されています。 ソース: petekp/claude-code-setup。

原文を見る