Skill.md検索

コード規模（ソースコード・テストコード・ドキュメントの行数・ファイル数）をファイル種別ごとに集計できます ディレクトリ別（エンジン・エディタ・コンポーネント・音声管理など）の詳細な構成を把握でき、各部分がどれくらいのボリュームかが一目瞭然になります テスト網羅率（テストケース数・Pass/Fail 数）、機能数（コマンド型・アクション型・エディタタブ数）をまとめて把握できます 依存パッケージ数、プロジェクトデータ数、Git コミット履歴をテーブル形式でレポート化できます プロジェクトの現在の状態を数値で把握したいプロジェクトマネージャー リファクタリングや最適化の優先度を判断するために、コード規模の詳細を知りたい開発者 開発進捗やテスト網羅率の推移を定期的に追跡したい人 チーム内で「今、どのくらいのコード量があるか」を共有したい人 doujin-metrics スキルは 7 つの測定項目でプロジェクト規模を多角的に分析します。コード規模では .js、.jsx ファイルの行数・ファイル数を種別ごと集計。ディレクトリ別集計では src/engine/、src/editor/、src/components/ など 11 ディレクトリの行数をリストアップ。テスト情報では vitest run で Pass/Fail 数を取得。機能数では constants.js の CMD・ACTION オブジェクトキー数、EditorScreen.jsx の TABS 配列長を抽出。依存パッケージでは package.json から dependencies・devDependencies 数をカウント。データ規模では data/projects/ 配下のプロジェクト数を集計。Git 統計では総コミット数と直近 1 週間のコミット数を取得。出力は Markdown テーブル形式で、カテゴリ・ディレクトリ・テスト・機能・パッケージ・Git の 6 つのテーブルで構成。測定日を記載して完了。

3つのタイプから選んで雛形生成: ライブラリ（PyPI配布）、バックエンド（FastAPI）、CLIツール（argparse）の3パターンに対応し、用途に合わせた最適な初期構成を自動生成 必要なファイルをワンステップで作成: pyproject.toml、Dockerfile、docker-compose.yaml、.gitignore、start.shなど、実務レベルのプロジェクトに必要なすべてのファイルを一括生成 モダンなPython開発環境を即座に構築: uv（パッケージ管理）、Docker（コンテナ化）、ruff（コード品質）、pytest（テスト）を組み込んだ、現代的なPythonプロジェクト構成を実装 用途が不明な場合も対応: ユーザーが具体的に指定しない場合はヒアリングして最適なタイプを提案（迷ったらバックエンド推奨） 構成の妥当性を自動検証: 生成後に構成検証を実行し、ファイル構造や依存関係が正しく整っているか確認 データサイエンティスト・機械学習エンジニア: 分析コードやモデルをライブラリ化して再利用可能にしたい バックエンド開発者: FastAPI プロジェクトをすぐに立ち上げて開発を始めたい、ベストプラクティスに従った構成を最初から用意したい スタートアップ・個人開発者: CLIツールやAPIサーバーを効率よく開発・デプロイしたい チーム開発: プロジェクト間で統一された環境構成（依存管理、コード品質基準、テスト設定）を維持したい ユーザーにプロジェクト名と構成タイプを確認 → 対応するリファレンス（library.md / backend.md / command.md）を読み込み → 必要なファイルを生成 → 構成検証を実行。すべてのタイプで pyproject.toml（requires-python=3.12、uv設定、ruff・pytest設定）、Dockerfile（マルチステージビルド）、docker-compose.yaml、.gitignore、start.sh を生成。ruffはpycodestyle・pyflakes・isort・pep8-naming・pyupgrade・flake8-bugbear・flake8-simplify・flake8-annotations・pydocstyleを選択。pytestはtestpathsを設定。runtimeステージのCMDはタイプ別リファレンスで定義。発動キーワード：「Pythonプロジェクトを作って」「新規プロジェクト」「雛形を作って」「FastAPIプロジェクト」「CLIツール・ライブラリを作りたい」など。既存コードの編集には使用しない。

ノベルゲームエンジン用のプロジェクトを新規作成し、シナリオ・キャラクター・背景・BGM/SE・CG などの全データを JSON で一元管理できます。 シナリオテキスト（小説形式）を自動的にゲームエンジン用のコマンド配列に変換し、手動編集の手間を削減できます。 シーン追加、キャラ定義、背景設定、音声カタログ、CG登録など、個別の要素を直感的に追加・編集・削除できます。 プロジェクト全体の整合性をチェック（validate）し、データの矛盾や漏落を自動検出します。 参照ドキュメント（スキーマ定義、コマンド仕様、エフェクト仕様など）に基づき、常に最新の仕様に準拠したデータを生成・管理します。 ノベルゲームやビジュアルノベルを制作中で、シナリオ・キャラクター情報を体系的に管理したい制作者 テキストベースのシナリオ執筆から自動的にゲームデータに変換したい脚本家・シナリオライター 複数のBGM、効果音、背景画像、CG を整理・登録し、ゲーム内で正確に参照したい方 プロジェクト全体のデータ品質を確認し、矛盾や欠落がないか検証したい方 このスキルは、doujin-engine/data/projects/{プロジェクト名}/ 配下に格納された複数の JSON ファイルを統合的に管理します。主要な操作は以下の通り：list でプロジェクト一覧を表示（_index.json から読み込み）。new で新規プロジェクトを作成し、meta.json（ID自動生成）、script.json、storyScenes.json、characters.json、bgmCatalog.json、seCatalog.json、cgCatalog.json など 13 種類のファイルを初期化。scene add でシーンを追加し sceneOrder.json に記録。scene edit ではシナリオテキスト（台詞は「セリフ」、地の文、イベント制御記号など）をコマンド配列に自動変換。chara/bg/bgm/se/cg add でカタログに新規要素を登録。validate で全ファイルの相互参照整合性をチェック。delete で不要な要素を削除。スキーマ定義（project-data-schema.md、commands.md、effects.md、audio.md、transitions.md、gallery.md）に常に準拠し、矛盾がある場合はスキーマを優先します。

git statusとgit diffから全ての変更を自動抽出し、3カテゴリ（ステージ済み・未ステージ・未追跡）に分類できます 異なる機能の混在を検出して、自動的に機能単位のコミットに分割し、関連ファイルをグループ化できます コード変更の意図を読み取り、接頭辞（feat, fix, update等）と日本語2行メッセージを自動生成できます 生成したコミット計画をテキスト形式でユーザに提示し、確認後の承認を取得してからコミット実行できます .envや秘密鍵などセンシティブファイルを自動検出して除外し、セキュリティリスクを防ぎながら他の変更を確実にコミットできます 日々の開発でコミット粒度を適切に保ちたいエンジニア コミットメッセージを統一・品質向上させたい開発チーム 変更内容を機能単位で整理し、レビューしやすくしたいPull Request著者 セキュリティ上の危険（秘密鍵やパスワード混在）を自動防止したい組織 全体フロー：①差分チェック→②コミット分割判断→③メッセージ生成→④ユーザ提示・確認→⑤コミット実行→⑥プッシュ確認。差分チェックはgit status/diff/logで3カテゴリ分類後、.envや秘密鍵を警告・除外。コミット分割判断：機能の異同（バグ修正と新機能）、領域の独立性（フロント/バック）、目的の独立性（リファクタリングと機能変更）で判定。メッセージ生成：フォーマット「接頭辞: 要約（50字以内）\n詳細（72字以内）」。接頭辞は24種類（fix/add/feat/update/clean等）から選択。ユーザ提示：コミット計画をテキスト出力し、AskUserQuestion で承認取得。コミット順序は基盤的変更→依存変更の順で実行。

直前の実装変更を分析し、テストが必要な変更か自動判断します。reducer・commands・utils などの純粋関数変更は自動検出し、UI のみ変更やスタイル変更はテスト不要と判断します。 変更内容に対応するテストを Vitest フレームワークで自動生成し、既存テストパターンに統一させます。 エッジケース（空配列・null・未定義値）を含めたテストケースを自動生成し、バグ再発を防止します。 バグ修正の場合は「修正前に失敗、修正後に成功する」再現テストを必須で追加します。 doujin-engine プロジェクトで実装変更時にテストを忘れやすい開発者 reducer・commands などの純粋関数開発でテストケース漏れを減らしたい人 バグ修正時に再発防止テストまで含めて完了させたい人 テスト作成の時間を短縮したい人 テストファイルはdoujin-engine/src/test/配下に Vitest フレームワークで管理します。手順は①直前の実装変更内容を確認②テスト可能性を判定（reducer・commands・utils など純粋関数は必須、UI・スタイル変更は不要）③テスト不要時は理由を述べてスキップ④テストを作成します。テスト方針として既存テストパターンに従い、新定数はconstants.test.jsに追加し、エッジケース（空配列・null・未定義値）を含め、バグ修正は再現テスト必須です。

機能追加が自動で反映される: 新機能を実装すると、プロジェクトルートの CLAUDE.md の「実装済み機能」セクションに自動追加されます。 コマンド・ステート変更も漏らさず記録: 新コマンド追加や状態管理の変更は「コマンド一覧」「ステート管理」に自動追記されます。 ディレクトリ構成の変更を即座に反映: フォルダ構成やファイルパスの変更があれば、「ディレクトリ構成」セクションが自動で最新状態に更新されます。 データスキーマ変更を記録: doujin-engine/docs/design/project-data-schema.md が自動更新され、データ構造の履歴が残ります。 バグ修正・リファクタは不要な判定を自動化: 内部リファクタリングやバグ修正のみの場合は「更新不要」と自動判定し、無駄な修正を回避できます。 プロジェクト主導者・リーダー: 開発とドキュメントのズレを自動で防ぎ、プロジェクト全体の透明性が向上します。 チーム全体: プロジェクトの最新状態が常にドキュメントに反映されるため、新しいメンバーのオンボーディングが楽になります。 ドキュメント管理者: コード変更時に「どの記事を更新するか」を自動判定してくれるため、ドキュメント漏れが減ります。 開発者: 機能追加の度に手動でドキュメント更新する手間がなくなり、開発に集中できます。 変更内容をドキュメントに自動反映するスキル。対象ドキュメント：(1)CLAUDE.md(プロジェクトルート) - 新機能→「実装済み機能」追加、新コマンド→「コマンド一覧」追加、新ステート→「ステート管理」追加、ディレクトリ変更→「ディレクトリ構成」更新、(2)doujin-engine/docs/design/project-data-schema.md - データ構造変更時は必ず更新、(3)doujin-engine/docs/design/*.md - 関連設計ドキュメント更新・新領域は新規.md作成。判断基準：内部リファクタリングのみ→更新不要（理由記述＆スキップ）、バグ修正のみ→通常不要（ドキュメント自体が誤りの場合のみ修正）、新機能・新コマンド・スキーマ変更→更新必須。

FastAPI・Express・Hono・NestJS・Gin・Spring Bootなど複数のフレームワークのルーティング定義からエンドポイント情報を自動抽出できる Pydantic・Zod・DTOなどのスキーマ定義からリクエスト/レスポンス仕様を自動読み取り、OpenAPI 3.1 YAML形式で生成できる Bearer認証・APIキー・OAuth2などの認証方式をコードから自動検出し、セキュリティ定義に反映できる 既存のopenapi.yamlがある場合は差分更新ができ、手作業での同期を削減できる 生成したYAMLはSwaggerUI等で即座に可視化でき、API設計のレビューに活用できる バックエンドの実装とドキュメントのズレを自動で防ぎたいバックエンド開発者 APIの仕様書を最新に保ちたいテックリード・アーキテクト フロントエンド開発者とAPI仕様を正確に共有したい開発チーム 複数言語・フレームワークのマイクロサービス仕様をまとめて管理したいプロジェクト

画面仕様書（Markdownドキュメント）からユースケースを抽出し、それに基づいたPlaywrightテストケースを自動生成できる 表示テスト・操作テスト・エラーハンドリング・ナビゲーションなど、複数カテゴリのテストを網羅的に作成し、見落としを防げる テスト実行結果を自動分析し、失敗原因を特定してスクリーンショット・ビデオ証拠とともに報告できる 実装バグが見つかった場合、そのまま修正→再テストまでを一括で実施でき、修正と検証の往復を短縮できる 既存Playwrightセットアップの有無を自動判定し、必要に応じて初期化から開始できる フロントエンド実装の品質を自動テストで保証したい開発チーム 画面仕様書とテストの乖離を防ぎたいQA・テスト担当者 手作業のテストケース設計・実行を削減し、開発スピードを上げたい開発者 リグレッション（既存機能の誤動作）を未然に防ぎたいプロジェクト

すべての関数・クラスに Google Style のdocstring を自動生成・補完し、関数の使い方を初見でも理解できるようにできる 関数の引数・戻り値にタイプヒント（型注釈）を自動追加し、実行時エラーをエディタで事前検出できる ruffによるリント・フォーマット、isortによるimport整理を自動適用し、コード品質をPEP 8に統一できる コメントの品質を改善し、「なぜそのコードを書いたのか」というビジネスロジックの背景を明確にできる 複雑な処理をクラス・関数に分割し、ファイル構成を整理するリファクタリング（コードの整理・改善）を実施できる Pythonコードの可読性・保守性を高めたい開発チーム 新規メンバーがコードを素早く理解できる環境を作りたいプロジェクト 既存Pythonコードの技術負債を解消したいリファクタリング担当者 本番環境でのランタイムエラーを事前に防ぎたいQA・リリース責任者

すべてのReactコンポーネント・カスタムフック・ユーティリティ関数にTSDoc（TypeScriptドキュメント）を自動生成し、使い方を初見でも理解できるようにできる Props・戻り値・コールバック関数に厳密な型定義を適用し、型レベルで不正な使い方を事前に防ぐことができる 判別共用体型（Discriminated Union）を活用して、「ローディング中なのにデータがある」といった矛盾した状態をコンパイル時に検出できる ESLint + Prettier によるコード品質チェック・自動整形を自動適用し、スタイルの統一を保つことができる 複雑なロジックをカスタムフック（React の再利用可能な関数）に抽出し、コンポーネント構成を簡潔にできる TypeScriptの型安全性でバグを減らしたいフロントエンド開発チーム コンポーネントの再利用性・保守性を高めたいReactプロジェクト 新規メンバーが既存コンポーネントを安全に使える環境を作りたいリード開発者 本番環境でのランタイムエラーを事前に防ぎたい品質管理者

プロジェクト雛形を一括生成 — Vite・TypeScript・Tailwind CSS・ESLint・Prettier・テスト環境などが揃った完成度の高いReactプロジェクトを、指定するだけで自動的に作成できます。 用途別の構成に対応 — SPA（シングルページアプリケーション）、管理画面・ダッシュボードなど、プロジェクトの種類に応じたフォルダ構成とサンプルコードを自動選択して生成します。 すぐに開発を開始できる — 環境設定やツール導入の手間を大幅削減でき、コードを書き始めるまでの準備時間を短縮できます。 設定ファイルは全て自動化 — Tailwind CSS、ESLint、Prettier、Vitest などの設定ファイルがすべて最適な状態で生成されるため、複雑な設定作業が不要です。 新しいReactプロジェクトを立ち上げる際に、初期セットアップの手間を減らしたい開発者 フロントエンドの最新ベストプラクティスに沿った環境を確実に構築したいエンジニア プロジェクトごとに一貫した開発環境を整えたいチームリード 管理画面やダッシュボードなど、特定の目的に沿った構成をすぐに用意したい実装者

OpenAPI定義から自動テスト生成 — APIの仕様書（OpenAPI/Swagger）を読み込み、正常系・異常系を網羅したテストケースをシェルスクリプトとして自動生成できます。 curl ベースの結合試験を実行 — サーバが起動している状態で、curlコマンドによるブラックボックステストを実行し、エンドポイントの実装が仕様通りか確認できます。 テスト結果を自動で保存・検証 — 各テストケースのリクエスト・レスポンス・ステータスコードを自動記録し、期待値との比較を行えます。 テスト環境をフォルダ構成で整理 — リソース単位でテストケースをグループ化し、テスト一覧管理・複数実行が簡単になります。 バックエンド開発者が実装したAPIの動作確認を効率的に行いたい人 結合試験（インテグレーションテスト）の実施時間を削減したいQAエンジニア APIの正常系・異常系を体系的にテストしたいシステム開発チーム APIドキュメント（OpenAPI）をテストケース生成に活用したい技術者

React/Next.js の実装コードを解析して仕様書を自動生成 — 既に存在するフロントエンド実装を読み込み、全画面・全UI要素・全アクションを網羅したMarkdown仕様書を自動作成できます。 画面ごとの詳細ドキュメントを作成 — UI要素の入出力、ユーザーアクション、API連携、画面遷移などを構造化された形式で記録できます。 スクリーンショット付きドキュメント生成 — Playwright（自動テストツール）で各画面をキャプチャし、UI要素にアノテーションを付与した仕様書を出力できます。 画面遷移図を一覧化 — 全画面の遷移関係を図表としてまとめ、アプリケーション全体の流れを可視化できます。 既存のReact/Next.jsプロジェクトのドキュメントを整備したいエンジニア 実装後に仕様書を起こす必要が生じた開発チーム 後発者への画面説明・引き継ぎ資料を短時間で作成したいリーダー UI/UXを検討する際に、現在の実装状況を正確に把握したい企画・デザイン職