Copilot 命令行界面(CLI) 将您的 CLI 会话数据存储在本地机器上。 此会话数据允许你:
- 继续以前的会话,然后从你离开的位置开始。
-
`/chronicle`使用斜杠命令生成站立报告、获取个性化提示,并接收改进`.github/copilot-instructions.md`文件的建议。 - 向 Copilot 提问关于您过去交互的问题。
本文介绍如何使用这些功能。 若要深入了解会话数据的存储方式以及命令的优点 /chronicle ,请参阅 关于 GitHub Copilot 命令行界面 (CLI) 会话数据。
恢复之前的会话
可以从命令行或活动会话期间恢复以前的交互式 CLI 会话。
-
**在命令行中**,运行 `copilot --continue` 以恢复最近的会话。 如果要从最近会话的列表中进行选择,请运行 `copilot --resume` 以打开列出最近会话的会话选取器。 或者,如果知道要恢复的会话的会话 ID,则可以运行 `copilot --resume SESSION-ID` 以直接跳转到该会话中。 -
**在交互式会话期间**,键入 `/resume` 切换到其他会话。 将显示一个选择器,其中列出了您的近期会话。 或者,可以输入 `/resume SESSION-ID` 以直接跳入特定会话。
注意
可以使用斜杠命令查找当前交互式会话 /session 的 ID。 退出交互式会话时也会显示会话 ID。
恢复会话时,Copilot 会加载完整的会话历史记录,让您可以从上次中断的地方继续。
重命名会话
使用 --resume 命令行选项或 /resume 斜杠命令时,将列出最近的会话。 列表的最后一列显示会话名称,这有助于确定要恢复的会话。 如果你有一个经常返回的会话,你可能希望为其指定一个自定义名称,以便更轻松地在列表中查找。
若要重述会话,需要:
-
在交互式会话中,如果要重命名当前会话以外的会话,请使用
/resume斜杠命令切换到要重命名的会话。 -
键入
/rename NEW_NAME以重命名当前会话。 无需将名称括在引号中。例如,
/rename Improve test coverage。
共享会话
可以将当前会话的内容保存为 Markdown 文件或 GitHub.com上的专用 gist。 这样,您就可以与他人共享您的提示和 Copilot的响应,或者将您的工作记录存储在 CLI(命令行界面)之外。
若要将会话共享为 gist,请在交互式会话中键入以下内容:
/share gist
/share gist
若要将会话会话导出为 Markdown 文件,请键入:
/share file [PATH-TO-FILE]
/share file [PATH-TO-FILE]
如果未指定文件路径,则 Markdown 文件将保存在具有名称 copilot-session-SESSIONID.md的当前工作目录中。
使用/chronicle斜杠命令
注意
命令 /chronicle 和 Copilot 回答有关会话历史记录问题的能力目前是实验性功能,只有在您已使用 /experimental on 斜杠命令或 --experimental 命令行选项时才可用。
`/chronicle`斜杠命令提供一组子命令,用于从会话历史记录生成特定类型的见解。 你可以随时询问 Copilot 自由形式的问题,但`/chronicle` 子命令可以快速提供特定见解。
在没有参数的情况下键入 /chronicle 时,将显示一个选取器,用于从可用的子命令中进行选择:
| 子命令 | 说明 |
|---|---|
standup | 从最近的工作中生成一个站立报告。 |
tips | 根据使用模式获取个性化提示。 |
improve | 建议对 Copilot 自定义说明文件进行改进。 |
reindex | 从会话历史记录重新生成会话存储索引。 |
还可以直接调用子命令,而无需使用选取器,例如 /chronicle standup。
/chronicle standup
这将根据您的 Copilot 命令行界面(CLI) 会话生成一份短报表,默认会显示过去 24 小时的内容。 Copilot 查看您工作过的分支、完成的工作以及引用的任何 GitHub 拉取请求或问题。 它按完成状态对输出进行分组,每个项目都按其分支标记,并检查任何链接拉取请求的当前状态。
示例醒目摘要
Standup for March 13 2026:
✅ Done
myapp-repo repo maintenance (main branch)
- Synced local, cleaned files, audited deps, reviewed architecture
- Session: 69a027e4-9b7b-493e-922e-107acd25abab
🚧 In Progress
MyApp configuration (suppress-start-message branch, myapp-repo)
- Suppressing startup init prompt message
- Session: 3034d813-3e1f-413a-b3d9-15427ef8c19c
可以将其他上下文追加到命令以自定义输出。 例如,你可以告诉 Copilot 使用不同的时间段,而非默认的最近 24 小时:
/chronicle standup for the last 3 days
/chronicle standup for the last 3 days
/chronicle tips
该分析您的最近会话,以了解您的工作方式以及您如何使用数据变量.copilot.copilot_cli_short %}。 然后,它提供 3-5 个个性化建议。 Copilot 审查您的具体提示、使用的工具以及尚未尝试的功能。 它将完整的可用 CLI 功能集(包括你在存储库中设置的任何自定义代理和技能)进行交叉引用,以查找你可能错过的机会。
提示以实际使用情况数据为基础,提供特定建议,而不是一般建议。
示例提示
响应 /chronicle tips 中主要要点的示例如下。 在实际响应中,将更详细地解释每个点。
1. Use @ to mention files instead of pasting content
2. Iterate within a session — don't start over
3. Try /research for your exploration work
4. Turn recurring prompts into a custom agent
5. Use plan mode for multi-step work
可以通过在后面 /chronicle tips追加上下文,将提示集中在特定区域上。 例如:
/chronicle tips for better prompting
/chronicle tips for better prompting
/chronicle improve
深入分析您的对话历史,查找 Copilot 在提供您期望的响应或结果时遇到困难的地方,或者您必须通过跟进提示来调整方向的情况。 根据这项研究,建议对您的自定义说明文件进行.github/copilot-instructions.md改进。
将项目特定的知识获取为自定义说明是一种有效的方法,可以提高在处理项目时Copilot的性能。 有关详细信息,请参阅“为GitHub Copilot 命令行界面 (CLI)添加自定义指令”。
注意
与其他时间不同,Copilot 使用会话数据回答问题或生成见解,而子命令improve的范围仅限于当前存储库或工作目录中的数据。 这可确保建议与当前正在处理的项目相关。
Copilot 查找摩擦信号——包括重复的测试失败、需要多次尝试的构建错误、用于更正或重定向代理的用户消息以及跨会话重复出现的模式。 然后,它提出了 3-5 个具体建议,每个建议都解释了它发现的问题,以及将解决该问题的说明。
例如,Copilot 可能会发现它反复尝试在你的使用 vitest 的项目中使用 jest,或者它一直生成的引入与代码库的约定风格不匹配。 建议的说明将在未来的会话中防止这些错误。
提交建议后,Copilot 会询问你想要应用哪些建议。 默认情况下,会选择所有建议,但你可以使用键盘上的箭头键移动到任意建议,然后按空格键来切换该建议的启用状态。 选择要应用的建议后,按 Enter。 Copilot 然后创建或更新 .github/copilot-instructions.md 文件。
提问有关会话历史记录的问题
无需使用斜杠命令来利用会话历史记录。 如果 Copilot 确定你询问你使用 CLI 的情况,它将自动使用会话存储来提供响应的上下文。
注意
默认情况下,与 Copilot 命令行界面(CLI) 交互的答案基于所有录制的会话,无论您当前正在使用的存储库或分支如何。
下面是你可能提出的问题类型的一些示例:
有关任务的见解
Using what you know about my sessions, what type of tasks give me one-shot successes and which do I have to iterate on most?
Using what you know about my sessions, what type of tasks give me one-shot successes and which do I have to iterate on most?
Copilot 将分析你的对话内容,查找初始响应后未有相关提示跟随的情况,以及出现一系列迭代提示和响应的情况。
减少高级优先请求的使用
Based on my previous CLI sessions, how could I prompt you in a way that would cost less?
Based on my previous CLI sessions, how could I prompt you in a way that would cost less?
Copilot 将分析您的会话模式,包括提示词长度、延续步骤数量和工具调用频次,并建议如何通过更少的交互实现相同的效果。
找到你最为高效的时间
Look at data for previous sessions. What time of day am I most and least effective at getting good results from Copilot?
Look at data for previous sessions. What time of day am I most and least effective at getting good results from Copilot?
Copilot 将查询会话时间戳和结果信息,以识别您的交互什么时候最为高效。
回顾过去的工作
Have I worked on anything related to authentication in the last month?
Have I worked on anything related to authentication in the last month?
Copilot 使用会话历史记录中的全文搜索来查找相关会话,然后汇总了所执行的操作。
延伸阅读
-
[AUTOTITLE](/copilot/concepts/agents/copilot-cli/chronicle) -
[AUTOTITLE](/copilot/reference/cli-command-reference)