【要約】Claude Code の検証を Skill にするか shell コマンドにするか、両方走らせて見えてきた境界 [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者がAI Agentの出力品質を担保しようとする際、検証ロジックの配置場所によって以下の課題に直面する。
- ・検証の確実性の欠如
- ・リソースとコストの増大
- ・観測性と管理の困難さ
- ・フィードバックループの停滞
// Approach
開発者は、検証の性質と実行されるコンテキストに応じて、SkillとShellコマンドを使い分ける設計を採用した。
- ・Runtime（ワークフロー）へのコマンド適用
verify_commands（Shellコマンド）を配置する。これにより、Claudeの判断を介さず、exit codeに基づいた決定論的な検証を強制する。- ・Dev-loop（開発補助）へのSkill適用
- ・判断基準のスライダー化
// Result
開発チームは、検証の目的ごとに道具を使い分けることで、システムの信頼性と開発体験の両立を実現した。
- ・Runtimeの安定化
notion_compatible.json等のワークフローにおいて、on_successからverifyステップへ確実に遷移する構造を構築した。- ・開発補助の高度化
bug-analyzerやtest-generator等のSkillにより、人間にとって読みやすい自然言語でのフィードバックを可能にした。- ・運用の明確化
Senior Engineer Insight
> AIの不確実性を「システム全体の信頼性」に持ち込ませない設計思想が極めて実践的である。CI/CDや自動化パイプラインのような、失敗が許されない決定論的な領域には必ずShellコマンドを配置し、AIの判断を介在させない。一方で、人間との対話や複雑な文脈判断が必要な領域にはSkillを配置し、開発体験を向上させる。この「決定論的レイヤー」と「確率論的レイヤー」の分離は、AI Agentを実戦投入する際の鉄則と言える。