System Prompt

问题

到目前，系统提示词是一段手写的字符串："你是编程助手。对于多步任务：..."。

现在它需要包含：todo 计划（s05）、技能目录（s07）、历史摘要（s08）、权限规则（s03）、会话上下文（cwd、模型名）、以及全部工具 schema。如果这些内容都手工拼接进一个字符串——谁负责顺序？谁负责更新？注册一个新工具后忘了改系统提示词怎么办？

系统提示词不该是一段手写字符串，而是一个组装产物：各插件贡献自己的区块（带顺序），组装器按序渲染。

解决方案

区块注册表 + 命名变量：

• 每个插件注册一个 PromptSection（{ name, order, content }）；
• 组装器按 order 排序渲染，并解析 {{variable}} 占位符；
• 工具 schema 由注册表自动汇入（s02 的注册表现在同时喂养 prompt）。

const sections = []; // { name, order, content }

function section(name, order, content) {
  sections.push({ name, order, content });
}

function assemble({ model, cwd }) {
  const vars = { model, cwd };
  return sections
    .sort((a, b) => a.order - b.order)
    .map((s) => render(s.content, vars))
    .join("\n\n");
}

function render(template, vars) {
  return template.replace(/\{\{(\w+)\}\}/g, (_, k) => vars[k] ?? `{{${k}}}`);
}

工作原理

第 1 步：各机制以区块方式注册自己的 prompt 贡献：

section("harness:identity", -100, "You are an AI agent powered by Nano Harness.");
section("tools:policy", 0, `可用工具：${toolDescriptions()}`);
section("todo:plan", 10, renderPlan());          // s05 的计划
section("skills:catalog", 20, `可用技能：\n${catalog()}`); // s07 的目录
section("context:runtime", 30, "工作目录：{{cwd}}；模型：{{model}}");

第 2 步：每次请求组装一次——这就是为什么 todo 更新、技能加载、压缩摘要能在下一轮自动出现在系统提示词里：它们都是注册的区块，每轮重新渲染。

第 3 步：工具 schema 不再是"另一个数组"——它和区块一起构成请求的完整前缀。注册表、区块表、工具表三者统一。

组装的价值在于解耦：插件只声明"我要贡献什么、排在哪"，不需要知道其他插件贡献了什么。加一个技能目录？注册一个区块。换模型？变量替换。系统提示词永远自洽。

试一下

运行 s10，观察组装产物：

• 打印 assemble() 的结果，确认区块顺序与变量替换
• 故意把两个区块的 order 设成相同——发生什么？（DSH 的答案：顺序不稳定是配置错误，加载期报错）
• 给 cwd 传不同的值，确认 {{cwd}} 正确渲染

观察重点：order 为什么是显式数字而不是注册顺序？——注册顺序是插件加载的偶然产物，不该决定模型看到的顺序。