handoff 新增必填 title 参数:交接时刻的标题回写会话标题

顾问在 handoff 此刻最懂这单任务,其起的标题比首交互后自动生成(maybeGenerateTitle)
的更有价值。落地:
- definitions.json:handoff 参数加 title(必填),描述对齐 title-prompt 口径
  (3-7 词/中文 6-14 字,无引号无前缀);工具字母序复查未破坏;
- executor.toolHandoff:清洗(压空白+截 60,同 cleanTitle 口径;executor 反引用
  engine 会成环故就地实现),task.md 落盘成功后才 UPDATE sessions.title
  (切换半途失败不留「有名无书」残局);空 title 拒回执;
- engine 批尾 handoffDone:enterExecuting 前广播 title 事件,已开窗口刷详情页
  标题+重拉列表(与自动生成同链路);finalize 的 maybeGenerateTitle 见非空即跳过,
  getSession 现读 DB 无覆盖竞态;
- advising-system.txt:handoff 调用说明同步带 title(提示词与必填参数对齐)。

存量被画像污染的旧标题可被下次 handoff 直接顶掉。
This commit is contained in:
2026-09-26 07:04:06 +08:00
parent 5535d4cd0d
commit 0dca2ab7f5
4 changed files with 25 additions and 4 deletions
+7 -1
View File
@@ -820,7 +820,13 @@ async function runLoopInner(sessionId, run) {
handoffDone = true;
}
}
if (handoffDone) enterExecuting(sessionId);
if (handoffDone) {
// 顾问标题已由 toolHandoff 直写 sessions.title:广播同 maybeGenerateTitle 的 title 事件,
// 已开窗口刷详情页标题 + 重拉会话列表(finalize 的自动标题见非空即跳过,不会覆盖)。
const ht = db.prepare('SELECT title FROM sessions WHERE id = ?').get(sessionId);
if (ht && ht.title) bus.emit(sessionId, 'title', { title: ht.title });
enterExecuting(sessionId);
}
iter++;
}
if (iter >= maxIter && !run.cancelled) {
+4 -2
View File
@@ -50,8 +50,10 @@ When planning:
When work should start — the requirement is clear, or the user explicitly asks
to skip planning, or clarification has visibly stalled — call the `handoff`
tool with a `reason` and the full `brief`. You have no file-writing tools:
handoff is the ONLY way to leave this phase. The system stores your `brief` as
tool with a `reason`, the full `brief`, and a concise `title` for this
conversation (in the user's language; it becomes the session's display title).
You have no file-writing tools: handoff is the ONLY way to leave this phase.
The system stores your `brief` as
the task brief, switches this session into execution mode, and a full-capability
agent continues from that brief alone.
Therefore:
+6 -1
View File
@@ -114,7 +114,8 @@
"type": "object",
"required": [
"reason",
"brief"
"brief",
"title"
],
"properties": {
"reason": {
@@ -129,6 +130,10 @@
"brief": {
"type": "string",
"description": "The task brief content, in Markdown. Follow the structure described in your system prompt."
},
"title": {
"type": "string",
"description": "A concise title for this conversation, in the user's language (3-7 words, or 6-14 Chinese characters). Straight to the title: no quotes, no prefix like \"Title:\"."
}
}
}
+8
View File
@@ -1119,6 +1119,8 @@ function runLabHelp(args) {
}
// handoff:顾问阶段唯一出口(advising 组合见 config.js)。brief 原样落盘任务目录根 task.md;
// title 直写 sessions.title(交接此刻顾问最懂这单任务,标题以此为准,finalize 的
// maybeGenerateTitle 见非空即跳过);批尾由 engine 广播 title 事件同步已开窗口。
// 切换不在此发生——executeTool 只落盘与回执,runLoopInner 在工具批尾接成功回执触发 enterExecuting
//(其读盘取快照作锚点,幂等防重切)。phase 守卫不可省:「名单外工具照跑」是全局策略,
// 执行期幻觉调用不得覆写修订中的 task.md;reason 枚举与 brief 非空也在此兑底(checkToolArgs 只查必填键)。
@@ -1131,9 +1133,15 @@ async function toolHandoff(ctx, args) {
}
const brief = typeof args.brief === 'string' ? args.brief : '';
if (!brief.trim()) return 'Error: brief 不能为空,任务书需完整带上(user_skip/user_stuck 至少含用户原话与 Missing 清单)';
// 标题清洗对齐 cleanTitle(engine 内函数,executor 反向引用会成环,此处同款口径):
// 压空白 + 截 60;引号剥除交给模型自觉(description 已明说),不做二次加工。
const title = String(args.title || '').replace(/\s+/g, ' ').trim().slice(0, 60);
if (!title) return 'Error: title 不能为空,给出一个概括任务的简洁标题';
const abs = path.join(ctx.taskDir, 'task.md');
await fsp.writeFile(abs, brief, 'utf8');
recordFile(ctx, abs); // 同步 files 元数据表(与 write_file 同轨,任务目录列表/清理逻辑一致)
// task.md 落盘成功后才改标题:切换半途失败不留「有名无书」的残局
ctx.db.prepare('UPDATE sessions SET title = ?, updated_at = ? WHERE id = ?').run(title, Date.now(), ctx.sessionId);
// 同批多次 handoff:后写覆盖(last-wins),批尾的切换只发生一次(enterExecuting 幂等)。
return '任务书已写入 task.md(reason: ' + reason + '),本批工具跑完后系统将切换到执行模式。请在给用户的回复里带一句「已切换到执行阶段」。';
}