diff --git a/redmine/skills/search/SKILL.md b/redmine/skills/search/SKILL.md index 1f3c1ae..a330445 100644 --- a/redmine/skills/search/SKILL.md +++ b/redmine/skills/search/SKILL.md @@ -24,7 +24,7 @@ redmine-cli を使って、チケットの検索・閲覧を対話的に支援 ## 大前提 -- **読み取り専用**: チケットの作成・更新・削除はこのスキルではできない。ユーザーがこれらを求めた場合は、Redmine の Web UI で操作するよう案内する +- **検索・閲覧専用**: チケットの作成は `redmine:create` スキル、関連付けは `redmine:relation` スキルで対応する。ユーザーがこれらを求めた場合は該当スキルへ案内する - **Redmine 5.1.0 以上**が必要(キーワード検索の `any_searchable` フィルタを使用) - 1リクエストあたり最大 100 件の取得制限がある(`--limit 100`) - チケット情報は参考であり、最新の状態は Redmine 本体で確認するよう補足する @@ -186,11 +186,16 @@ redmine-cli search --profile

--keyword "..." --project --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件を表示)。絞り込み条件を追加すると、目的のチケットに早く到達できます」と提案する