Skip to content

♻️ system prompt 减法 + 🌐 全面中文化(sidecar agent prompt 治理) - #276

Open
CavinHuang wants to merge 2 commits into
mainfrom
worktree-prompt-subtraction
Open

♻️ system prompt 减法 + 🌐 全面中文化(sidecar agent prompt 治理)#276
CavinHuang wants to merge 2 commits into
mainfrom
worktree-prompt-subtraction

Conversation

@CavinHuang

@CavinHuang CavinHuang commented Aug 21, 2026

Copy link
Copy Markdown
Owner

概要

对 sidecar agent system prompt 做两轮改造(两个 commit):

  1. ♻️ 减法:13044 → 9473 字符(-27%),净删 131 行——消除重复、僵尸段落与无守卫的工具引用
  2. 🌐 中文化:全部英文段落与标题译为中文,9473 → 5048 字符(中文信息密度更高;token 收益因分词而异,勿按字符比例外推)

Commit 1:减法(♻️ refactor)

删除(零行为影响)

  • 返回空串的段落函数与未引用常量
  • ~/.lume/lume.yaml.context/ 用法、brainstorming 规则的逐字重复行
  • Expression Strategy 中 image_gen 的静态引用——image_gen 为条件创建工具,无工具会话中构成幻觉调用诱因

合并(段落 17 → 14)

  • 系统配置 + 工作区 + Workspace Knowledge → 单一「工作区」段;去掉纯 UI 用途的 workspaceName 注入(动态值织入静态段还会打断 prompt cache)
  • Execution Modes + Capability Routing → 单一决策阶梯
  • Loaded Context Policy → 并入 Memory 段,随记忆工具条件注入

精简(schema 已承担的教学)

  • TodoWrite 段 26 → 4 行(工具 schema 自足)
  • Office 段 47 → 16 行:删 Python 示例;路由清单按 availableTools 逐项裁剪,修复"守卫只查 4 个工具却宣称 9 个"的自相矛盾
  • Coding loop 收敛为三条硬规则(禁管道过滤验证命令/后台不轮询/禁自动 git 操作)
  • bypassPermissions 分支去除三遍重复强调

Commit 2:中文化(🌐 style)

  • 全部英文段落与标题译为中文(含身份句、minimal 工作区段、不确定性 default 分支)
  • planner 子代理 prompt 中文化
  • workspace-context 段(总标题/人设摘要/记忆摘要)中文化
  • 保留英文:工具名、角色名、schema 字段(content/activeForm/in_progress/subagent_type/task_ref)、claim 谓词(preferred_name)、机器元数据行(mode=...)、命令与脚本名——这些是模型接口,翻译会破坏调用
  • 范围外:后台子代理(dream/background-extractor/advisor)prompt 保持英文(JSON 输出导向、用户不可见)

保留决策(经验证)

  • 14 个内置子代理角色清单保留:Agent 工具的 subagent_type schema 为静态描述、不反射注册表,此清单是模型发现内置子代理的唯一渠道
  • 子代理协作/兼容两段保留:TaskReport/FinishAgentTask coordinator 路径仍在使用
  • Memory claim 三元组示例保留:memory-v2 实际解析 subject/predicate/object 并做冲突检测

有意的行为变化

  1. 无 workspaceSlug 的会话不再显示配置入口行(minimal 模式仍保留)
  2. 无记忆工具的会话不再注入 loaded-context 规则
  3. TodoWrite 的 blocked-creates-new-task 与收尾 reconcile 规则移交工具 schema description 承担

验证

  • bun run typecheck 绿
  • prompt sections + builder + workspace-context + context-assembler 测试全绿(50 + 19);对齐脚本 25/25
  • run.test.ts:本轮引入的唯一真实回归(planner prompt 断言)已修复;其余失败项经 main baseline 对比 + 逐项 -t 单独重跑全过,确认为并发资源竞争 flaky(三次全量运行失败集合互不相同),transcript 一项 main 上同样红(预存)

Follow-up

  • Agent 工具 subagent_type schema 动态反射注册表后,可进一步回收 prompt 中的角色清单
  • CLAUDE_PLAN_MODE_SECTION 常量名与产出内容(执行模式)不符,宜改名
  • 中文化后建议人工冒烟一轮多模型对话,确认指令遵循度无退化

🤖 Generated with Claude Code

TaTaLiao and others added 2 commits August 21, 2026 11:30
- 删除返回空串的僵尸段落函数与未引用常量
- 系统配置/工作区/Workspace Knowledge 三段合并为单一「工作区」段,去掉无用的 workspaceName 注入
- Execution Modes 与 Capability Routing 合并为单一决策阶梯,删除重复的 lightest 开头句与 brainstorming 重复行
- Loaded Context Policy 三行并入 Memory 段,随记忆工具条件注入
- TodoWrite 段 26→4 行:使用规则与 content/activeForm schema 由工具定义自足承担
- Office 段 47→16 行:删除 Python 示例(工具 schema 已含教学),路由清单按 availableTools 裁剪,消除宣称未注册工具的自相矛盾
- 删除 Expression Strategy 中无守卫的 image_gen 静态引用(工具为条件创建,无工具会话构成幻觉诱因)
- Coding loop 收敛为三条硬规则(禁管道过滤验证命令/后台不轮询/禁自动 git 操作)
- bypassPermissions 分支去除三遍重复强调,保留全部约束语义
- Tooling 4→1 行;Core Behavior 15→3 行,保留 persona 边界与提问规则
- 同步 6 个测试文件与 verify-prompt-alignment.ts 基线;新增 Coding loop 硬规则语义测试

Co-Authored-By: Claude <noreply@anthropic.com>
- 全部英文段落与标题译为中文:身份句/核心行为/工具使用/执行模式/安全契约/记忆/运行时/TodoWrite/内容呈现/浏览器优先标题/不确定性 default 分支/minimal 工作区段
- planner 子代理 prompt 中文化(explorer/researcher/code-reviewer 原即中文)
- workspace-context 段:总标题/人设摘要/记忆摘要/引导句中文化
- 保留英文:工具名、角色名、schema 字段(content/activeForm/in_progress/subagent_type/task_ref)、claim 谓词、机器元数据行、命令与脚本名
- 同步 8 个测试文件与 verify-prompt-alignment.ts 断言;对齐脚本口径下 9473→5048 字符
- 范围外:后台子代理(dream/background-extractor/advisor)prompt 保持英文

Co-Authored-By: Claude <noreply@anthropic.com>
@CavinHuang CavinHuang changed the title ♻️ refactor(sidecar): system prompt 减法——净删 131 行,体积 -27% ♻️ system prompt 减法 + 🌐 全面中文化(sidecar agent prompt 治理) Aug 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants