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

第15章 Magic Prompts 自定义工作流提示词

魔法提示词(Magic Prompts)

自定义 Jean 中每个内置工作流的提示词模板、模型和推理方式。

Jean 中每条魔法命令背后都运行着一个提示词模板。Magic Prompts 面板让你替换这些模板、为每个工作流选择不同的模型或后端,其余流程保持不变。

可自定义的内容

每个内置工作流都暴露了:

  • 提示词模板
  • 后端覆盖
  • 模型覆盖
  • 提供商覆盖(针对 Claude CLI)
  • 推理或思考等级覆盖

也就是说,你可以在保持界面和命令流程不变的前提下,替换任意单个工作流背后的引擎。

可编辑的提示词

该面板覆盖了全部内置工作流:

调查类

  • 调查 Issue
  • 调查 Pull Request
  • 调查 Workflow Run
  • 调查安全告警
  • 调查安全公告
  • 调查 Linear Issue
  • 处理 Review 评论

Git 与 PR 操作

  • 生成 PR 内容
  • 生成 Commit 信息
  • 代码审查
  • 解决冲突
  • 生成 Release Notes

会话管理

  • 会话命名
  • 会话回顾
  • 上下文摘要

系统提示词

  • 全局系统提示词(追加到每个会话)
  • 并行执行提示词

全局系统提示词

全局系统提示词会追加到 Jean 启动的每个会话中。

适合用来写:

  • 团队风格规范
  • 必用的工具或命令
  • 文档要求
  • 仓库级约定

务必保持简短。它会被加在每个后端默认系统提示词之上,冗长的内容会在每次请求中都浪费 token。

按工作流选择模型

一个常见做法是按工作流混用模型,例如:

  • 会话命名和 commit 信息用轻量模型
  • 代码审查和 PR 调查用更强的模型
  • 冲突解决用推理能力强的模型

每个工作流都有后端和模型下拉框,无需改动全局默认值即可轻松设置。

什么时候该改提示词

遇到以下情况可以编辑提示词:

  • 默认输出不符合团队的语气
  • 希望 PR 标题或 commit 信息有更严格的格式
  • 某个工作流需要额外的护栏(安全、许可、隐私)
  • 希望现有工作流在回答前加载额外的上下文

如果默认输出已经接近预期,就不要改。内置模板是针对当前后端调优过的。

Release Notes 变量

Generate Release Notes 提示词可以使用以下变量:

  • {tag} 和 {previous_release_name}:所选的上一个版本
  • {commits}:该版本以来的 commit 历史
  • {pull_requests}:匹配到的已合并 PR、检测到的关联 issue 以及匹配的 commit
  • {related_pull_requests}:从 GitHub 关闭关键字中识别出的精确 PR/issue 引用格式

Jean 会检查 PR 标题、PR 描述和 PR commit 信息中的 GitHub 关闭关键字(如 fixes #123),然后规范化输出中的引用(如 (#456, fixes #123))。

恢复默认

所有自定义字段都可以重置为 Jean 的默认值。

如果修改后某个提示词行为异常,恢复默认是确认问题是否出在模板上的最快方式。

延伸阅读

  • 魔法命令
  • 后端、模型与 MCP
  • 设置与自定义

设置与自定义(Settings and Customization)

调整 Jean 在后端、提示词、外观、快捷键、集成和实验性功能方面的默认配置。

有主见的插件(Opinionated Plugins)

一键安装精选工具,降低 token 消耗,重塑各后端下 agent 的行为。

评论 (0)