ce-polish-beta について
ce-polish-betaは、開発サーバーを起動し、ブラウザー上のユーザーのフィードバックをもとに機能を反復改善するスキルです。プロジェクト種別の検出やサーバー起動手順も備えています。
主な機能
- 01開発サーバーの起動ガイド
- 02フレームワークとポートの検出
- 03ブラウザーでのフィードバック反映
- 04要望に応じた機能修正
活用シーン
- 01実行中の機能のプレビュー
- 02フィードバックに基づくUX改善
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ everyinc/ compound-engineering-plugin --skill ce-polish-betaインストール後、Claude Code で/ce-polish-betaを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/dev-server-astro.mddev-server-detection.mddev-server-next.mddev-server-nuxt.mddev-server-procfile.mddev-server-rails.mddev-server-remix.mddev-server-sveltekit.mddev-server-vite.mdide-detection.mdlaunch-json-schema.mdscripts/detect-project-type.shread-launch-json.shresolve-package-manager.shresolve-port.sh詳細
Polish
開発サーバーを起動し、ブラウザーで機能を開いて、調整を繰り返します。機能を使ってみて、気になる点を伝えると、修正が行われます。
Phase 0: 適切なブランチに切り替える
- PR 番号またはブランチ名が指定されている場合は、それに切り替えます(まず既存のワークツリーを確認します)。
- 指定がない場合は、現在のブランチを使用します。
- 現在のブランチが main/master ではないことを確認します。
Phase 1: 開発サーバーを起動する
1.1 .claude/launch.json を確認する
bash scripts/read-launch-json.sh を実行します。設定が見つかった場合は、それを使用します。プロジェクトの起動方法はユーザーからすでに指示されています。
1.2 自動検出(launch.json がない場合)
bash scripts/detect-project-type.sh を実行して、フレームワークを特定します。
種類に応じて、起動コマンドとポートのデフォルト設定が記載された対応するレシピのリファレンスを参照します。
| 種類 | レシピ |
|---|---|
rails | references/dev-server-rails.md |
next | references/dev-server-next.md |
vite | references/dev-server-vite.md |
nuxt | references/dev-server-nuxt.md |
astro | references/dev-server-astro.md |
remix | references/dev-server-remix.md |
sveltekit | references/dev-server-sveltekit.md |
procfile | references/dev-server-procfile.md |
unknown | プロジェクトの起動方法をユーザーに尋ねます |
パッケージマネージャーが必要なフレームワークの場合は、bash scripts/resolve-package-manager.sh を実行し、結果を起動コマンドに代入します。
bash scripts/resolve-port.sh --type <type> でポートを解決します。
1.3 サーバーを起動する
開発サーバーをバックグラウンドで起動し、出力を一時ファイルに記録します。http://localhost:<port> に対して、最大 30 秒間接続を確認します。起動しない場合は、ログの末尾 20 行を表示して、次にどうするかユーザーに尋ねます。
1.4 ブラウザーで開く
環境変数のプローブ表を参照するため、references/ide-detection.md を読み込みます。IDE の仕組みを使ってブラウザーを開きます(Claude Code → open、Cursor → Cursor ブラウザー、VS Code → Simple Browser)。
ユーザーに次のように伝えます。
Dev server running on http://localhost:<port>
Browse the feature and tell me what could be better.
Phase 2: 調整を繰り返す
ここが中心となるループです。ユーザーが機能を見て、改善点を伝えます。修正を行い、ユーザーが満足するまで繰り返します。
- ユーザーが修正点を説明した場合 → 変更を加えます。開発サーバーがホットリロードします
- ユーザーが何かを確認するよう求めた場合 →
agent-browserを使って、ページのスクリーンショットを撮るか、ページを調査します - ユーザーが完了を伝えた場合 → 修正をコミットして終了します
チェックリストはありません。形式にとらわれず、会話しながら進めます。
References
リファレンスファイル(必要に応じて読み込みます):
references/launch-json-schema.md— launch.json のスキーマと、フレームワーク別のスタブreferences/ide-detection.md— ホスト IDE の検出とブラウザーへの引き渡しreferences/dev-server-detection.md— ポート解決のドキュメントreferences/dev-server-rails.md— Rails 開発サーバーのデフォルト設定references/dev-server-next.md— Next.js 開発サーバーのデフォルト設定references/dev-server-vite.md— Vite 開発サーバーのデフォルト設定references/dev-server-nuxt.md— Nuxt 開発サーバーのデフォルト設定references/dev-server-astro.md— Astro 開発サーバーのデフォルト設定references/dev-server-remix.md— Remix 開発サーバーのデフォルト設定references/dev-server-sveltekit.md— SvelteKit 開発サーバーのデフォルト設定references/dev-server-procfile.md— Procfile ベースの開発サーバーのデフォルト設定
スクリプト(bash scripts/<name> で実行):
scripts/read-launch-json.sh— launch.json の読み取りscripts/detect-project-type.sh— プロジェクト種別の分類scripts/resolve-package-manager.sh— ロックファイルに基づくパッケージマネージャーの解決scripts/resolve-port.sh— ポート解決の優先順位