使用 GitHub Copilot CLI 会话数据

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 直接跳转到指定会话。

恢复会话时，Copilot 会加载完整的对话历史，让您准确从离开的地方继续。

重命名会话

当您使用 --resume 命令行选项或 /resume 斜杠命令时，会列出近期会话。列表的最后一列显示会话名称，帮助您识别要恢复的会话。如果您经常返回某个会话，建议为其设置自定义名称，以便在列表中更易找到。

重命名会话

1. 在交互式会话中，如果想重命名非当前会话，请使用 /resume 斜杠命令切换到要重命名的会话。

2. 输入 /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 提自由形式的问题，/chronicle 子命令提供一种快速获取特定洞察的方式。

当您输入 /chronicle 且不带参数时，会显示一个选择器，让您从可用子命令中挑选。

您也可以直接调用子命令，而不使用选择器，例如 /chronicle standup。

/chronicle standup

这会根据您的 Copilot CLI 会话生成简短报告，默认范围为最近 24 小时。Copilot 会查看您工作过的分支、完成的任务以及引用的 GitHub Pull Request 或 Issue。输出按完成状态分组，每项标注其所在分支，并检查任何关联 Pull Request 的当前状态。

示例站会摘要

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 CLI 的使用情况。随后提供 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 会寻找摩擦信号——重复的测试失败、多次尝试才成功的构建错误、用户纠正或重定向代理的消息，以及跨会话反复出现的模式。随后给出 3–5 条具体建议，每条解释发现的问题以及对应的指令。

例如，Copilot 可能发现它反复尝试在使用 vitest 的项目中使用 jest，或持续生成与代码库约定不符的导入语句。建议的指令将防止这些错误在后续会话中出现。

在展示建议后，Copilot 会询问您想应用哪些。默认全部选中，您可以使用键盘方向键移动到任意建议，然后按空格键取消勾选。选择完毕后，按 Enter。Copilot 随后会创建或更新 .github/copilot-instructions.md 文件。

就会话历史提问

您无需使用斜杠命令即可利用会话历史。若 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 通过对会话历史进行全文搜索找到相关会话，然后概括您所做的工作。

延伸阅读

• 关于 GitHub Copilot CLI 会话数据
• GitHub Copilot CLI 命令参考