logvalet:health

logvalet-health

Backlog プロジェクトの健全性（停滞課題・ブロッカー・ユーザー負荷）を確認する。

For full logvalet CLI documentation, see the logvalet skill.

---

When to use this skill

Use logvalet-health when you need to:

• identify stale (long-unupdated) issues that may be blocking progress
• detect high-priority unassigned or overdue items
• understand team member workload distribution
• prepare for a project review, sprint planning, or standup

---

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 scope

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

• --days: 停滞とみなす日数（デフォルト: 7）
• --include-comments: コメントを含む分析を行うか（デフォルト: false）
• --exclude-status: 除外するステータス（例: "完了,却下"）

If the user wants a quick overview without customization, skip and use defaults.

Step 3: Fetch health data

Run all three commands in parallel:

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

Or fetch the individual components in parallel for more control:

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

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

lv user workload PROJECT_KEY --days DAYS [--exclude-status "STATUS1,STATUS2"] -f md

Optional: ウォッチ課題データ

ウォッチされている課題が停滞していることは「多くの人が気にしているのに進んでいない」という強いシグナルになる。 Watch CLI が利用可能な場合、以下も並列で取得する:

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

このデータは Step 4 で停滞課題と突合し、ウォッチされている停滞課題を特定するために使用する。 Watch CLI（M17）が未実装の場合、このステップはスキップする。

Step 4: Format output

Combine results into a structured health report:

## プロジェクト健全性レポート — PROJECT_KEY

> 分析期間: DAYS日 / 生成日時: YYYY-MM-DD

---

### 停滞課題 (N件)

<stale issues table or "なし">

---

### ブロッカー

#### 未アサイン高優先度課題 (N件)
<blocker issues table or "なし">

#### 期限超過課題 (N件)
<overdue issues table or "なし">

---

### ユーザー負荷

<user workload table>

---

### 👁 ウォッチ中の停滞課題 (N件)

<ウォッチしている課題のうち停滞しているもの、または "なし">

---

**サマリー:**
- 停滞課題: N件
- ブロッカー候補: N件
- 最多担当者: UserName (N件)
- ウォッチ中の停滞課題: N件
- 要対応アクション: <action items if any>

Step 5: No writes

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

If the user wants to act on findings (update an issue, reassign, etc.), switch to the logvalet skill.

---

Notes

• project health is the integrated command — use it when you want a single call
• Use individual commands (issue stale, project blockers, user workload) when you need to customize flags independently
• --exclude-status "完了,却下" is recommended to filter out resolved items
• --include-comments adds comment analysis for deeper blocker detection but is slower
• If any section returns no items, show "なし" in that section
• ウォッチ課題の停滞チェックは、watching list と issue stale の結果を突合して行う。ウォッチ一覧に含まれる課題キーが停滞課題リストにも存在する場合、それはウォッチ中の停滞課題として報告する
• Watch CLI（M17）が未実装の場合、ウォッチ関連セクションはスキップし、既存のヘルスチェックのみ実施する

---

Anti-patterns

• Do not run health checks on write-protected or archived projects without confirming with the user
• Do not auto-update issues based on health findings — always ask before writing
• Do not skip the project identification step — never guess the project key