majiayu000 Post-Implementation Validator
実装完了後のテスト、lint、ベストプラクティスレビューを自動実行する。
ワークフロー
- 変更ファイル検出 →
scripts/detect-changes.shを実行 - プロジェクト判定 → パスパターンから適用ツールを決定
- Lint実行 → エラー時は自動修正を試行（最大3回）
- テスト実行 → 失敗時は修正を提案
- ベストプラクティスレビュー → references/ を参照してチェック
実装スタイル
Degrees of Freedom: Medium
理由:
- 検出→判定→実行の流れは固定（Low的要素）
- 自動修正リトライやエラー解析は判断が必要（High的要素）
- バランスを取ってMediumとする
自律的に実行
- 変更ファイル検出
- プロジェクトタイプ判定
- lint/test実行
- 自動修正リトライ（最大3回）
ユーザー確認が必要
- スキル実行開始の承認（初回トリガー時）
- 手動修正が必要な場合の対処方針
- 複数プロジェクト変更時の処理順序確認（オプション）
プロジェクト別コマンドマッピング
Go
- パスパターン:
**/*.go - テスト: デフォルトは
go test -shuffle on -race -cover ./... - Lint: デフォルトは
go vet ./... - 自動修正: デフォルトは非対応（手動修正が必要）
- ベストプラクティス:
references/go-best-practices.mdを参照
環境変数でカスタムコマンドを指定可能:
GO_TEST_CMD: テストコマンド（例:make test）GO_TEST_FLAGS: テストフラグ（GO_TEST_CMD未指定時のみ有効）GO_LINT_CMD: Lintコマンド（例:golangci-lint run）GO_FIX_CMD: 自動修正コマンド（例:gofmt -w . && goimports -w .）
TypeScript/React
- パスパターン:
**/*.{ts,tsx} - テスト: package.json から自動検出、または環境変数で指定
- Lint: package.json から自動検出、または環境変数で指定
- 自動修正: package.json から自動検出、または環境変数で指定
- ベストプラクティス:
references/typescript-react-best-practices.mdを参照
環境変数でカスタムコマンドを指定可能:
TS_TEST_CMD: テストコマンド（例:pnpm test）TS_LINT_CMD: Lintコマンド（例:pnpm run lint）TS_FIX_CMD: 自動修正コマンド（例:pnpm run lint:fix）
Terraform
- パスパターン:
**/*.tf - テスト: デフォルトは
terraform validate - Lint: デフォルトは
terraform fmt -check -recursive - 自動修正: デフォルトは
terraform fmt -recursive - ベストプラクティス:
references/terraform-best-practices.mdを参照
環境変数でカスタムコマンドを指定可能:
TF_TEST_CMD: テストコマンド（例:terratest）TF_LINT_CMD: Lintコマンド（例:tflint）TF_FIX_CMD: 自動修正コマンド（例:terraform fmt -recursive）
自動修正ループ
エラー発生時の自動修正フロー:
- 自動修正コマンドを実行
- Lint/テストを再実行
- 成功すれば終了、失敗なら1に戻る
- 最大3回リトライ後、ユーザーに手動対応を依頼
処理順序
複数プロジェクトに変更がある場合、以下の順序で処理:
- Terraform (インフラ) - 最優先
- Go (バックエンド)
- TypeScript/React (フロントエンド)
出力形式
成功時
## Post-Implementation Validator 結果
### テスト: PASS
- 全 X テストがパス
### Lint: PASS
- エラーなし
### ベストプラクティス: PASS
- 全項目クリア
問題検出時
## Post-Implementation Validator 結果
### テスト: FAIL
- 失敗テスト: X件
- [エラー詳細]
### Lint: FAIL (自動修正済み)
- 修正ファイル: X件
### ベストプラクティス: WARNING
- [ ] 問題1
- [ ] 問題2
### 推奨アクション
1. ...
スクリプト
scripts/detect-changes.sh- 変更ファイルを検出しJSON形式で出力scripts/run-lint.sh <project> <workdir>- プロジェクト別にLint実行scripts/run-tests.sh <project> <workdir>- プロジェクト別にテスト実行scripts/auto-fix.sh <project> <workdir>- 自動修正を試行
依存関係
以下のツールがインストールされている必要があります:
必須
git- 変更ファイル検出bash4.0+ - スクリプト実行（POSIX準拠）
プロジェクト別
Go:
goコマンド（1.18+推奨）- デフォルトで使用:
go vet,go test - オプション（環境変数で指定可能）:
golangci-lint,goimports,gofmt
TypeScript/React:
npm,yarn, またはpnpm- package.json内に
lint,testスクリプトが定義されていること - オプション: eslintプラグイン、prettier
Terraform:
terraform0.12+- オプション（環境変数で指定可能）:
tflint,tfsec,checkov
ベストプラクティス参照
変更ファイルの言語/フレームワークに応じて以下を参照:
- Go:
references/go-best-practices.md - TypeScript/React:
references/typescript-react-best-practices.md - Terraform:
references/terraform-best-practices.md
効率的な読み込み（grepパターン）
各referencesは700-1500行と大きいため、問題検出時は以下のgrepパターンで必要箇所のみ読み込む:
go-best-practices.md (720行):
- エラー検出時:
grep -A 10 -B 2 "## エラーハンドリング" - 命名問題:
grep -A 10 -B 2 "## 命名規則" - 並行処理:
grep -A 10 -B 2 "## 並行処理" - テスト:
grep -A 10 -B 2 "## テスト"
typescript-react-best-practices.md (1506行):
- Hooks問題:
grep -A 10 -B 2 "## Hooks使用法" - 型エラー:
grep -A 10 -B 2 "## 型定義" - パフォーマンス:
grep -A 10 -B 2 "## パフォーマンス最適化"
terraform-best-practices.md (1467行):
- セキュリティ:
grep -A 10 -B 2 "## セキュリティ" - 状態管理:
grep -A 10 -B 2 "## 状態管理"