第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 工单开始工作。