project-min-evaluation について
project-min-evaluationは、実装完了の報告やコミットの前に品質を確認するスキルです。パッケージマネージャーを検出し、プロジェクトで定義された対象スクリプトだけを実行して、最初の失敗で停止します。
主な機能
- 01パッケージマネージャーの検出
- 02定義済み品質スクリプトの特定
- 03スクリプトの順次実行
- 04失敗時に実行を停止
- 05検証結果の形式化された報告
活用シーン
- 01完了報告前の作業確認
- 02コミット前の変更検証
- 03不足または失敗したチェックの報告
- 04プロジェクト定義のテストコマンド選択
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ c3sc0-v4113/ scaffold --skill project-min-evaluationインストール後、Claude Code で/project-min-evaluationを入力して読み込まれたか確認します。
同梱ファイルreferences/script-discovery.md
詳細
プロジェクトの最低限の評価
有効化の契約
実装作業を完了として報告する前、コミットする前、または品質の確認を求められたときは、このスキルを読み込んでください。
厳守事項
- プロジェクトからパッケージマネージャーを判別してください。実行ツールをハードコードしてはいけません。
package.jsonのscriptsに定義されたスクリプトのみを実行してください。存在しないスクリプトは、コマンドを作り出さずに、必要なスクリプトとして報告してください。- 以下の順序でリポジトリのルートから実行してください。後続の手順に進むために、失敗した手順を飛ばしてはいけません。
- チェックが失敗した場合、または実行していない場合は、完了したと主張してはいけません。
判定基準
| プロジェクトの兆候 | 実行ツール |
|---|---|
package.json に packageManager フィールドがある | 指定されたパッケージマネージャーを使用する |
pnpm-lock.yaml がある | pnpm run <script> |
bun.lock または bun.lockb がある | bun run <script> |
package-lock.json がある、または他に兆候がない | npm run <script> |
| スクリプト | 実行する条件 |
|---|---|
lint | 定義されていれば常に実行 |
typecheck | 定義されていれば常に実行 |
format:check | 定義されていれば常に実行 |
test | 定義されていれば常に実行 |
doctor | 定義されていれば常に実行 |
check | 定義されていれば常に実行(集約ゲート) |
test:e2e | エンドツーエンドの動作を変更した場合のみ実行 |
実行手順
package.jsonとロックファイルを読み、実行ツールを選択します。- 表に記載されたスクリプトのうち、
scriptsに存在するものを集めます。 - 選択した実行ツールを使い、表の順序で存在するスクリプトを実行します。
- 最初の失敗で停止し、修正してから、そのスクリプト以降を再実行します。
出力の契約
各スクリプトについて、成功、失敗、または未定義として報告してください。失敗した場合、またはチェックを実行できない場合は、正確なコマンド、正確なエラー、および未検証の範囲を示してください。
参考資料
- references/script-discovery.md — 検出時の例外ケース。
コメント
Markdown 対応