mcpField
F
finalize

finalize

github.com/steveclarkeテスト・品質3695 回インストール今日更新
リポジトリ

finalize について

Finalizeは、変更を仕上げるためのハーネス非依存のスキルです。 lint、テスト、コード品質、ドキュメント、UI、プロジェクト固有の要件をチェックリストで確認し、問題を修正します。

主な機能

  1. 01Lintとフォーマットの確認
  2. 02プロジェクトのテスト実行
  3. 03コード品質とセキュリティの確認
  4. 04ドキュメントとUI変更の確認
  5. 05プロジェクト固有の仕上げ要件に対応

活用シーン

  1. 01変更完了前の検証
  2. 02実装後のテストとLint確認
  3. 03ドキュメントやUI更新の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/steveclarke/dotfiles --skill finalize

インストール後、Claude Code で/finalizeを入力して読み込まれたか確認します。

詳細

仕上げ

仕組み

このスキルでは、まず汎用チェックリストを実行し、次にプロジェクトのエージェント向け指示ファイル（CLAUDE.md、または使用するハーネスに AGENTS.md がある場合はそのファイル）を確認して、プロジェクト固有の仕上げ要件がないかを調べます（「Finalize Checklist」セクションなどを探します）。プロジェクトに必要なことはプロジェクト自身が把握しています。このスキルは、抜け漏れがないよう確認するだけです。

ハーネスに依存しません。 チェックリストはツールに依存しません。ハーネスで使えるシェルやツールを使って、プロジェクトで実際に使用している lint／テスト／ビルドのコマンドを実行します。特定のツールを指定する手順（Impeccable UI の確認や Memory の手順など）は、そのツールがある場合にのみ適用します。ない場合は、その旨を記載してスキップしてください。サブエージェントは必要ありません。

汎用チェックリスト

各セクションを順に確認し、合格した項目と修正が必要な項目を報告してください。 問題を列挙するだけでなく、直接修正してください。ユーザーが求めているのは報告ではなく、作業の完了です。

1. Lint とフォーマット

プロジェクトで使用している lint／フォーマットツールを実行してください。コマンドは CLAUDE.md／AGENTS.md または package.json／Gemfile で確認してください。

2. テスト

プロジェクトのテストスイートを実行してください。以下を確認します。

  • すべてのテストに合格する
  • スキップすべきでないテストがスキップされていない
  • 新しいコードにテストカバレッジがある（ない場合はその旨を記載する）
3. コード品質の総点検

変更したファイルを確認し、よくある問題を探してください。

  • プロジェクトのユーティリティや定数を使うべき、直接記述された値やハードコードされた値
  • 既存コードとの一貫性がないパターン（命名、構成、スタイル）
  • 不要なコード、冗長なロジック、残された TODO／FIXME コメント
  • デバッグ用の記述（console.log、binding.pry、debugger、puts）
  • セキュリティ：ハードコードされたシークレット、安全でないパターン
4. ドキュメント

新規または変更したコードに、対応するドキュメントがあることを確認してください。

  • ユーザー向けの動作が変わった場合は、README またはドキュメントページを更新する
  • 公開 API にインラインドキュメント（JSDoc、YARD、docstring）を追加する
  • プロジェクト固有のドキュメントを確認する（対象一覧は CLAUDE.md／AGENTS.md を参照）
5. UI とデザインの品質

変更にビュー／テンプレート／コンポーネントのファイルが含まれない場合、このセクションはスキップしてください。

変更したビューのファイルに Impeccable スキルを実行してください。

  • $impeccable audit <target> — アクセシビリティ、パフォーマンス、レスポンシブ動作、テーマ設定
  • $impeccable polish <target> — UI の最終品質確認：余白、操作状態、タイポグラフィ、トランジション、コンポーネントライブラリとの適合性、デザインシステムへの準拠、トークン

実行した Impeccable コマンドと、確認された内容を報告してください。問題は直接修正してください。

既存ページとの一貫性（Impeccable の対象外）：

  • 新しいページが、類似する既存ページの構成に沿っている
  • ヘッダー、コンテンツのラッパー、アクションの配置が既存のパターンに沿っている
  • ページが主流のパターンから外れる場合、その違いが意図的であり、理由が示されている

表示の確認：

  • 開発サーバー、Storybook、または Lookbook で変更が正しく表示される
  • 該当する場合はライトモードとダークモード
  • 該当する場合はモバイル／レスポンシブ表示
6. Git と課題の管理
  • PR の説明が変更の実際の範囲を反映している
  • PR の本文に Closes #N または同等の課題リンクが含まれている
  • 大きな取り組みの一部である場合、親課題／エピックが更新されている
  • 後回しにした作業や新たに見つかった作業について、フォローアップ課題が作成されている
  • 課題が正しいステータスでプロジェクトボードに追加されている
7. プロジェクト固有の確認項目

プロジェクトの CLAUDE.md／AGENTS.md を読み、「Finalize Checklist」セクション（または同等のもの）があるか確認してください。あれば、その項目も実行してください。これらは、汎用チェックリストでは把握できないプロジェクト固有の要件です。

8. ナレッジ
  • 長期的に役立つ知見、決定事項、パターンをリポジトリのドキュメントに記録し、CLAUDE.md／AGENTS.md から参照できるようにする

コメント

Markdown 対応