AgentSkillsCN

dora-validate

验证 DORA 指标的计算逻辑是否合理,并与官方标准保持一致。

SKILL.md
--- frontmatter
name: dora-validate
description: DORA metrics計算ロジックの正当性を検証し、公式基準との整合性をチェック
user-invocable: true
allowed-tools: Bash, Read, Grep, Glob, WebFetch

DORA metrics検証スキル

DORA metrics計算ロジックの正当性を検証します。

実行手順

  1. 現在の閾値設定を確認 src/config/doraThresholds.ts を読み取ってください。

  2. DORA公式ドキュメントとの整合性チェック

    DORA公式の最新レポートから以下の基準を確認:

    4つのキーメトリクス

    メトリクスEliteHighMediumLow
    Deployment Frequencyオンデマンド(1日複数回)1日〜1週間に1回1週間〜1ヶ月に1回1ヶ月以上
    Lead Time for Changes1日未満1日〜1週間1週間〜1ヶ月1ヶ月以上
    Change Failure Rate5%未満5%〜10%10%〜15%15%以上
    Mean Time to Recovery1時間未満1日未満1日〜1週間1週間以上
  3. 計算ロジックの検証

    以下のファイルを確認し、計算が正しいか検証:

    • src/utils/metrics/dora.ts
    • src/utils/metrics/extended.ts

    チェック項目:

    • Deployment Frequency: マージ数/期間の計算は正しいか
    • Lead Time: 最初のコミット〜マージまでの時間計算は正しいか
    • CFR: (障害PR数 / 全PR数) × 100 の計算は正しいか
    • MTTR: 障害発生〜復旧までの平均時間計算は正しいか
  4. テストの確認

    bash
    bun test tests/unit/metrics.test.ts
    
  5. 検証結果の報告

    code
    ## DORA Metrics検証結果
    
    ### 閾値設定
    - 公式ドキュメントとの整合性: OK / 要更新
    
    ### 計算ロジック
    - Deployment Frequency: 正確 / 要修正
    - Lead Time for Changes: 正確 / 要修正
    - Change Failure Rate: 正確 / 要修正
    - Mean Time to Recovery: 正確 / 要修正
    
    ### テスト
    - テストカバレッジ: 十分 / 追加推奨
    
    ### 推奨事項
    - (あれば記載)
    

参考リンク