メインコンテンツまでスキップ

explain-html plugin

explain-html Skillと、Archifyによる図の完了検査を呼ぶClaude Code用Stop hookをまとめたpluginです。解説HTMLに掲載する図について、モデル・配布HTML・標準SVG・記事画像の一致を検査します。

渡す情報​

解説したい題材と保存先を用意します。完成検査の対象には、図の担当・成果物を記録したmanifestと記事HTMLが必要です。配布物の生成にはPython 3、検査にはSkill正本に記載されたPython・Node.jsの実行環境を使います。Codex用hook adapterは未提供です。

依頼例​

explain-htmlで、HTTPリクエストがサーバーに届くまでの仕組みを解説してください。
通信の流れを図で示し、完成時に図と記事の検査結果を確認したいです。

進め方​

  1. 導入を始めるの手順でClaude Code用配布物を生成し、Agentでの読み込みを確認します。
  2. 題材を伝え、Skillの手順で記事と図を制作します。
  3. 対象プロジェクトの.explain-html-active.jsonに、manifestと記事HTMLの相対パスを指定します。具体例はArchifyゲートの正本を参照します。未紐付けのプロジェクトにはhookは介入しません。
  4. 完成時は生成CLIの検査とStop hookの結果を確認します。Claude Codeには連続blockの上限があるため、hookと生成CLIを併用します。

成果物の例​

サブエージェントが正本のビルド処理からClaude Code用ZIPを生成しました。ZIPを展開し、manifest・hooks設定とSkillの全ファイルが正本と一致することを検証しています。

実行入力、検証結果、実行記録を確認できます。

この例は配布物の生成と内容検証までです。インストール・有効化・実クライアント上のStop hook動作は未実施です。解説HTML自身の例はSkillガイドを参照してください。

確認するポイント​

  • Claude Code用の配布物を選んでいるか。
  • 対象プロジェクトと、検査するmanifest・記事HTMLの紐付けが正しいか。
  • 図の一致検査と、文章や図の意味・読みやすさの確認を区別しているか。
  • CLIによる完成検査に加え、利用環境でStop hookが呼ばれることを確認したか。

正本を読む​

plugin定義・ビルド処理とSkill正本で管理します。共通の配置方針は配布・導入ガイドを参照してください。