traceabilitylisted
Install: claude install-skill SeckeyJP/j-six
# トレーサビリティ管理スキル
J-SIX プロセス全体を通じて、要件からコード・テスト・設計��までの追跡可能性を管理する。
## 追跡対象
```
要求 Spec(Why) → Design Spec(How) → タスク → テスト → コード → ADR → 設計書
```
## トレーサビリティマトリクス生成
以下のソースを解析してマトリクスを生成する:
### 入力ソース
| ソース | 場所 | 抽出情報 |
|---|---|---|
| 要求 Spec | `docs/specs/requirement-spec-*.md` | 要件ID、受入条件 |
| Design Spec | `docs/specs/design-spec-*.md` | 設計方針、技術選定 |
| ADR | `docs/adr/ADR-*.md` | 判断ID、関連Spec |
| テスト | テストディレクトリ | テストケース、カバー対象 |
| コード | ソースディレクトリ | 機能実装 |
| 設計書 | `docs/design-docs/` | 逆生成された設計書 |
### 出力フォーマット
```markdown
## トレーサビリティマトリクス
**生成日**: [日付]
### 要件 → 実装 追跡表
| 要件ID | 要件概要 | Design Spec | タスク | テスト | 実装 | ADR | 設計書 |
|---|---|---|---|---|---|---|---|
| REQ-001 | [概要] | ✅ DS-001 | ✅ TASK-001 | ✅ test/xxx | ✅ src/xxx | ADR-001 | ✅ |
| REQ-002 | [概要] | ✅ DS-001 | ✅ TASK-002 | ❌ 未作成 | ❌ 未実装 | - | - |
### カバレッジサマリー
| 追跡段階 | カバー率 |
|---|---|
| 要件 → Design Spec | XX% |
| 要件 → テスト | XX% |
| 要件 → 実装 | XX% |
| 技術判断 → ADR | XX% |
### ギャップ一覧
- [ ] REQ-002: テスト未作成、実装未着手
- [ ] [技術判断X]: ADR 未記録
```
## 検証ルール
1. 全ての要求 Spec の要件に対してテストが存在すること
2. 全てのテストに対応する実装が存在すること
3. 主要な技術判断に ADR が存在すること
4. 逆生成設計書が実装をカバーしていること
## 決定論的バックエンド
検証ルール 1(要件⇔テスト)は決定論的スクリプトで機械的に確認できる。
要件ファイルに `REQ-NNN`、テストに同タグを付けておくと:
```bash
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/jsix_traceability_check.py" \
--requirements docs/requirement-spec.md --tests tests
```
未トレース要件があれば終了コード 1。実例は `examples/approval-workflow/`(10/10 トレース済)。