进阶 jean.build 2026-10-18 10:33:18 · 23 阅读

第12章 Magic 命令

第12章 Magic Commands

Magic Commands 使用 Jean 内置的命令来管理上下文、提交代码、审查、创建 PR、记笔记以及解决冲突。

Magic commands 是 Jean 为常见开发操作预设的快捷方式。它把提示词构建、git 操作和上下文加载打包成一整套流程,比每次手写提示词更省事、更好复用。

Magic 菜单里有什么

Jean 的 magic commands 大致分为几个类别。

上下文管理

- Save Context:保存当前摘要快照,供后续使用 - Load Context:把已保存的摘要加载回当前会话 - Linked Projects:在相关仓库之间共享上下文(见 Project linking) - Create Recap:生成当前会话的摘要

提交与同步

- Commit - Commit & Push - Revert Commit:确认后撤销最近一次本地提交 - Pull - Push

当你希望 Jean 帮忙写提交信息、引导操作顺序,而不是手动一步步拼接时,这些命令很好用。

Pull request 相关

- Open or Create PR - Update PR:用当前提交刷新已有 PR 的标题和描述 - Review:运行 AI 代码审查,审查结果会保存下来,可在 Review 面板中随时查看 - PR Comments:加载内联审查评论,让 Jean 逐条处理 - Merge

Jean 可以生成 PR 内容、审查 diff,并帮你处理已有 PR 上的内联审查评论。

Open or Create PR 和 Update PR 都使用 Generate PR Content 提示词,所以你只需调整一次语气、结构和必填字段,就能在所有地方复用。参见 Magic prompts。

调查与发布

- Investigate Issues - Investigate Pull Requests - Generate Release Notes

这些流程的价值在于,Jean 会在模型开始推理之前,就先加载并整理好相关的上下文。Generate Release Notes 会对比选定的 GitHub release,检查匹配的已合并 PR,并把检测到的关联 issue 引用一并写入生成的发布说明。

分支操作

- Merge - Resolve Conflicts

当你希望 Jean 全程跟进操作,直到仓库恢复到正常状态时,冲突处理流程尤其有用。

它们和普通提示词的区别

Magic commands 自带以下默认配置:

- 提示词模板 - 模型选择 - provider 选择 - backend 选择 - 推理力度

你可以在 Magic prompts 面板中覆盖这些默认值——也就是说,流程保持不变,背后的引擎随你更换。

打开 Magic 菜单

- macOS 上按 Cmd+M,其他平台按 Ctrl+M,可在任意聊天中打开菜单 - 菜单打开后,每个条目都有单字母快捷键(例如按 K 打开 Linked Projects)

什么时候适合用 magic commands

以下情况建议使用 magic command:

- 任务常见且可重复 - 你希望 Jean 先拉取结构化上下文 - 输出格式有要求 - 你想在多个仓库中保持一致的流程

以下情况建议直接发普通聊天消息:

- 任务比较少见 - 你还在探索问题本身 - 你想在选定流程前先自由聊聊

延伸阅读

- GitHub, Linear, and reviews - Project canvas and chat - Preferences and customization

Browser Context Grab 从 Jean 内置浏览器中,把带有来源信息的 DOM 上下文直接发送到聊天。

GitHub、Linear 和 Reviews 从 issue、PR、workflow、安全警报、advisory 和 Linear 工单开始工作。

评论 (0)