logvalet-report

name

logvalet:report

description

Generate a Backlog activity report for specified users, teams, or projects over a time period: monthly report, weekly report, team activity summary, KPT retrospective material, and more. Use this skill whenever someone needs a shareable report or summary of Backlog activity. TRIGGER when: user says "レポート作成", "月次レポート", "活動レポート", "チームレポート", "backlogレポート", "activity report", "monthly report", "team report", "先月のレポート", "今月のレポート", "メンバーの活動", "チームの活動まとめ", "KPTレポート", "ふりかえりレポート", "活動報告", "月報", "週報", "進捗報告", "稼働報告", "generate a report", "activity summary", "team performance report", "期間レポート", "backlog 月報", "チームの成果", "実績報告". DO NOT TRIGGER when: user wants a quick daily/weekly digest without user breakdown (use digest-periodic) or wants project health metrics (use health).

logvalet-report

対象ユーザー/チーム/期間の Backlog 活動レポートを指定フォーマットで生成する。

For full logvalet CLI documentation, see the logvalet skill.

---

Workflow

Step 1: Gather parameters

Determine from the user's request:

パラメータ	必須	例
対象メンバー	○	ユーザー名、ユーザーID、またはチーム名
期間	○	this-month, last-month, 2026-02-01:2026-02-28
プロジェクトフィルタ	△	プロジェクトキー（省略時は全プロジェクト）

If any required parameter is missing, ask using AskUserQuestion in a single prompt.

Step 2: Resolve members

If a team name is given, get member list:

lv team list -f json

Parse the JSON to extract member IDs for the specified team.

If user names are given, resolve to IDs:

lv user list -f json

From the JSON response, use the id field (numeric integer) for each user. Do NOT use the userId field (which starts with * and is not accepted by user activity).

Step 3: Resolve period dates

user activity コマンドは RFC3339 形式（ISO 8601）の日時文字列を受け付ける。

指定	since	until
this-month	YYYY-MM-01T00:00:00Z	YYYY-MM-DDT23:59:59Z（今日）
last-month	YYYY-MM-01T00:00:00Z（先月1日）	YYYY-MM-DDT23:59:59Z（先月末日）
YYYY-MM-DD:YYYY-MM-DD	YYYY-MM-DDT00:00:00Z	YYYY-MM-DDT23:59:59Z

Step 4: Fetch activity data

For each member, fetch activities:

lv user activity USER_ID --since YYYY-MM-DDT00:00:00Z --until YYYY-MM-DDT23:59:59Z -f json

• USER_ID には lv user list の id フィールド（数値）を使う
• --since/--until は RFC3339 形式（YYYY-MM-DDT00:00:00Z）で指定する
• --limit は不要（CLIが自動ページネーションで全件取得する）

Run multiple members in parallel (multiple Bash tool calls in one message).

Step 5: Aggregate data

The user activity command returns a JSON array of raw Backlog activities. Each activity has:

{
  "id": 914382588,
  "type": 3,
  "created": "2026-03-23T07:24:56Z",
  "createdUser": {"id": 1537084, "name": "User Name"},
  "content": {
    "id": 141884975,
    "key_id": 1158,
    "summary": "Issue title"
  }
}

Activity type mapping:

type ID	レポートカテゴリ
1	課題作成
2, 14	課題更新
3	コメント
その他 (4-13, 15-21)	その他

Aggregation steps:

1. 統計テーブル: type でグルーピング → メンバーごとにカウント
2. 週別推移: created の日付を週ごとに集約
3. プロジェクト別: content.key_id からプロジェクトキーのプレフィックス部分で集約（content に key フィールドがあればそのプレフィックスを使用）
4. 活発な課題: issue key ごとにアクティビティ数をカウント、上位をランキング
5. Fact セクション: 各メンバーが関わった課題をプロジェクト別にリスト化

Step 6: Generate report

必ず以下のテンプレートに従って出力する:

# YYYY年MM月 Backlogレポート

> 生成日時: YYYY-MM-DD HH:MM:SS JST

## 📊 サマリー

### 対象期間
YYYY年MM月DD日 〜 YYYY年MM月DD日

### 対象メンバー
- **メンバー名1** (*userKey1)
- **メンバー名2** (*userKey2)

### アクティビティ統計

| メンバー | 課題作成 | コメント | 課題更新 | その他 | 合計 |
|---------|---------|----------|----------|--------|------|
| Name1   | X       | Y        | Z        | W      | T    |
| Name2   | X       | Y        | Z        | W      | T    |
| **合計** | **X**  | **Y**    | **Z**    | **W**  | **T**|

### 📈 日別アクティビティ推移

- MM月第1週 (DD-DD): N件
- MM月第2週 (DD-DD): N件
- MM月第3週 (DD-DD): N件
- MM月第4週 (DD-DD): N件

### 🎯 主要なアクティビティ

#### 📊 プロジェクト別アクティビティ数
1. **プロジェクト名** - N件
2. **プロジェクト名** - N件

#### 🔥 活発だった課題
1. **PROJ-123: 課題タイトル** (N件のアクティビティ)
2. **PROJ-456: 課題タイトル** (N件のアクティビティ)


## ふりかえり

### Fact (事実 / やったこと)

- プロジェクト名1 (PROJ1_KEY)
  - PROJ1_KEY-101 課題名
  - PROJ1_KEY-102 課題名

- プロジェクト名2 (PROJ2_KEY)
  - PROJ2_KEY-201 課題名

### Keep (よかったこと、継続すること）

- 記載する

### Problem（問題点、うまくいかなかったこと）

- 記載する

### Try (改善点、Next Action）

- 記載する

---

Important rules

• テンプレート厳守 — 上記のフォーマットに必ず従う。セクションの順序、見出し、テーブル構造を変えない
• Fact セクションは自動生成 — 各メンバーが関わった課題をプロジェクト別にリスト化
• Keep/Problem/Try はプレースホルダー — 「記載する」と表示。ユーザーが後で記入する
• 活動がゼロのメンバーも表示 — 統計テーブルに全メンバーを含め、0件でも行を表示
• 並列実行推奨 — 複数メンバーの activity 取得は並列 Bash で効率化
• プロジェクト名の解決 — issue key のプレフィックス（例: PROJ from PROJ-123）がわかる場合、lv project get PROJ -f json でプロジェクト名を取得

---

Optional: Project health integration (Phase 1)

When the report target includes a project and the user wants a broader health view:

# Get project health snapshot
lv project health PROJECT_KEY --days 7 -f json

# Get blockers
lv project blockers PROJECT_KEY --days 14 -f json

Run these in parallel with activity fetching (Step 4) to avoid extra latency.

When to include: If the user asks for a "プロジェクトレポート", "健全性チェック", or includes project health as a report target, append a "## プロジェクト健全性" section after the アクティビティ統計 section with:

## プロジェクト健全性

### 停滞課題
- 停滞課題数: N件（7日以上更新なし）
- 主な停滞課題: PROJ-XXX, PROJ-YYY

### ブロッカー
- 未アサイン高優先度課題: N件
- 期限超過課題: N件

### ユーザー負荷
| ユーザー | 担当課題数 | 期限超過 |
|---------|----------|---------|
| Name1   | X        | Y       |

Important: Only add this section when the user explicitly requests health/blockers data or asks for a project-level report. Do not add it to user activity reports.

---

Optional: Weekly/Daily digest integration (Phase 2)

When generating a project-level report and the user wants a period-based activity summary:

# Weekly digest for the report period
lv digest weekly -k PROJECT_KEY -f json

# Daily digest for a specific day
lv digest daily -k PROJECT_KEY -f json

Run these in parallel with activity fetching (Step 4).

When to include: If the user asks for "週次サマリー", "今週の進捗", or "デイリーレポート", use digest weekly/digest daily instead of (or in addition to) user activity. The periodic digest output groups issues by status transition (completed/started/blocked), making it easier to build a progress-oriented report.

Narrative summary: Pass the digest JSON to the logvalet-digest-periodic skill to generate an LLM-written narrative section.

---

Optional: Activity intelligence (Phase 3)

When generating a project report and the user wants anomaly detection or contribution bias analysis:

# Activity stats for the report period
lv activity stats --scope project -k PROJECT_KEY --since YYYY-MM-DDT00:00:00Z --until YYYY-MM-DDT23:59:59Z --top-n 10 -f json

Run in parallel with activity fetching (Step 4) to avoid extra latency.

When to include: If the user asks for "アクティビティ分析", "貢献の偏り", or "リスク評価", use activity stats to supplement the activity report. Hand the JSON to the logvalet-intelligence skill for LLM interpretation.

For integrated project risk assessment, use the logvalet-risk skill, which combines project health, project blockers, and issue stale data.

---

Anti-patterns

• レポートフォーマットを勝手にアレンジしない
• Keep/Problem/Try を AI が推測で埋めない（プレースホルダーのまま出力する）
• メンバーごとに1回ずつ質問しない — パラメータは一括で聞く
• project health セクションを全レポートに無条件で追加しない — ユーザーの要求に応じてのみ追加する