/prompt
使用 /prompt 可以查看、预览并调整下一次新会话的提示词组装结果。
这是 Hunea 的核心功能之一,目前已经可以正常使用,后续还会继续打磨完善。
当你需要确认系统提示由哪些来源拼接而成、临时开关某段指令/技能/工具指南、新增自定义提示词,或者想先预览最终完整的系统提示词再修改,都可以打开它。输入 /prompt 确认后,会打开一个全屏面板,标题是 Prompt Assembly。
菜单描述是 Inspect prompt assembly for the next new session(检查下一次新会话的提示词组装)。多数改动不会回写当前会话已经开始过的
transcript(会话记录);它们面向“下一次新会话”。若当前会话还是空会话,关闭并落盘后也可能直接作用于当前空会话(见下方「关闭之后会发生什么」)。
面板概览
/prompt 是左右分栏的管理器,不是单列表:
- 标题行:左侧是
Prompt Assembly(提示词组装),右侧是四个候选页签 - 左栏
Active(已装配):已经进入“下一次新会话装配结果”的来源列表 - 右栏(候选 / 库存):还没全部进入装配,或可切换启停的候选集合
- 底部分页线:显示当前焦点侧的位置,例如
Active (2 of 8)(已装配,第 2 条 / 共 8 条) - 底部操作提示:会随当前选中项变化;最右侧常有
? more(更多)
大致效果如下图所示:

左栏:Active(已装配)
表头列如下:
Sel · Ord · Source · Type · Scope
Type(类型)对应关系如下:
当前焦点行左侧会有色块标记。若某条下面还“盖住”了同名/同键其他来源,可能显示 +N shadowed(另有 N 条被遮蔽);按 Ctrl + E 可展开/收起这些被遮蔽明细。
右栏:四个页签
右上角页签(默认先落在 Skill(技能)):
不同页签的表头会略有不同,例如:
Skill(技能):Sel(选择)·Ord(顺序)·Name(名称)·Scope(作用域)Tools(工具):On·Guide·Ord(顺序)·Name(名称)·Scope(作用域)(On/Guide 为双列开关,见下)Custom Prompts(自定义提示词):Sel(选择)·Name(名称)·Scope(作用域)Dynamic(动态):Base(基线)·Change(变化)·Source(来源)·Scope(作用域)
Tools(工具)页签:On / Guide 双列
Tools(工具)页签每行有两个复选框列,可分别控制:
操作方式:← / → 在 On / Guide 两列之间切换(当前列高亮),x 切换当前列的开关。需注意:当某工具的 On 关闭时,它的 Guide 列变为不可操作(弱化显示),此时 x 为无操作;本身没有 guidelines 的工具,Guide 列同样无操作。禁用的工具会从模型请求与会话工具注册表中一起过滤,并持久化(tool_enablement)。详见工具级启用/禁用。
大致效果如下图所示:

怎么操作
焦点与导航
←/→,或者h/l:在左右栏之间切换焦点
(在Dynamic(动态)页签上,左右也可能用于在Base(基线)/Change(变化)列之间移动)↑/↓,或者j/k:上下移动选中项PageUp/PageDown:按页翻动Home/End:跳到当前列表首尾Tab/Shift + Tab:焦点在右栏时,循环切换右上角页签?:打开/关闭更多快捷键说明(More(更多)浮层)Esc:关闭/prompt面板(会触发后续提交/落盘流程,见后文)
也可以用鼠标:
- 点右上角页签:切到对应候选页
- 点左右列表行:切换焦点并选中该行
预览
Space:预览当前选中项的正文(单条source(来源)/skill(技能)/tool(工具)/dynamic(动态)等)p:预览整段已装配的system prompt(系统提示词)(标题类似Assembled prompt(已装配提示词))
在预览界面里:
Esc/Space/p:退回主面板↑/↓/←/→,以及h/j/k/l:翻页查看更长内容
大致效果如下图所示:


编辑、启停、排序
底部提示会随选中项变化,常用动作:
不是每一行都支持全部动作。例如:
- 核心
system(系统)、指令文件、生成型discovery(发现)/tools(工具)/ 某些dynamic(动态)来源,通常不能像自定义prompt(提示词)那样直接d删掉 - 只有可编辑来源才会出现
e - 只有
Active(已装配)侧、且允许重排时,才会看到J/K reorder(重排)
新建自定义 prompt(提示词)
在右栏 Custom Prompts(自定义提示词)相关上下文里按 a:
- 先弹出作用域选择:
[Project] Global(当前为项目,可选全局)或Project [Global](当前为全局,可选项目) ←/→(或h/l)切换作用域Enter确认,Esc取消- 确认后会进入外部编辑器写正文;保存退出后写回对应
scope(作用域)
大致效果如下图所示:

这些来源分别是什么
可以把左栏理解成“下一轮新会话会带上的 system(系统)拼装清单”,常见来源包括:
-
Core system prompt(核心系统提示词)
Hunea 内置的核心行为说明。可用global(全局)/project(项目)的override(覆盖)改写;选中后可用r尝试恢复默认核心提示词,用于在修改混乱后一键复原。 -
Instructions(指令)文件- 全局:数据目录下的
AGENTS.md(一般是~/.config/hunea/AGENTS.md) - 项目:工作区/仓库向上查找的
AGENTS.md或CLAUDE.md(同目录时通常优先AGENTS.md)
- 全局:数据目录下的
-
Custom prompts(自定义提示词)
你自己维护的额外prompt(提示词)片段。项目级通常落在.hunea/prompts/custom/,并由.hunea/prompt-assembly.toml记录装配状态。 -
Skill discovery(技能发现)/long-lived skills(长期技能)
技能发现片段,以及可长期注入的skill(技能)。和会话里临时@skill一类“这一轮才挂上”的注入不是同一件事。 -
Tool guidelines(工具使用指南)
根据当前可用工具生成的工具使用说明。 -
Dynamic environment(动态环境)
环境信息:Base(基线):更偏首轮基线Change(变化):更偏后续轮次的变化增量
右栏Dynamic(动态)页可分别勾选。
遮蔽 shadowed是什么意思
同名或同冲突键的来源可能同时存在于 project(项目)/ global(全局)/ builtin(内置)等层级。装配时通常只会让更高优先级的那条真正生效,其余会被标成 shadowed(被遮蔽)。
优先级如下:
project(项目) > global(全局) > builtin(内置)
因此你可能在列表里看到某条 Active(已装配)项附带 +1 shadowed(另有 1 条被遮蔽),表示下面还有被盖住的同键来源。用 Ctrl + E 展开后可以核对“到底生效的是哪一层”。
关闭之后会发生什么
按 Esc 关闭 /prompt 时,Hunea 会尽量把本次面板里的工作副本提交/落盘,而不是关掉就丢弃你做的改动。
提交成功后的提示,取决于生效范围:
需要注意:
- 已经聊过内容的当前会话,一般不会因为你在
/prompt里改装配,就把历史transcript(会话记录)整段重写一遍。 - 想让多数改动完整进入下一轮对话,建议关闭
/prompt后,用/clear(别名/new)开一条新会话。 - 若打开
/prompt时根本没成功进入编辑会话(例如 begin 失败),面板可能被直接关掉且不走提交流程。
配置会落在哪里
项目级常见位置:
全局侧则与 Hunea 数据目录相关(一般是 ~/.config/hunea/),例如全局 AGENTS.md、以及全局 prompt assembly(提示词组装)状态(由 session store(会话存储)/ 数据目录管理,而不是只靠当前工作区文件)。
你不必手工先把所有文件写齐才用 /prompt:很多自定义项可以在面板里用 a / e 创建和编辑,再由 Hunea 写回。
和相邻命令的区别
/context 告诉你预算还剩多少;/prompt 告诉你这些预算里的 system(系统)侧由哪些来源拼出来、能不能改。
一点使用建议
- 只想确认“下一轮到底会带上什么”:打开后按
p看Assembled prompt(已装配提示词),通常比一条条点开更快。 - 项目有
AGENTS.md/CLAUDE.md却感觉没生效:到左栏找instructions(指令),看是missing(缺失)、被disabled(已禁用),还是被更高优先级来源shadowed(被遮蔽)。 - 想给当前仓库单独加一段长期说明:右栏切到
Custom Prompts(自定义提示词),a选Project(项目),写完后确认它出现在左栏Active(已装配)列表里。 - 改完顺序或开关后,先
p预览,再Esc关闭落盘;需要立刻在干净上下文里验证时,再/clear开新会话。 - 快捷键记不全时,按
?看More(更多),不用去猜页脚那些缩写。