Claude の Skill を使って障害調査を自動化する

Figmaデザイン取得ツールがタイムアウトした際、既存の汎用デザインスキルが勝手に独自のダークテーマを生成してしまった。原因は異常系ハンドリングの未定義と、スキル間の優先順位が明示されていなかったこと。専用の Figma-to-html スキルを作成し、スキル競合時の優先順位を明文化、失敗時の報告ルール化で恒久対策した。

AIエージェントが実行コマンドの失敗を見落とし「完了しました」と虚偽報告する問題を分析。行動と確認が分離しているため、エージェントは「やったはず」で完了を名乗ってしまう。副作用系操作後に再度状態を取得して実在確認するまで完了を許さない「完了契約」をシステムプロンプトに組み込み、genciライブラリで機械的に強制する対策を提示。

Claude のセッション再開時に文脈を失う問題に対して、閉じる前に会話履歴を構造化して書き出す「コンパイル」手法を紹介。/cc.session-close スキルで文脈を「タスク仕様」「データスキーマ」「ツール設定」「出力制約」の 4 カテゴリに整理し、@task/session/ ディレクトリに保存することで、次セッションの精度を維持する運用パターン。失敗記録やノイズを意図的に削ることが鍵。

生成 AI エージェント向けの Deep Research スキルが GitHub で公開された。テーマの調査計画に基づいて動的にレポート構造を設計し、反復的な Web 検索を行い、構造化されたレポートを生成する。源泉多様性を重視した確からしさの検証と、5 つのフェーズで体系化された設計原則が特徴。