isjiamu/gzh-design-skill

解決する課題

Markdownを使用して微信公式アカウント用の美しくプロフェッショナルなレイアウトを作成する際の難しさを解決します。特に、HTMLを微信エディターに貼り付けた際にフォーマットが崩れる「スタイル消失」の問題に対処し、すべてのスタイルを厳密にインライン化してプラットフォームの制限的なフィルタリングルールに準拠させます。

仕組み

このプロジェクトは、AIエージェント（Claude Code、Cursor、Codexなど）の「スキル」として機能します。エージェントはMarkdownファイルと選択されたテーマを受け取り、コンテンツを解析して、定義済みのコンポーネントライブラリを使用してHTMLドキュメントを組み立てます。品質を保証するため、二重検証システムを採用しています。component_lint.pyがソースコンポーネントライブラリのアンチパターンをチェックし、validate_gzh_html.pyが配信前に最終的なHTML出力に禁止タグやフォーマットエラーがないかを検証します。

対象ユーザー

Markdownで執筆を行い、長文記事、チュートリアル、レポートなどを手動でフォーマットすることなく、洗練された微信公式アカウントの投稿に変換したいコンテンツクリエイター、ブロガー、アナリスト。

特徴

• 6つのプリセットテーマ: チュートリアル向けの「Moyu Green」やテックレビュー向けの「Graphite Minimalist」など、多様なスタイルが含まれています。
• テーマジェネレーター: 簡単なテキスト説明や参照画像を使用して、全く新しいカスタムテーマを作成できます。
• プラットフォーム準拠: テキストを <span leaf=""> で囲む、<style> や <div> タグを禁止するなど、微信特有の制約を自動的に処理します。
• スマートフォーマット: 章番号の追加、キーワードへの下線引き、導入カードや目次の生成を自動的に行います。
• エージェント非依存: レイアウトロジックがモデルの直感ではなくコンポーネントライブラリとスクリプトに組み込まれているため、さまざまなLLM（Claude、GPT、Gemini、DeepSeekなど）で動作します。