workflow-enforcer-skill

すべてのプロジェクトでワークフローの規律を徹底し、Claude が応答前に専門エージェントを確認し、スキル／エージェントの使用を宣言し、複数ステップのタスクには TodoWrite の todo を作成するようにします。このスキルは毎セッションで自動的に有効化され、一貫した品質とツール活用を維持します。

<quick_start> あらゆるリクエストに応答する前に:

1. エージェントを確認: このタスクに特化したエージェントはありますか？
2. 宣言: 「[エージェント] を使って [アクション] します」
3. todo を作成: 複数ステップの作業には TodoWrite を使用します
4. 追跡: in_progress → completed とマークします

リクエスト	エージェント
バグ修正	debugging-toolkit:debugger
コードレビュー	code-documentation:code-reviewer
テスト作成	unit-testing:test-automator
</quick_start>

<success_criteria> ワークフローの徹底は、次の場合に成功です:

• 該当するすべてのタスクで専門エージェントを特定して使用している
• 作業開始前にエージェントの使用を宣言している
• すべての複数ステップのタスク（3 ステップ以上）で TodoWrite を使用している
• 進捗を in_progress と completed のステータスで追跡している
• エージェントを省略する言い訳（「簡単だから」「ちょっとした修正だけだから」）がない </success_criteria>

<mandatory_protocol> あらゆるユーザーリクエストに応答する前に、このチェックリストを完了してください:

1. 専門エージェントを確認 - このタスク種別に対応するエージェントはありますか？
2. 使用を宣言 - 「[エージェント] を使って [アクション] します」
3. todo／タスクを作成 - 複数ステップの作業には TaskCreate（推奨）または TodoWrite を使用します
4. 進捗を追跡 - 開始前に in_progress、終了後に completed とマークします

クイックリファレンス

ユーザーリクエスト	使用するエージェント
バグ／エラーの修正	debugging-toolkit:debugger
コードレビュー	code-documentation:code-reviewer
テスト作成	unit-testing:test-automator
パフォーマンス最適化	performance-engineer
セキュリティ監査	security-auditor
デプロイ／CI/CD	deployment-engineer
ドキュメント作成	docs-architect
コードのリファクタリング	legacy-modernizer
AI 機能の構築	ai-engineer
本番インシデント	incident-responder

70 以上のエージェントの完全なカタログについては、reference/agents-catalog.md を参照してください。

使用方法

ステップ 1: タスク種別を特定する

リクエストを分類します:

• デバッグ？ → デバッグ用エージェント
• コードレビュー？ → レビュー用エージェント
• テスト？ → テスト自動化エージェント
• パフォーマンス？ → パフォーマンスエンジニア
• セキュリティ？ → セキュリティ監査担当
• デプロイ？ → デプロイエンジニア

ステップ 2: 宣言する

作業を開始する前に:

「[エージェント名] を使って [実施内容] します」

例:

• 「debugging-toolkit:debugger を使って、この認証エラーを追跡します」
• 「python-development:python-pro を使って、この非同期コードをリファクタリングします」

ステップ 3: todo／タスクを作成する

複数ステップのタスクには、TaskCreate（推奨 — ライブ UI スピナーを表示）または TodoWrite（フォールバック）を使用します:

TaskCreate（ネイティブの進捗 UI）:

1. 作業を具体的な項目に分割します
2. 各項目に対して TaskCreate({ subject: "...", activeForm: "..." }) を使用します
3. 開始前に TaskUpdate({ taskId, status: "in_progress" }) を使用 → スピナーを表示
4. 終了後に TaskUpdate({ taskId, status: "completed" }) を使用 → チェックマークを表示
5. タスク間の順序依存には addBlockedBy を使用します

TodoWrite（よりシンプルなテキストベース）:

1. 作業を具体的な項目に分割します
2. TodoWrite を使ってリストを作成します
3. 開始前に in_progress、終了後に completed とマークします

ステップ 4: エージェントの規律に従う

エージェントの種類ごとに独自の方法論があります:

• TDD エージェント → まずテストを書く
• デバッグエージェント → 体系的な根本原因分析
• コードレビューエージェント → レビューチェックリストに従う
• デプロイエージェント → デプロイプロトコルに従う

避けるべきよくある正当化

以下のいずれかを考えたなら、STOP して適切なエージェントを使用してください:

• 「これは単純だから、エージェントは必要ない」
• 「ちょっと素早くこれを修正しよう」
• 「これを手動でデバッグできる」
• 「これに正式なレビューは必要ない」
• 「今はテストをスキップしよう」

正しい考え方: 「このタスクにはどの専門エージェントを使うべきか?」

ガイドライン

• このスキルはすべてのセッション、すべてのプロジェクト、すべてのタスクに適用されます
• 例外も、正当化も、近道もありません
• 迷ったときは、reference/agents-catalog.md を確認してください

結果サイドカーを出力する

最後のステップとして、~/.claude/skill-analytics/last-outcome-workflow-enforcer-skill.json に書き込みます:

{"ts":"[UTC ISO8601]","skill":"workflow-enforcer-skill","version":"1.0.0","variant":"default",
 "status":"[success|partial|error]","runtime_ms":[estimated ms from start],
 "metrics":{"checks_performed":[n],"agents_recommended":[n],"violations_caught":[n]},
 "error":null,"session_id":"[YYYY-MM-DD]"}

一部のステージが失敗したが結果は生成された場合は、ステータス「partial」を使用してください。出力がまったく生成されなかった場合にのみ「error」を使用してください。 </mandatory_protocol>