Communitygithub.com

stoating/clojure-portfolio-skill

ClojureScriptのビジュアルREPL「Portfolio」を使用する際に利用します。defscene、portfolio.ui/start!、:portfolio shadow-cljsビルドターゲット、シーンの整理、UIカスタマイズ(背景/ビューポート/グリッド/CSS)、フレームワークアダプター(Reagent、React、Replicant、Rum、Dumdom)、アトムを使った状態保持シーン、tap> REPLの使用方法、プロダクションビルドでのPortfolio無効化についてユーザーが尋ねたときに起動します。

clojure-portfolio-skill とは?

Portfolioは、ClojureScript向けの「ビジュアルREPL」であり、UIコンポーネントを名前付きの独立した**シーン**としてレンダリングし、すべてのコンポーネント状態を一目で確認できるツールです。Storybook.jsに似ていますが、REPL駆動のClojureScript開発に特化して設計されています。このスキルは、Portfolioのインストール、セットアップ、シーンの定義、フレームワークアダプターの選択(Reagent、React、Replicant、Rum、Dumdom)、シーンの整理、UIのカスタマイズ、tap>を使ったREPL活用、プロダクションビルドでのPortfolio無効化など、Portfolioの全機能をカバーします。シーンは通常のClojureScript名前空間に定義され、Portfolioが名前空間階層に基づいて自動的に整理するため、開発効率が大幅に向上します。shadow-cljsの`:portfolio`ビルドターゲットを使用すると、名前が`-scenes`で終わるすべての名前空間が自動的に読み込まれ、最小限の設定で高速に開始できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stoating/clojure-portfolio-skill/tree/HEAD/skills/portfolio

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Portfolio

PortfolioはClojureScriptの「ビジュアルREPL」です。名前付きの独立したシーンとしてUIコンポーネントをレンダリングし、すべてのコンポーネント状態を一目で確認できます。Storybook.jsに似ていますが、REPL駆動のClojureScript開発向けに設計されています。

現在のリリース: no.cjohansen/portfolio {:mvn/version "2026.03.1"}

クイック決定: 何が必要ですか?

タスク参照先
インストール、UIの起動、shadow-cljsのセットアップsetup.md
defscene、パラメータ、アトム、ライフサイクルを使ったシーンの定義defscene.md
フレームワークアダプターの選択(Reagent、React、Replicant…)defscene.md
シーンをコレクション、フォルダ、パッケージに整理organization.md
背景、ビューポート、グリッド、CSS、HTMLのカスタマイズcustomize-ui.md
シーンを定義せずにREPLからtap>を使用setup.md
プロダクションビルドでPortfolioを無効化setup.md
よくある間違いと避けるべきことanti-patterns.md

コアメンタルモデル

Portfolioはシーンをレンダリングします。シーンとは、特定の状態にあるコンポーネントの名前付きスナップショットです。シーンは通常のClojureScript名前空間(通常は*-scenesという名前)に配置され、Portfolioは名前空間階層に基づいて自動的にナビゲーション可能なサイドバーに整理します。

defscene → シーン → 名前空間(パッケージ) → フォルダ → サイドバー

UIは開発サーバーのアドレスでブラウザ上で実行されます。REPLでdefsceneを再評価すると、ページのリフレッシュなしで即座に再レンダリングされます。

最小限の動作例

;; deps.edn
{:deps {no.cjohansen/portfolio {:mvn/version "2026.03.1"}}}
;; src/my/button_scenes.cljs
(ns my.button-scenes
  (:require [portfolio.reagent :refer-macros [defscene]]))

(defscene default-button
  [:button.btn "Click me"])

(defscene disabled-button
  [:button.btn {:disabled true} "Can't click"])
;; src/my/dev/portfolio.cljs  — これをshadow-cljsの:runner-nsから呼び出す
(ns my.dev.portfolio
  (:require [portfolio.ui :as ui]))

(ui/start! {:config {:css-paths ["/css/app.css"]}})

shadow-cljs :portfolio ビルドターゲット

名前が-scenesで終わるすべての名前空間を自動的に読み込みます。最も高速なセットアップ手順:

;; shadow-cljs.edn
{:deps {:aliases [:dev]}
 :dev-http {8080 ["dev-resources/public" "classpath:public"]}
 :builds
 {:portfolio
  {:target :portfolio
   :runner-ns my.dev.portfolio    ;; 省略すると設定なしで開始
   :dev {:output-dir "dev-resources/public/js"}}}}

:dev-httpの"classpath:public"は必須です。これにより、Portfolioのバンドルアセットがjarから提供されます。

デフォルトの推奨事項

  • シーンは専用のディレクトリ(dev/、scenes/、または:devエイリアスのソースパス)に配置し、プロダクションビルドに含まれないようにします。
  • コンポーネントデータが複雑な場合は常に:paramsを使用してください。REPLでの実験や検索インデックス作成が可能になります。
  • 新しいプロジェクトでは、手動の名前空間読み込みよりも:portfolio shadow-cljsターゲットを優先してください。
  • プロダクションビルドからシーン名前空間を除外できる場合は、コンパイラフラグでPortfolioを抑制しないでください。

関連スキル