Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions redmine/skills/search/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ redmine-cli を使って、チケットの検索・閲覧を対話的に支援

## 大前提

- **読み取り専用**: チケットの作成・更新・削除はこのスキルではできない。ユーザーがこれらを求めた場合は、Redmine の Web UI で操作するよう案内する
- **検索・閲覧専用**: チケットの作成は `redmine:create` スキル、関連付けは `redmine:relation` スキルで対応する。ユーザーがこれらを求めた場合は該当スキルへ案内する
- **Redmine 5.1.0 以上**が必要(キーワード検索の `any_searchable` フィルタを使用)
- 1リクエストあたり最大 100 件の取得制限がある(`--limit 100`)
- チケット情報は参考であり、最新の状態は Redmine 本体で確認するよう補足する
Expand Down Expand Up @@ -186,11 +186,16 @@ redmine-cli search --profile <p> --keyword "..." --project <proj> --status open
- **プロジェクトの全体像**: プロジェクトのバージョンやカテゴリを確認
- **別のキーワードで探す**: 新しいキーワードで検索し直す
- **プロファイルを切り替える**: 別の Redmine サーバーで検索
- **新規チケットを作成する**: `redmine:create` スキルへ案内
- **チケットを関連付ける**: `redmine:relation` スキルへ案内

## エラーハンドリング

- **CLI 未インストール**: `which redmine-cli` で検出。OS に応じたインストール方法を案内
- **プロファイル未設定**: `redmine-cli config list` で空を検出。インラインで config add フローを実行し、設定完了後に元のフローに継続
- **認証エラー・接続エラー**: 「Redmine への接続でエラーが発生しました。以下を確認してください: (1) プロファイルの URL が正しいか (2) API キーが有効か (3) Redmine サーバーが稼働しているか。`redmine-cli config list` でプロファイル設定を確認できます」と案内する
- **検索結果 0 件**: 「該当するチケットが見つかりませんでした。キーワードを変えるか、検索条件を緩めてみてください」と提案する
- **検索結果 0 件**: 「該当するチケットが見つかりませんでした」と伝え、以下の選択肢を提示する:
- キーワードを変えて再検索する
- 検索条件を緩めて再検索する
- **この内容で新規チケットを作成する** → `redmine:create` スキルへ案内
- **100件超のヒット**: 「検索結果が多数あります(全N件中100件を表示)。絞り込み条件を追加すると、目的のチケットに早く到達できます」と提案する
Loading