logvalet:risk

logvalet-risk

lv project health, lv project blockers, lv issue stale を統合し、LLM がプロジェクトの統合リスク評価・推奨アクションを生成する。

For full logvalet CLI documentation, see the logvalet skill.

---

When to use this skill

Use logvalet-risk when you need to:

• assess the overall risk posture of a project at a glance
• identify the most critical risks and their interdependencies
• generate prioritized recommended actions for a project review or sprint planning
• create a risk report for stakeholders
• proactively surface escalation-worthy issues before they become blockers

---

Workflow

Step 1: Identify project

If the user provides a project key, use it directly.

If not provided, list available projects:

lv project list -f md

Then ask the user to select a project.

Step 2: Determine analysis parameters

Ask in a single question (if not already specified):

• --days: 停滞とみなす基準日数（デフォルト: 7）
• --exclude-status: 除外するステータス（例: "完了,却下"）

If the user wants a quick risk overview, use defaults.

Step 3: Fetch risk materials in parallel

Run all three commands in parallel:

lv project health PROJECT_KEY --days DAYS [--exclude-status "STATUS1,STATUS2"] -f json

lv project blockers PROJECT_KEY --days DAYS [--exclude-status "STATUS1,STATUS2"] -f json

lv issue stale -k PROJECT_KEY --days DAYS [--exclude-status "STATUS1,STATUS2"] -f json

Optional: ウォッチ課題データ

自分がウォッチしている課題にリスクがある場合、そのリスクは自分の仕事にも波及する。 Watch CLI が利用可能な場合、以下も並列で取得する:

lv watching list --user-id me -f json

Watch CLI（M17）が未実装の場合、このステップはスキップする。

The materials provide:

project health:

• integrated view: stale count, blocker count, user workload distribution
• overall health signals

project blockers:

• unassigned_high_priority: 未アサインの高優先度課題
• overdue_issues: 期限超過課題
• stale_high_priority: 停滞している高優先度課題
• severity (high/medium/low)

issue stale:

• 停滞日数・最終更新日
• stale issues list with days_stale

Step 4: Integrate and assess risk

Combine the three data sources to evaluate risk across dimensions:

Dimension 1: Schedule Risk

• Overdue issues count and severity
• Stale high-priority issues
• Issues with due dates approaching (next 7 days)

Dimension 2: Resource Risk

• Unassigned high-priority issues
• Workload imbalance (one member carries too many issues)
• Members with zero activity (may be blocked or unavailable)

Dimension 3: Quality / Progress Risk

• Long-stale issues (possible abandonment)
• High comment-to-resolution ratio (discussion without decisions)
• Repeated status resets

Dimension 4: Risk Chains

• Are any risks interdependent? (e.g., key person has all unassigned issues AND highest workload)
• Identify cascading risks if they exist

Risk scoring:

• Count issues with severity: high as high-risk signals
• Count issues with severity: medium as medium-risk signals
• Derive overall project risk level:
  • Critical: 3+ high-severity signals across multiple dimensions
  • High: 2+ high-severity signals or 1 high + 3+ medium
  • Medium: 1 high-severity signal or 3+ medium
  • Low: 0-2 medium signals

Step 5: Present integrated risk report

## 統合リスク評価レポート — PROJECT_KEY

> 分析期間: DAYS日 / 生成日時: YYYY-MM-DD
> **総合リスクレベル: Critical / High / Medium / Low**

---

### リスクサマリー

| リスク次元 | 件数 | レベル |
|-----------|------|--------|
| スケジュールリスク | N件 | High/Medium/Low |
| リソースリスク | N件 | High/Medium/Low |
| 進捗リスク | N件 | High/Medium/Low |
| リスク連鎖 | N件 | High/Medium/Low |

---

### 高リスク項目（要即時対応）

1. **[課題キー] <課題サマリー>**
   - リスク種別: <スケジュール / リソース / 進捗>
   - 詳細: <なぜリスクか>
   - 推奨アクション: <具体的な次のステップ>

2. ...

---

### 中リスク項目（今週対応推奨）

1. **[課題キー] <課題サマリー>**
   - リスク種別: <種別>
   - 詳細: <なぜリスクか>
   - 推奨アクション: <具体的な次のステップ>

2. ...

---

### リスク連鎖

<特定された連鎖リスクがあれば記載。なければ「リスク連鎖なし」>

---

### 👁 ウォッチ課題に関連するリスク

自分がウォッチしている課題のうち、上記リスク項目に該当するものがあれば個別に提示する。
ウォッチ課題は担当ではないが、進捗や状態が自分の仕事に影響する（依存先、レビュー待ち等）。

1. **[課題キー] <課題サマリー>**
   - 担当者: <UserName>
   - リスク種別: <スケジュール / リソース / 進捗>
   - あなたへの影響: <なぜこの課題のリスクがあなたに影響するか>

（ウォッチ課題にリスクがない場合は「ウォッチ課題にリスクなし」と表示）

---

### 推奨アクション（優先順位付き）

1. **[即時]** <最優先アクション> — 担当: <UserName or 未定>
2. **[今日中]** <次に重要なアクション>
3. **[今週中]** <中優先アクション>
4. ...（最大7件）

---

**判断の根拠:**
- 分析したブロッカー: N件（高: N、中: N、低: N）
- 停滞課題: N件（最長 N日停滞）
- 未アサイン高優先度課題: N件

Step 6: No writes

This is a read-only skill. No issue updates are performed.

After the user reviews the report, they can:

• use logvalet-triage to address individual unassigned or mis-prioritized issues
• use the logvalet skill to run issue update for specific changes
• use logvalet-health for ongoing health monitoring

---

Notes

• 3コマンドは必ず並列実行する（API 呼び出し最小化・速度向上）
• --exclude-status "完了,却下" の指定を推奨（解決済み課題を除外）
• project health は統合ビューのため、それだけでも基本的なリスク評価には十分
• project blockers と issue stale は詳細根拠として活用
• リスクレベル評価は mechanical ではなく contextual — コメント数・期限までの残日数・プロジェクト規模を考慮する
• ウォッチ課題のリスク評価は、ウォッチ一覧の課題キーを project health / project blockers / issue stale の結果と突合して行う
• Watch CLI（M17）が未実装の場合、ウォッチ関連セクションはスキップし、プロジェクト全体のリスク評価のみ実施する

---

Anti-patterns

• Do not auto-update any issues — risk assessment is read-only
• Do not present a risk report without recommending concrete actions
• Do not treat every stale issue as high risk — use severity signals from project blockers
• Do not run the three fetch commands sequentially — always run in parallel
• Do not skip the project identification step — never guess the project key