> For the complete documentation index, see [llms.txt](https://docs.wicle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wicle.io/action/issue.md).

# イシュー

Wicle AIが自動検出する課題とアクション管理

## イシューとは <a href="#what-is-issue" id="what-is-issue"></a>

Wicle AIが検出した課題と対応候補を確認し、取り組む施策や調査を選べます。施策の日程や実施内容を記録したい場合は、同じ画面の`アクションカレンダー`を使います。

{% hint style="warning" %}
利用には、Growthプラン以上またはAI Analyticsオプションの契約と、Wicle AIの有効化が必要です。FreeプランでもAI Analyticsオプションを契約していれば利用できます。詳しくは[AI機能の利用条件](https://docs.wicle.io/billing/plan-comparison.md#ai-limits)と[Wicle AIの有効化](https://docs.wicle.io/ai/policy.md#enable-ai)をご覧ください。
{% endhint %}

左メニューの`イシュー`を開き、画面上部で`イシュー`または`アクションカレンダー`を選択します。

## イシュータブ <a href="#issue-tab" id="issue-tab"></a>

AIが検出した課題ごとに、対応する施策や調査の候補を確認できます。

### 一覧の見方 <a href="#issue-list" id="issue-list"></a>

課題グループのヘッダーをクリックすると、アクション候補を表示・折りたたみできます。候補をクリックすると、根拠や実行手順を確認できます。

課題グループには、次の情報が表示されます。

| 項目   | 説明                |
| ---- | ----------------- |
| タイトル | 課題の要約             |
| 影響指標 | 影響を受けている指標（バッジ表示） |
| 重要度  | 高 / 中 / 低         |

アクション候補には、次の情報が表示されます。

| 項目             | 説明                                                     |
| -------------- | ------------------------------------------------------ |
| ステータス          | Active（未対応も含む対応対象）/ Stale（一定期間操作がない候補）/ Resolved（対応済み） |
| タイプ            | 施策 / 調査                                                |
| タイトル           | アクションの概要                                               |
| Priority Score | 優先度スコア（1〜100）                                          |
| カテゴリ           | 流入 / CV / ページ                                          |
| 最終操作日          | 最後にステータスを変更した日付。未操作の場合は作成日                             |

### フィルター <a href="#filter" id="filter"></a>

| フィルター | 選択肢                       |
| ----- | ------------------------- |
| ステータス | Active / Stale / Resolved |
| タイプ   | 全タイプ / 施策 / 調査            |
| カテゴリ  | 流入 / CV / ページ（複数選択可）      |

初期表示は`Active`です。`Stale`や`Resolved`も確認する場合は、ステータスの選択を追加します。

### 詳細パネル <a href="#detail-panel" id="detail-panel"></a>

アクション候補をクリックすると、右側から詳細パネルが表示されます。

#### Priority Score <a href="#priority-score" id="priority-score"></a>

優先度を1〜100のスコアで表示します。数値が高い候補から、対応を検討する目安にします。詳細パネルの`Priority`をクリックすると、次の3軸の内訳と評価理由を確認できます。

| 軸            | 説明                 |
| ------------ | ------------------ |
| Impact（影響度）  | 主要KPIへの影響の大きさ（1〜5） |
| Urgency（緊急度） | 対応の緊急性（1〜5）        |
| Ease（実行容易性）  | 実行のしやすさ（1〜5、AI推定値） |

#### 根拠 <a href="#evidence" id="evidence"></a>

* **推奨理由**: このアクションを推奨する背景
* **期待効果**: 対応した場合に見込まれる指標の変化と確信度（高/中/低）
* **放置リスク**: 対応しなかった場合のリスクと確信度

#### 実行ステップ <a href="#steps" id="steps"></a>

課題に対する具体的な対応手順が順序付きリストで表示されます。

#### エージェント実行プロンプト <a href="#coding-agent-prompt" id="coding-agent-prompt"></a>

コーディングエージェント（Claude Code等）に渡す指示文が表示される場合があります。内容を確認し、`コピー`でコピーして使用します。

#### 参考記事 <a href="#sources" id="sources"></a>

関連する外部記事へのリンクが表示されます。

### ステータスを変更する <a href="#change-status" id="change-status"></a>

* 対応を終えた候補は、詳細パネル上部の`対応済みにする`で`Resolved`にします。
* `Resolved`または`Stale`の候補は、`再オープン`で`Active`に戻せます。

### 深掘り分析する <a href="#deep-analysis" id="deep-analysis"></a>

詳細パネルの `深掘り分析する` をクリックすると、チャットエージェントに遷移します。該当イシューの文脈を引き継いで、より詳細な分析を行えます。

詳しくは[チャットエージェント](https://docs.wicle.io/ai/agent.md)をご覧ください。

## アクションカレンダータブ <a href="#action-calendar-tab" id="action-calendar-tab"></a>

施策やタスクの予定、実施した内容を日付とともに記録できます。ここでのアクション作成はカレンダーへの記録であり、Webサイトの変更や施策の実行は別途行います。

### カレンダーの見方 <a href="#calendar-view" id="calendar-view"></a>

月ごとにアクションが表示されます。左右の矢印で月を切り替え、`今月`で現在の月に戻れます。複数日にまたがるアクションは横棒で表示されます。

左側には、週次のAIレポートがある場合にカテゴリ別のトレンドが表示されます。施策の日程とデータの変化を照らし合わせる際に使います。

### アクションを作成する <a href="#create-action" id="create-action"></a>

#### 手動で作成する <a href="#manual-create" id="manual-create"></a>

1. `アクションカレンダー`タブで`アクション追加`をクリックします。
2. タイトル、開始日、終了日を入力します。終了日は開始日以降にします。
3. 必要に応じてラベルや説明を追加し、下書きにする場合は`下書き`をオンにします。
4. 入力したアクションの`作成`をクリックします。
5. 作成画面を閉じ、カレンダーにアクションが表示されたことを確認します。フィルターで非表示になっている場合は、ステータスやラベルの選択を見直します。

| 項目   | 必須  | 説明                                  |
| ---- | --- | ----------------------------------- |
| タイトル | はい  | 最大200文字                             |
| 開始日  | はい  | アクションの開始日                           |
| 終了日  | はい  | アクションの終了日                           |
| ラベル  | いいえ | 最大3つまで選択可能                          |
| 説明   | いいえ | マークダウン形式で記述可能（最大10,000文字）           |
| 下書き  | いいえ | オンの場合は下書き、オフの場合はカレンダー上の公開アクションとして保存 |

#### 自然文入力で作成する <a href="#natural-language-create" id="natural-language-create"></a>

1. `アクションカレンダー`タブで`自然文入力`をクリックします。
2. 日付とアクションの内容が分かるテキストを入力します（最大5,000文字）。他のツールで管理している予定をコピーして貼り付けることもできます。
3. `AIで抽出`をクリックします。この時点では、抽出結果はまだ保存されていません。
4. 各アクションのタイトル・日程・ラベル・説明・下書きの状態を確認し、必要に応じて修正します。
5. 個別に保存する場合は各アクションの`作成`、まとめて保存する場合は`すべて作成`をクリックします。
6. 入力画面を閉じ、カレンダーに作成したアクションが表示されたことを確認します。

### アクションを編集・削除する <a href="#edit-action" id="edit-action"></a>

カレンダー上のアクションをクリックして詳細を開きます。右上の編集アイコンからタイトル・日程・ラベル・説明・下書きの状態を変更し、`保存`をクリックします。

削除する場合は、詳細画面の右上の削除アイコンをクリックし、確認画面で削除を確定します。

### フィルター <a href="#calendar-filter" id="calendar-filter"></a>

| フィルター | 選択肢                                         |
| ----- | ------------------------------------------- |
| ステータス | すべて / 下書き / 公開                              |
| ラベル   | 登録済みのラベルから選択。複数選択した場合は、いずれかのラベルが付いたアクションを表示 |

### ラベルを管理する <a href="#label-management" id="label-management"></a>

ラベルフィルターの`管理`から、ラベルの作成・編集・削除ができます。新しいラベルは、名前と色を指定して`追加`をクリックします。

| 項目  | 説明       |
| --- | -------- |
| 名前  | 最大30文字   |
| カラー | 色の一覧から選択 |

{% hint style="info" %}
デフォルトラベルは削除・名前変更ができません。色のみ変更できます。
{% endhint %}

作成したラベルを削除すると、付与済みのアクションからもそのラベルが外れます。アクション自体は削除されません。
