ln-740-quality-setup

パス： ファイルパス（references/、../ln-*）は、このスキルディレクトリからの相対パスです。

ln-740-quality-setup

タイプ： L2 ドメインコーディネーター
カテゴリ： 7XX プロジェクトのブートストラップ
親： ln-700-project-bootstrap

プロジェクトのコード品質ツールの設定を調整します。

---

目的と範囲

行うこと：

• プロジェクトのテクノロジースタック（TypeScript/React、.NET、Python）を検出します
• 既存の品質設定を確認します
• 品質に関する各側面を専門とするワーカーに委任します
• 最終的な設定が正しく機能することを検証します

行わないこと：

• 設定ファイルを直接生成すること（ワーカーが生成します）
• ソースコードを変更すること
• 単独で実行すること（先に ln-720 の構造が必要です）

---

使用するタイミング

トリガー	アクション
ln-720-structure-migrator の完了後	ln-700 から自動的に委任されます
品質設定を手動で行う必要がある	プロジェクトパスを指定して直接実行します
既存のプロジェクトに品質ツールが必要	既存の設定を検出して実行します

---

ワークフローの概要

フェーズ	アクション	出力
1	スタックの検出	特定されたテクノロジー
2	既存の設定の確認	スキップ／マージ／置換の判断
3	並列委任	ワーカーの呼び出し
4	検証	動作する品質パイプライン

---

フェーズ 1：スタックの検出

設定する品質ツールを決定するため、プロジェクトのテクノロジーを検出します。

検出ルール：

ファイルパターン	テクノロジー	リンターのスタック
package.json + tsconfig.json	TypeScript/React	ESLint + Prettier
*.csproj または *.sln	.NET	editorconfig + Roslyn
pyproject.toml または requirements.txt	Python	Ruff
複数を検出	混在	検出したすべてを設定

アクション：

1. テクノロジーを示すファイルを Glob で検索します
2. テクノロジーの一覧を作成します
3. 検出したスタックをユーザーに記録します

---

フェーズ 2：既存の設定の確認

委任する前に、すでに存在する設定を確認します。

確認する設定ファイル：

テクノロジー	設定ファイル
TypeScript	eslint.config.*、.prettierrc*、tsconfig.json
.NET	.editorconfig、Directory.Build.props
Python	ruff.toml、pyproject.toml [tool.ruff]
プリコミット	.husky/、.pre-commit-config.yaml
テスト	vitest.config.*、pytest.ini、*.Tests.csproj

判断マトリックス：

既存の設定	アクション	確認
見つからない	テンプレートから作成	いいえ
存在するが不完全	テンプレートに合わせて拡張	いいえ
存在し、テンプレートに一致	スキップ	ユーザーに通知

完全性の確認（Python）： ln-741 の「完全性の確認」表（7 項目：Ruff のルール、ファイルごとの除外設定、高度な設定、MyPy の strict 設定、高度なツール、lint スクリプト、editorconfig）に照らして評価します。いずれかの項目が不完全な場合は、ln-741 に置換ではなく拡張するよう指示して委任します。

---

フェーズ 3：並列委任

品質に関する各側面についてワーカーを呼び出します。独立したツールを設定するため、ワーカーは並列で実行できます。

委任の順序：

ln-740 (this)
    |
    +---> ln-741-linter-configurator
    |         - ESLint/Prettier (TypeScript)
    |         - editorconfig/Roslyn (.NET)
    |         - Ruff (Python)
    |
    +---> ln-742-precommit-setup
    |         - Husky + lint-staged (Node.js)
    |         - pre-commit framework (Python)
    |         - commitlint
    |
    +---> ln-743-test-infrastructure
              - Vitest (TypeScript)
              - xUnit (.NET)
              - pytest (Python)

検出したスタックと既存の設定を、Skill ツールの直接呼び出しを通じてワーカーに渡します。Python の場合は、ln-741 に「完全性の確認」表に従って品質スタック全体を適用するよう指示します。

呼び出し：

Skill(skill: "ln-741-linter-configurator", args: "{projectPath}")
Skill(skill: "ln-742-precommit-setup", args: "{projectPath}")
Skill(skill: "ln-743-test-infrastructure", args: "{projectPath}")

---

フェーズ 4：検証

すべてのワーカーの完了後、品質パイプラインが機能することを検証します。

検証手順：

チェック	TypeScript	Python	.NET
リント	ESLint	ruff check	dotnet format --verify-no-changes
フォーマット	Prettier	ruff format --check	dotnet format
型チェック	tsc --noEmit	mypy	Roslyn（ビルド）
インポート境界	depcruise	lint-imports	--
未使用の依存関係	knip	deptry	--
デッドコード	knip	vulture	--
脆弱性スキャン	npm audit	pip-audit	--
統合スクリプト	bash scripts/lint.sh	bash scripts/lint.sh	bash scripts/lint.sh
テスト	npm test	pytest	dotnet test
フック	テストコミットを作成	テストコミットを作成	テストコミットを作成

失敗した場合：

1. 具体的な失敗内容を記録します
2. 修正方法を提案するか、該当するワーカーを再実行します
3. 検証に合格するまで、完了としないでください

---

重要なルール

ルール 1： 明示的な確認なしに、既存のユーザー設定を上書きしないでください。

ルール 2： ワーカーを実行するのはスタック検出後です。スタックを把握せずにワーカーを呼び出さないでください。

ルール 3： 検証フェーズは必須です。ツールが正常に実行されるまで、品質設定は完了ではありません。

ルール 4： ESLint と Prettier の両方を設定する場合、eslint-config-prettier は必須です。

---

TodoWrite 形式（必須）：

- Invoke ln-741-linter-configurator (pending)
- Invoke ln-742-precommit-setup (pending)
- Invoke ln-743-test-infrastructure (pending)
- Verify quality pipeline (pending)

ワーカーの呼び出し（必須）

ホストスキルの呼び出し： Skill(skill: "...", args: "...") による委任は必須です。

• Claude：Skill ツールを上記のとおり正確に呼び出します。
• Codex：Skill ツールがない場合は、利用可能なスキルから指定されたスキルを探し、その SKILL.md を読み、args を $ARGUMENTS として扱ってスキルのワークフローを実行し、その結果または成果物を持ってここに戻ります。
• ワーカーのロジックをインラインで実行したり、対象のスキルを実行せずにワーカーを完了扱いにしたりしないでください。

フェーズ	ワーカー	コンテキスト
3a	ln-741-linter-configurator	共有（Skill ツール）— ESLint/Prettier、editorconfig、Ruff
3b	ln-742-precommit-setup	共有（Skill ツール）— Husky、lint-staged、commitlint
3c	ln-743-test-infrastructure	共有（Skill ツール）— Vitest、xUnit、pytest

すべてのワーカー： Skill ツール経由で呼び出します。ワーカーにはコーディネーターのコンテキストが共有されます。

完了の定義

• 検出されたすべての技術スタックに、適切な品質ツールが用意されている
• 既存の設定が保持されているか、バックアップされている
• リントコマンドがエラーなく実行される
• フォーマットコマンドがエラーなく実行される
• テストコマンドが実行され、サンプルテストが合格する
• テストコミット時にプリコミットフックが実行される
• インストールされたすべてのツールとコマンドがユーザーに通知されている

---

フェーズ 5：メタ分析

参考資料（任意）：ユーザーから実行後のメタ分析またはプロトコル形式の実行振り返りを求められた場合に限り、references/meta_analysis_protocol.md を読み込みます。

スキルの種類：execution-orchestrator。依頼された場合は、プロトコル§7に従ってこのセッションを分析します。プロトコルの形式に従って出力します。

---

参考ファイル

ファイル	用途
stack_detection.md	詳細な検出ルール
verification_checklist.md	完全な検証チェックリスト

---

エラー処理

エラー	原因	解決方法
スタックが検出されない	プロジェクトが空	想定しているスタックをユーザーに尋ねる
ワーカーの失敗	依存関係の不足	前提条件をインストールして再試行する
検証の失敗	設定エラー	該当するツールの出力を確認して修正する
フックが機能しない	Git が初期化されていない	まず git init を実行する

---

バージョン： 3.0.0 最終更新日： 2026-03-18