quality-checks について
Symfony 開発向けの品質チェック技能で、PHP-CS-Fixer、PHPStan、テストを扱います。段階的な実行手順と、問題を隠さず対処するための指針を示します。
主な機能
- 01ツールと設定ファイルの検出
- 02スタイル修正の確認と適用
- 03設定済みレベルでの PHPStan 実行
- 04チェック後のテスト実行
- 05修正内容と未解決項目の報告
活用シーン
- 01コミットやプルリクエストの準備
- 02PHP 品質ツールの設定
- 03CI 品質ジョブ失敗の調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dev-toolings/ superpowers-symfony --skill quality-checksインストール後、Claude Code で/quality-checksを入力して読み込まれたか確認します。
同梱ファイルreference.md
詳細
品質チェック(Symfony)
使用する場面
- コミットまたはプルリクエストの作成前。
- Symfony プロジェクトで PHP-CS-Fixer または PHPStan を設定、調整するとき。
- CI の品質チェックジョブが失敗し、原因の特定と修正が必要なとき。
標準的なワークフロー
- 使用されているツールと設定ファイル(
.php-cs-fixer.dist.php、phpstan.dist.neon)を確認します。 - まずスタイル修正ツールを差分表示付きのドライランで実行し、その後に適用します。
- 設定済みのレベルで PHPStan を実行し、報告された型の問題を修正します。
- スタイルチェックと静的解析が成功してから、最後にテストスイートを実行します。
ガードレール
- 実行を成功させるために PHPStan のレベルを上げたり、ベースライン項目を追加したりしないでください。
- スタイルのみの変更は、動作変更とは分けて独立したコミットにしてください。
- 書面で理由を説明せずに、無視ルールでエラーを抑制しないでください。
- プロジェクトが使用している実行環境(Docker またはホスト)から、ランナーを使用してください。
段階的な情報開示
- 実行時の方針とリスク管理には、このファイルを使用します。
- 実装の詳細を確認する必要がある場合は、リファレンスを参照します。
出力要件
- 実行したコマンドとその結果。
- 適用した修正。スタイルと型の修正は分けて記載します。
- 判断が必要な、未解決の指摘事項。
リファレンス
reference.md
コメント
Markdown 対応