AgentSkillsCN

musubix-traceability

管理需求、设计、代码与测试之间可追溯性的指南,可用于开展影响分析与矩阵构建。

SKILL.md
--- frontmatter
name: musubix-traceability
description: 要件・設計・コード・テスト間のトレーサビリティ管理ガイド。影響分析・マトリクス作成に使用。
license: MIT

Traceability Skill

Article V - Traceability: 100%双方向トレーサビリティを維持。

Traceability Chain

code
REQ-* ↔ DES-* ↔ TSK-* ↔ Code ↔ Tests

WHEN → DO

WHENDO
要件作成REQ-* IDを付与
設計作成DES-* IDを付与、REQ-*に紐付け
タスク作成TSK-* IDを付与、DES-*・REQ-*に紐付け
コード作成@requirement, @design タグ追加
テスト作成@requirement, @design タグ追加
要件変更影響分析を実施

Traceability Matrix

markdown
| 要件ID | 設計ID | タスクID | コード | テスト |
|--------|--------|---------|--------|--------|
| REQ-AUTH-001 | DES-AUTH-001 | TSK-001 | auth-service.ts | auth.test.ts |
| REQ-AUTH-002 | DES-AUTH-001 | TSK-002 | token-manager.ts | token.test.ts |

Code Traceability

typescript
/**
 * AuthService - 認証サービス
 * @requirement REQ-AUTH-001
 * @design DES-AUTH-001
 * @task TSK-001
 */
export class AuthService { ... }

Impact Analysis

要件変更時の影響範囲特定:

code
REQ-AUTH-001 変更
    ↓
DES-AUTH-001 (設計)
    ↓
TSK-001, TSK-002 (タスク)
    ↓
auth-service.ts, token-manager.ts (コード)
    ↓
auth.test.ts, token.test.ts (テスト)

Verification Checklist

  • 全要件に設計がリンク
  • 全設計にタスクがリンク
  • 全コードにトレーサビリティコメント
  • 全テストに@requirementタグ

CLI

bash
npx musubix trace matrix           # マトリクス生成
npx musubix trace impact REQ-*     # 影響分析
npx musubix trace validate         # リンク検証
npx musubix trace sync             # 自動更新

出力例

code
┌─────────────────────────────────────────┐
│ Traceability Report                     │
├─────────────────────────────────────────┤
│ Requirements: 5 (100% linked)           │
│ Designs:      3 (100% linked)           │
│ Tasks:        8 (100% linked)           │
│ Code Files:   12 (100% tagged)          │
│ Test Files:   12 (100% tagged)          │
│ Coverage:     100%                      │
└─────────────────────────────────────────┘