jpskill.com
💬 コミュニケーション コミュニティ

global-commenting

複雑な処理やビジネスロジックを説明する際に、自明な記述や一時的な変更は避け、PHPやTypeScriptなどのコードを対象に、可読性の高い構造と命名でコード自体を説明的にし、必要最小限で普遍的なコメントを作成・レビューするSkill。

📜 元の英語説明(参考)

Write minimal, evergreen code comments that explain complex logic without documenting obvious behavior or temporary changes. Use this skill when adding comments to PHP files, TypeScript/JavaScript files, or any code files, when documenting complex algorithms or business logic, when adding PHPDoc blocks or JSDoc comments, when writing self-documenting code with clear naming, or when reviewing existing comments for relevance and necessity. Focus on keeping code self-explanatory through clear structure and naming rather than relying heavily on comments.

🇯🇵 日本人クリエイター向け解説

一言でいうと

複雑な処理やビジネスロジックを説明する際に、自明な記述や一時的な変更は避け、PHPやTypeScriptなどのコードを対象に、可読性の高い構造と命名でコード自体を説明的にし、必要最小限で普遍的なコメントを作成・レビューするSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o global-commenting.zip https://jpskill.com/download/18625.zip && unzip -o global-commenting.zip && rm global-commenting.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/18625.zip -OutFile "$d\global-commenting.zip"; Expand-Archive "$d\global-commenting.zip" -DestinationPath $d -Force; ri "$d\global-commenting.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して global-commenting.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → global-commenting フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

グローバルコメント

この Skill は、グローバルコメントの扱い方に関するコーディング標準を遵守する方法について、Claude Code に具体的なガイダンスを提供します。

この Skill を使用する場面

  • PHP、TypeScript、JavaScript、または任意のコードファイルにコメントを追加する場合
  • すぐには理解できない複雑なビジネスロジックやアルゴリズムをドキュメント化する場合
  • PHP クラス、メソッド、または関数に対して PHPDoc ブロックを記述する場合
  • TypeScript/JavaScript 関数に対して JSDoc または TSDoc コメントを追加する場合
  • 自明ではないコードの決定の背後にある「理由」を説明する場合
  • コードをより自己文書化するようにリファクタリングし、コメントの必要性を減らす場合
  • 既存のコメントが常に最新であり、依然として関連性があることを確認するためにレビューする場合
  • 一時的な修正や最近の変更に関する古いコメントを削除する場合
  • PHPDoc で複雑な配列の形状やデータ構造をドキュメント化する場合
  • コメントを追加するか、明確にするためにリファクタリングするかを選択する場合

指示

詳細については、次のファイルに記載されている情報を参照してください。 global commenting

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Global Commenting

This Skill provides Claude Code with specific guidance on how to adhere to coding standards as they relate to how it should handle global commenting.

When to use this skill

  • When adding comments to PHP, TypeScript, JavaScript, or any code files
  • When documenting complex business logic or algorithms that aren't immediately obvious
  • When writing PHPDoc blocks for PHP classes, methods, or functions
  • When adding JSDoc or TSDoc comments for TypeScript/JavaScript functions
  • When explaining the "why" behind non-obvious code decisions
  • When refactoring code to be more self-documenting and reduce comment necessity
  • When reviewing existing comments to ensure they're evergreen and still relevant
  • When removing outdated comments about temporary fixes or recent changes
  • When documenting complex array shapes or data structures in PHPDoc
  • When choosing between adding a comment vs. refactoring for clarity

Instructions

For details, refer to the information provided in this file: global commenting