QAの品質定義をClaude Code Agent Skillsに落とし込む（LayerX事例）

概要

LayerX QAエンジニアの小山さんが、バクラク事業部での品質定義やテスト戦略を Claude Code Agent Skills に落とし込み、「早期テストの原則」を実践した取り組み。「QAの言語化がAI時代のレバレッジになる」という主張。

記事: https://tech.layerx.co.jp/entry/articulating_quality

詳細

なぜ QA の言語化が重要か

AI コーディングエージェント（Claude Code など）は、テスト戦略が曖昧だと「とりあえずユニットテストを書く」という最小公倍数的な出力しかしない。品質基準を明文化して Skill に組み込むことで、エージェントが「何をテストすべきか」を判断できるようになる。

Claude Code Agent Skills の活用パターン

# qa-skill.md（Agent Skillの例）
## テスト戦略
- ユニットテスト: ドメインロジックのみ
- 統合テスト: DB境界・外部API境界
- E2Eテスト: クリティカルパスのみ

## 品質定義
- 受け入れ条件は Given-When-Then 形式
- 境界値テストを必須とする
- 副作用のあるメソッドには必ず統合テストを書く

早期テストの原則（Shift Left Testing）

品質保証のコストは後工程ほど指数的に上がる。要件定義・設計段階で品質基準を決め、実装と同時にテストを書く。AI エージェントにこの原則を Skill として与えることで、コード生成と同時に適切なテストも生成できる。

なぜ重要か / いつ使うか

• Claude Code を業務で使い始めたチームが「AIが書くテストの品質が低い」と感じるとき
• QA 基準を暗黙知から形式知に変えたいとき
• チームの品質定義をドキュメントではなく実行可能な形で共有したいとき
• AI時代のQAエンジニアの価値は「何をテストすべきかを言語化する能力」に移行している