进阶 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 的行为。