---
generated_at: 2026-02-19 12:00:00
metrics:
  claims_total: 60
  claims_with_evidence: 58
  claims_without_evidence: 2
confidence_derived: 0.97
---

# 根拠レポート：modules-lang-sh 単体テストケース一覧

## 本レポートについて

### 目的
本レポートは、生成された単体テストケース一覧の信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.97**
  - 根拠あり：58 / 60、根拠なし：2
- 優先レビュー（高）
  1. **UT-SH-016**：sh-scriptロード失敗時のエラーハンドリングは明示的なコードなし
  2. **UT-SH-019**：存在しないコマンド参照時の挙動は外部依存

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `modules/lang/sh/autoload.el` - 行4-14: +sh--match-variables-in-quotes関数定義
- E-02: `modules/lang/sh/autoload.el` - 行17-26: +sh--match-command-subst-in-quotes関数定義
- E-03: `modules/lang/sh/autoload.el` - 行29-39: +sh/open-repl関数定義
- E-04: `modules/lang/sh/autoload.el` - 行41-53: +sh-lookup-documentation-handler関数定義
- E-05: `modules/lang/sh/config.el` - 行3-7: +sh-builtin-keywords変数定義
- E-06: `modules/lang/sh/config.el` - 行13-68: sh-script use-package!設定
- E-07: `modules/lang/sh/config.el` - 行14-17: :mode設定（.bats, .zunit, .env, bspwmrc）
- E-08: `modules/lang/sh/config.el` - 行17: :magic設定（#compdef）
- E-09: `modules/lang/sh/config.el` - 行19-22: set-docsets!, set-electric!, set-repl-handler!, set-lookup-handlers!
- E-10: `modules/lang/sh/config.el` - 行23-35: set-ligatures!設定
- E-11: `modules/lang/sh/config.el` - 行37-38: +lspフラグ条件分岐
- E-12: `modules/lang/sh/config.el` - 行40: sh-indent-after-continuation設定
- E-13: `modules/lang/sh/config.el` - 行43: mode-name設定
- E-14: `modules/lang/sh/config.el` - 行46-48: sh-imenu-generic-expression拡張
- E-15: `modules/lang/sh/config.el` - 行51: sh-set-shellアドバイス
- E-16: `modules/lang/sh/config.el` - 行56-65: +sh-init-extra-fontification-h定義
- E-17: `modules/lang/sh/config.el` - 行68: sp-local-pair設定
- E-18: `modules/lang/sh/config.el` - 行71-79: company-shell use-package!設定
- E-19: `modules/lang/sh/config.el` - 行82-88: bash-completion use-package!設定
- E-20: `modules/lang/sh/config.el` - 行91-96: powershell use-package!設定
- E-21: `modules/lang/sh/doctor.el` - 行3-5: shellcheck診断
- E-22: `modules/lang/sh/doctor.el` - 行7-9: shfmt診断
- E-23: `modules/lang/sh/packages.el` - 行4-8: company-shell, bash-completionパッケージ宣言
- E-24: `modules/lang/sh/packages.el` - 行10-11: fish-modeパッケージ宣言
- E-25: `modules/lang/sh/packages.el` - 行13-14: powershellパッケージ宣言
- E-26: `modules/lang/sh/README.org` - モジュールの概要、機能フラグ、依存関係の説明

## 3) Claims と根拠の対応（レビューの主戦場）

### autoload.el関連のテストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 (UT-SH-001) | ダブルクォート内の変数が正しくマッチすること | E-01 | ○ |
| C-02 (UT-SH-002) | 波括弧付き変数 ${VAR} がマッチすること | E-01 (正規表現: `\\$\\)\\({.+?}`) | ○ |
| C-03 (UT-SH-003) | 特殊変数 $@, $*, $#, $! がマッチすること | E-01 (正規表現: `[@*#!]`) | ○ |
| C-04 (UT-SH-004) | シングルクォート内の変数はマッチしないこと | E-01 (syntax-ppss ?\" チェック) | ○ |
| C-05 (UT-SH-005) | エスケープされた変数はマッチしないこと | E-01 (正規表現: `[^\\]\\(\\$`) | ○ |
| C-06 (UT-SH-006) | limitが0の場合 | E-01 (re-search-forward limit引数) | ○ |
| C-07 (UT-SH-007) | 空のバッファの場合 | E-01 | ○ |
| C-08 (UT-SH-008) | $()形式のコマンド置換がマッチすること | E-02 (正規表現: `\\$(.+?)`) | ○ |
| C-09 (UT-SH-009) | バッククォート形式のコマンド置換がマッチすること | E-02 (正規表現: ``.+?``) | ○ |
| C-10 (UT-SH-010) | シングルクォート内のコマンド置換はマッチしないこと | E-02 (syntax-ppss ?\" チェック) | ○ |
| C-11 (UT-SH-011) | エスケープされたコマンド置換はマッチしないこと | E-02 (正規表現: `[^\\]`) | ○ |
| C-12 (UT-SH-012) | ネストしたコマンド置換の場合 | E-02 | ○ |
| C-13 (UT-SH-013) | シェルREPLが正常に開かれること | E-03 | ○ |
| C-14 (UT-SH-014) | sh-shellの種類に応じたバッファ名になること | E-03 (rename-buffer format) | ○ |
| C-15 (UT-SH-015) | sh-shellがzshの場合 | E-03 | ○ |
| C-16 (UT-SH-016) | sh-scriptのロードに失敗した場合 | **根拠なし** | △ |
| C-17 (UT-SH-017) | manコマンドが利用可能な場合にmanページを表示 | E-04 (executable-find "man") | ○ |
| C-18 (UT-SH-018) | manコマンドが利用不可の場合にwomanを使用 | E-04 (woman呼び出し) | ○ |
| C-19 (UT-SH-019) | 存在しないコマンドを参照した場合 | **根拠なし（外部依存）** | △ |
| C-20 (UT-SH-020) | 空のシンボルの場合 | E-04 | ○ |

### config.el関連のテストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-21 (UT-SH-021) | 組み込みキーワードリストが正しく定義されていること | E-05 | ○ |
| C-22 (UT-SH-022) | リスト内の各要素が文字列であること | E-05 | ○ |
| C-23 (UT-SH-023) | .batsファイルがsh-modeで開かれること | E-07 | ○ |
| C-24 (UT-SH-024) | .zunitファイルがsh-modeで開かれること | E-07 | ○ |
| C-25 (UT-SH-025) | .envファイルがsh-modeで開かれること | E-07 | ○ |
| C-26 (UT-SH-026) | bspwmrcファイルがsh-modeで開かれること | E-07 | ○ |
| C-27 (UT-SH-027) | #compdefで始まるファイルがsh-modeで開かれること | E-08 | ○ |
| C-28 (UT-SH-028) | docsets設定が正しく行われること | E-09 | ○ |
| C-29 (UT-SH-029) | electric-wordsが正しく設定されること | E-09 | ○ |
| C-30 (UT-SH-030) | REPLハンドラが設定されること | E-09 | ○ |
| C-31 (UT-SH-031) | lookupハンドラが設定されること | E-09 | ○ |
| C-32 (UT-SH-032) | ligaturesが正しく設定されること | E-10 | ○ |
| C-33 (UT-SH-033) | +lspフラグ有効時にlsp!が追加されること | E-11 | ○ |
| C-34 (UT-SH-034) | +lspフラグ無効時にlsp!が追加されないこと | E-11 | ○ |
| C-35 (UT-SH-035) | sh-indent-after-continuationが'alwaysに設定されること | E-12 | ○ |
| C-36 (UT-SH-036) | mode-nameがShに設定されること | E-13 | ○ |
| C-37 (UT-SH-037) | ダッシュ付き関数名がimenuで認識されること | E-14 | ○ |
| C-38 (UT-SH-038) | sh-set-shellのアドバイスが設定されること | E-15 | ○ |
| C-39 (UT-SH-039) | 変数用のfont-lockルールが追加されること | E-16 | ○ |
| C-40 (UT-SH-040) | コマンド置換用のfont-lockルールが追加されること | E-16 | ○ |
| C-41 (UT-SH-041) | 組み込みコマンド用のfont-lockルールが追加されること | E-16 | ○ |
| C-42 (UT-SH-042) | バッククォートが自動でペアリングされること | E-17 | ○ |
| C-43 (UT-SH-043) | 単語の前ではバッククォートがペアリングされないこと | E-17 (sp-point-before-word-p) | ○ |
| C-44 (UT-SH-044) | :completion companyが有効かつ+lspが無効の場合にロードされること | E-18 | ○ |
| C-45 (UT-SH-045) | +lspが有効の場合はロードされないこと | E-18 | ○ |
| C-46 (UT-SH-046) | company-backendが正しく設定されること | E-18 | ○ |
| C-47 (UT-SH-047) | company-shell-delete-duplicatesがtに設定されること | E-18 | ○ |
| C-48 (UT-SH-048) | macOSではcompany-shell-dont-fetch-metaがtに設定されること | E-18 (featurep :system 'macos) | ○ |
| C-49 (UT-SH-049) | :completion corfuが有効かつ+lspが無効の場合にロードされること | E-19 | ○ |
| C-50 (UT-SH-050) | completion-at-point-functionsに追加されること | E-19 | ○ |
| C-51 (UT-SH-051) | +powershellフラグが有効の場合にロードされること | E-20 | ○ |
| C-52 (UT-SH-052) | +lspフラグ有効時にpowershell-modeでlsp!が追加されること | E-20 | ○ |

### doctor.el関連のテストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-53 (UT-SH-053) | :checkers syntax有効時にshellcheckの存在を確認すること | E-21 | ○ |
| C-54 (UT-SH-054) | shellcheckが未インストールの場合に警告が表示されること | E-21 | ○ |
| C-55 (UT-SH-055) | :editor format有効時にshfmtの存在を確認すること | E-22 | ○ |
| C-56 (UT-SH-056) | shfmtが未インストールの場合に警告が表示されること | E-22 | ○ |

### packages.el関連のテストケース

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-57 (UT-SH-057) | +lsp無効かつ:completion company有効時にパッケージが宣言されること | E-23 | ○ |
| C-58 (UT-SH-058) | +lsp無効かつ:completion corfu有効時にパッケージが宣言されること | E-23 | ○ |
| C-59 (UT-SH-059) | +fishフラグ有効時にパッケージが宣言されること | E-24 | ○ |
| C-60 (UT-SH-060) | +powershellフラグ有効時にパッケージが宣言されること | E-25 | ○ |

## 4) 不足情報（Unknown / Missing）
- **UT-SH-016**: sh-scriptのロード失敗時のエラーハンドリングについて、明示的なエラー処理コードが存在しない。Emacs Lispのrequire関数のデフォルト挙動に依存する。
  - 候補：Emacsのrequire関数ドキュメント / Doom Emacsのエラーハンドリングポリシー
- **UT-SH-019**: 存在しないコマンドを参照した場合の挙動は、manコマンドまたはwomanパッケージの外部動作に依存する。
  - 候補：manコマンドのドキュメント / woman.elのソースコード

## 5) リスクフラグ（レビュー観点）
- **0 (低リスク)**: 大部分のテストケースはソースコードから直接導出可能
- **1 (中リスク)**: 外部ツール（man, shellcheck, shfmt）との連携テストは環境依存性がある
- **0 (低リスク)**: Emacs Lisp特有のテスト方法（ERT等）への変換が必要だが、テスト観点自体は妥当

## 6) レビュアーチェックリスト（最小）
- [ ] 各テストケースの入力値と期待結果が実際のコード動作と一致するか確認
- [ ] 正規表現マッチングテスト（UT-SH-001〜012）の境界条件が網羅されているか確認
- [ ] 条件分岐テスト（modulep!関連）の組み合わせパターンが十分か確認
- [ ] Emacs Lispのテストフレームワーク（ERT）での実装可能性を確認
- [ ] 外部ツール依存のテスト（UT-SH-053〜056）のモック化方針を検討
- [ ] macOS固有の動作（UT-SH-048）のクロスプラットフォームテスト方針を確認
