## 概要 **ShipOrSkip** は、プロジェクトフォルダをドラッグ＆ドロップするだけで、コードの「実装完成度」を 100 点満点でスコアリングする静的解析ツールです。ファイル構造だけではなく、**コードの中身**を正規表現ベースで解析し、イベントハンドラが空でないか、状態管理が機能しているか、モックデータに依存していないかなど、「本当に動くコードか」を 5 つの観点から検証します。 ## ポジショニング：出荷判断の「一次スクリーニング」 ShipOrSkip は、出荷可否の**最終判断ツールではありません**。「このコード、リリースに向けて詳細レビューする段階にあるか？」を素早く判定する**一次フィルター**です。Ship it! なら詳細 QA へ、Needs Work なら改修を優先——という開発フローの分岐点を提供します。 > ⚠️ **免責事項**: 本ツールは正規表現ベースのパターンマッチングによる簡易スクリーニングです。AST 解析やランタイム検証は行いません。スコアはあくまで参考指標であり、プロダクションリリースの最終判断はコードレビュー・QA テスト等を経て行ってください。 ## 5カテゴリ評価（100点満点） | カテゴリ | 配点 | 評価内容 | |:---|:---:|:---| | **Functionality** | 30 | イベントハンドラ / API 実装、状態管理、データフロー、モック依存度 | | **Robustness** | 20 | エラーハンドリング（try-catch）、非同期・ローディング処理、入力バリデーション | | **UI/UX** | 20 | レスポンシブ対応、アクセシビリティ、インタラクティブフィードバック | | **Code Quality** | 15 | 型システム活用、モジュール化、技術的負債 | | **Testing & Infra** | 15 | テストファイル数・アサーション、テストライブラリ導入、設定成熟度 | ## Red Flags 自動検出以下のパターンを検出し、自動で減点します： - **モックデータ残留** — ハードコードされたダミーデータ - **空ハンドラ** — onClick={() => {}} 等の未実装イベント - **console.log 残留** — デバッグコードの消し忘れ - **TODO / FIXME** — 未対応のタスク - **セキュリティリスク** — 危険なパターン ## 4段階ランク判定 | ランク | スコア | 意味 | |:---|:---:|:---| | **Ship it!** | 80–100 | 出荷可能な完成度 | | **Fix then Ship** | 60–79 | あと少しで出荷ライン | | **Needs Work** | 40–59 | 骨格はあるが改善が必要 | | **Skip it** | 0–39 | 動くプロダクトとは言い難い | ## 主な特長 - **ドラッグ＆ドロップで即時スキャン** — フォルダを投入するだけ - **完全クライアントサイド** — コードは一切外部送信されません - **40種以上の拡張子に対応** — TypeScript, Python, Go, Rust, Java, PHP 等 - **プロジェクトタイプ自動判別** — Frontend / Backend / Fullstack を自動検出 - **評価履歴** — 直近10件をローカル保存し、プロジェクト間比較が可能 ## 🔗 姉妹プロダクト: ProductSignal ShipOrSkip が「**出荷していいか？**」をコードの中身から判定するのに対し、**ProductSignal** は「**採用していいか？**」をファイル構造から判定します。2つを組み合わせることで、フォルダ投入だけで「採用判断 → 出荷判断」の一次スクリーニングを一気通貫で実行できます。

ShipOrSkip｜コード実装完成度スコアラー