Support activation welcome cards for custom Copilot CLI agents
まだ誰も着手していません。
- 主要言語
- Shell
- スター
- 11.2k
- フォーク
- 1.9k
- 平均マージ
- 14時間 16分
- マージ済み PR(30日)
- 6
説明
Describe the feature or problem you'd like to solve
Problem Custom Copilot CLI agents are selected with /agent <agent-name>, but selection only changes the active profile. The CLI does not show an immediate, agent-defined welcome or onboarding message. This creates a discoverability problem for specialized workflow agents. A new user can successfully select an agent but still not know what it is for, which goals it supports, or how to begin. The user must already know an appropriate first prompt before the agent can help.
Proposed solution
Add a first-class optional welcome declaration to custom-agent metadata and
render it directly in the Copilot CLI UI after a user successfully selects an
agent with /agent.
Illustrative agent profile:
name: analysis-agent
description: "Helps investigate reports, inputs, and execution results."
welcome:
title: "Welcome"
message: >
This agent can help investigate existing results, analyse supplied inputs,
and prepare focused follow-up work.
suggestedPrompts:
- "Investigate an existing report or execution result"
- "Analyse a supplied input"
- "Help me understand an existing failure"
CLI behavior:
- The user selects a custom agent with
/agent <agent-id>. - Once selection succeeds, the CLI reads the selected agent's optional
welcomemetadata. - If present, the CLI renders a lightweight terminal welcome card immediately.
- The card displays the title, message, and optional suggested prompts.
- Selecting a suggested prompt deliberately submits that text as a normal user
prompt. The user may instead dismiss the card and enter any free-form prompt. - The welcome card is UI-only:
- it does not invoke the model;
- it does not consume AI credits;
- it does not create synthetic user or assistant messages;
- it does not alter conversation history.
- Agents without
welcomemetadata retain today's behavior unchanged.
Suggested terminal rendering:
┌ Welcome ───────────────────────────────────────────────┐
│ This agent can help investigate existing results, │
│ analyse supplied inputs, and prepare focused work. │
│ │
│ What would you like to do? │
│ │
│ 1. Investigate an existing report or execution result │
│ 2. Analyse a supplied input │
│ 3. Help me understand an existing failure │
│ │
│ Press a number, or Esc to enter your own prompt. │
└────────────────────────────────────────────────────────┘
Example prompts or workflows
Consider two custom agents supplied by a plugin:
- An analysis-oriented agent for investigating existing artifacts, reports,
execution results, and input data. - A developer-oriented agent that includes those capabilities plus source editing,
validation, review, and delivery workflows.
After selecting the analysis agent with /agent, the CLI could immediately show:
Welcome
This agent can help investigate existing results, analyse supplied inputs, and
prepare focused follow-up work.
What would you like to do?
- Investigate an existing report or execution result
- Analyse an input or dataset
- Prepare focused follow-up work
- Understand an existing failure
The developer-oriented agent could show the same concise user goals with one short
additional note that it also supports implementation, validation, and delivery.
Requested behavior
Please add an optional custom-agent activation/welcome contract that the CLI renders
immediately after a successful interactive /agent selection.
Suggested shape (illustrative only):
welcome:
title: "Welcome"
message: "This agent can help with..."
suggestedPrompts:
- "Investigate an existing report"
- "Analyse a supplied input"
Additional context
No response
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
まず、Copilot CLI における custom-agent メタデータのパース処理と、インタラクティブな /agent 選択フローの場所を特定します。選択によってアクティブなプロファイルがどのように更新されるかを追跡し、その後、UI 専用のウェルカムカードと提案プロンプトの送信をどこに組み込めるかを判断します。完了条件は、選択が成功した後にウェルカムメタデータが表示され、それを持たないエージェントの履歴や動作が変更されないことです。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- shell
- 領域
- cli
- issue の種類
- 機能追加
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 活発さ
- 活発
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 45/100