code-explanation について
コード、アーキテクチャ、技術概念を対象者に合わせた深さで説明するスキルです。段階的な構成と例を使い、知識共有を支援します。
主な機能
- 01対象者に合わせた説明
- 02段階的な説明構成
- 03理解を助ける例
- 04正確さと明瞭さの確認
活用シーン
- 01コードやシステム動作の説明
- 02技術知識の共有
- 03フレームワークや分野概念の解説
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/code-explanationを入力して読み込まれたか確認します。
同梱ファイルreferences/explain.mdreferences/pedagogical-methodology.md
詳細
コードの説明
概要
適切な深さ、構成、例を用いて、コードや概念をわかりやすく説明します。対象者のレベルに合わせて出力を調整します。
使用する場面
- コード、アーキテクチャ、システムの動作を説明する
- 知識共有のための教育的な説明を作成する
- フレームワークやドメインの概念を明確にする
次の場合は使用しないでください：
- リクエストがドキュメントの生成に限られる場合（documentation-production を使用してください）
クイックリファレンス
| タスク | リファレンスを読み込む |
|---|---|
| 説明のワークフロー | skills/code-explanation/references/explain.md |
| 教育方法論 | skills/code-explanation/references/pedagogical-methodology.md |
ワークフロー
- 対象、対象者のレベル、形式を特定します。
- 説明のリファレンスを読み込みます。
- コードまたは概念を分析します。
- 段階的に深める構成で説明します。
- 正確性と明確さを検証します。
出力
- 例を含む、構成された説明
- 前提条件と今後の確認事項に関する注記
よくある間違い
- 対象者のレベルに合わせて調整しない
- ソースの動作を検証せずに説明する
コメント
Markdown 対応