仕様誤解を早期発見する観測。仕様の曖昧さ、仮定の明文化、受入条件のテスト化を行う。Use when: 新機能設計前、要件レビュー、仕様が曖昧、何を作るべきか不明、受入条件を決めたい、PRで仕様との乖離をチェックしたい時、生成コードの受入判断時。
This skill inherits all available tools. When active, it can use any tool Claude has access to.
assets/assumptions-log.md仕様誤解は「型も通る・テストも通るのに"違うものが出来ている"」という最も厄介な失敗モード。 このスキルは、仕様の曖昧さと誤解を早期に露出させ、実装前に問題を発見する。
生成前/後に「仮定したこと・未確認のこと」を明文化する。
assets/assumptions-log.md テンプレートを使用。
抽出すべき仮定の例:
受入条件(Acceptance Criteria)を具体例として記述する。
形式:
Given: [前提条件]
When: [操作]
Then: [期待結果]
必須の例:
Step 2の例をテストコードに変換する。
ポイント:
仮定ログを成果物として残し、差分レビュー対象にする。 これがないと「何を勘違いして作ったか」が追えず、精度改善ループが回らない。
assumptions-log.md: 仮定・未確認事項の一覧「ユーザー認証機能を実装して」
仮定ログ:
## 仮定・未確認事項
| ID | 仮定 | 根拠 | 検証方法 | ステータス |
|----|------|------|----------|-----------|
| A1 | パスワードは8文字以上 | 一般的な慣習 | 要確認 | 未検証 |
| A2 | セッションは24時間で失効 | 仮定 | 要確認 | 未検証 |
| A3 | 同一アカウントの同時ログインは許可 | 仮定 | 要確認 | 未検証 |
受入テスト例:
Given: 有効なメールアドレスと8文字以上のパスワード
When: ログインを試行する
Then: セッションが作成され、ユーザー情報が返される
Given: 存在しないメールアドレス
When: ログインを試行する
Then: 認証エラーが返され、セッションは作成されない(否定例)