mcpField
C
ce-polish-beta

ce-polish-beta

github.com/everyincデザイン・UI25.8k1.0k 回インストール今日更新
リポジトリ

ce-polish-beta について

ce-polish-betaは、開発サーバーを起動し、ブラウザー上のユーザーのフィードバックをもとに機能を反復改善するスキルです。プロジェクト種別の検出やサーバー起動手順も備えています。

主な機能

  1. 01開発サーバーの起動ガイド
  2. 02フレームワークとポートの検出
  3. 03ブラウザーでのフィードバック反映
  4. 04要望に応じた機能修正

活用シーン

  1. 01実行中の機能のプレビュー
  2. 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.md
dev-server-detection.md
dev-server-next.md
dev-server-nuxt.md
dev-server-procfile.md
dev-server-rails.md
dev-server-remix.md
dev-server-sveltekit.md
dev-server-vite.md
ide-detection.md
launch-json-schema.md
scripts/
detect-project-type.sh
read-launch-json.sh
resolve-package-manager.sh
resolve-port.sh

詳細

Polish

開発サーバーを起動し、ブラウザーで機能を開いて、調整を繰り返します。機能を使ってみて、気になる点を伝えると、修正が行われます。

Phase 0: 適切なブランチに切り替える

  1. PR 番号またはブランチ名が指定されている場合は、それに切り替えます(まず既存のワークツリーを確認します)。
  2. 指定がない場合は、現在のブランチを使用します。
  3. 現在のブランチが 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 を実行して、フレームワークを特定します。

種類に応じて、起動コマンドとポートのデフォルト設定が記載された対応するレシピのリファレンスを参照します。

種類レシピ
railsreferences/dev-server-rails.md
nextreferences/dev-server-next.md
vitereferences/dev-server-vite.md
nuxtreferences/dev-server-nuxt.md
astroreferences/dev-server-astro.md
remixreferences/dev-server-remix.md
sveltekitreferences/dev-server-sveltekit.md
procfilereferences/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 — ポート解決の優先順位

コメント