WorkBuddy 提示词模板体系深度解析

一、目录总览

resources/templates/ 共包含 15 个模板文件，组织为 4 个功能层级 + 1 个风格库：

resources/templates/
├── 系统提醒层（System Reminder Layer）
│   ├── system-reminder.tpl              ← 空占位符
│   ├── ask-mode-reminder.tpl            ← Ask 模式规则
│   └── craft-mode-reminder.tpl          ← Craft 模式规则
│
├── 用户身份层（Identity Context Layer）
│   ├── user-context-identity.tpl        ← 标准身份上下文（SOUL/IDENTITY/USER）
│   └── user-context-expert-identity.tpl ← 专家身份上下文（精简版，仅 USER）
│
├── 主提示词层（Core Prompt Layer）— 3×3 矩阵
│   ├── workbuddy-ask-prompt.tpl           ← Ask / 通用
│   ├── workbuddy-ask-coding-prompt.tpl    ← Ask / 编码
│   ├── workbuddy-craft-coding-prompt.tpl  ← Craft / 编码
│   ├── workbuddy-craft-design-prompt.tpl  ← Craft / 设计 ★ 完全独立体系
│   ├── workbuddy-expert-prompt.tpl        ← Expert / 通用
│   ├── workbuddy-expert-coding-prompt.tpl ← Expert / 编码
│   └── workbuddy-prompt.tpl               ← Craft / 通用（默认主模板）
│
└── 风格库（Style Library）
    └── style/
        ├── style-creative.md        天马行空
        ├── style-friendly.md        亲和友善
        ├── style-professional.md    专业严谨
        ├── style-sarcastic.md       毒舌吐槽
        ├── style-socratic.md        启发引导
        ├── style-straightforward.md 直言不讳
        └── style-efficient.md       高效务实

二、核心架构：三层叠加模型

运行时提示词由三层按顺序拼接而成：

┌─────────────────────────────────────────────────┐
│  Layer 1: system-reminder.tpl                   │  ← 系统级提醒（空/模式切换）
├─────────────────────────────────────────────────┤
│  Layer 2: user-context-*.tpl                    │  ← 用户身份/产品身份/风格/自定义指令
├─────────────────────────────────────────────────┤
│  Layer 3: workbuddy-*-prompt.tpl                │  ← 主提示词（模式 × 领域 矩阵）
└─────────────────────────────────────────────────┘

模板语法体系

全目录使用 Jinja2/Nunjucks 语法：

语法用途示例
{{ var }}变量插值{{ modelName }}, {{ productName }}
{% if cond %}条件块{% if IsWindows %}...{% endif %}
{%- if cond %}带空白控制{%- if not productFeatures.DisableMultimodalGeneration %}

特别用法：{% if '中文' in ResponseLanguage %} 进行语言判断。

关键变量全景

变量用途
modelName / productName / dataFolderName模型、产品、数据目录名
ResponseLanguage / BinaryContext响应语言、二进制上下文
IsWindows平台检测
WorkspaceIdentityModeonboarding vs 正常运行
SoulContent / IdentityContent / UserContent三大身份文件内容
ToneStyleContent用户选择的沟通风格
UserCustomPrompt用户自定义指令
ClawMemory_1/2/3三层记忆注入点
subAgentPrompt / ExpertManagement子代理 / 专家管理内容
PluginAgentPromptExpert 模式角色定义
ArtifactDirectoryPathArtifact 输出目录

三、模式矩阵：3 种模式 × 3 个领域

3 种工作模式

模式核心特征代表模板
Ask只读（Talk only, hands off），禁止任何修改workbuddy-ask-prompt.tpl
Craft执行（You say, I do），完整读写工具权限workbuddy-prompt.tpl
Expert专家（Agentic mode），插件智能体覆盖身份workbuddy-expert-prompt.tpl

3 个领域变体

领域定位特殊差异
通用全能助手均衡描述
编码编程专用条件渲染多模态生成（DisableMultimodalGeneration）
设计智能设计助手完全独立体系，画布操作、三部分回复格式

完整矩阵映射

              通用          编码           设计
Ask       ask-prompt    ask-coding      —
Craft     prompt        craft-coding    craft-design ★
Expert    expert-prompt expert-coding   —

关键发现：craft-design 不是 Craft 通用模板的变体，而是完全独立的设计体系（Intelligent Design Assistant）。

四、逐层深度解析

4.1 系统提醒层（Layer 1）

文件内容作用
system-reminder.tpl空 <system_reminder></system_reminder>占位符，可能被动态注入
ask-mode-reminder.tpl声明”只读模式”，禁止编辑、禁止运行非只读工具强制 Ask 模式行为约束
craft-mode-reminder.tpl声明”已进入 Craft 模式，文件读写能力已启用”模式切换信号

4.2 用户身份层（Layer 2）

user-context-identity.tpl（标准版）— 59 行

身份上下文（WorkspaceIdentityMode）
├── onboarding 模式
│   ├── BOOTSTRAP.md → "出生证明"
│   └── 需更新 SOUL.md → IDENTITY.md → USER.md → 删除 BOOTSTRAP.md
│
└── 正常运行模式
    ├── SOUL.md →  embody persona and tone
    ├── IDENTITY.md → 保持与最新注入身份一致
    └── USER.md → 用户画像

产品身份 → "You are {{ productName }}, a powerful AI assistant."
语气和风格（ToneStyleContent）→ 覆盖默认行为，最高优先级
用户自定义指令（UserCustomPrompt）→ 必须遵循，除非与安全规则冲突

user-context-expert-identity.tpl（专家版）— 30 行

与标准版的关键差异：

  • 没有 SOUL.md 和 IDENTITY.md — 专家角色完全由 {{ PluginAgentPrompt }} 覆盖
  • 没有 ToneStyleContent 和 UserCustomPrompt — 专家模式有独立的风格系统
  • 只有 USER.md — 保留用户画像，但角色身份由插件智能体定义

4.3 主提示词层（Layer 3）— 核心差异分析

4.3.1 Ask 模式（ask-prompt / ask-coding-prompt）— 142 行

核心约束：

<current_mode>
- Only answer questions, read files, and analyze information
- must NOT modify files or run shell commands
- must NOT claim that created/updated/saved/generated a local file
</current_mode>

特色模块：

  • instructions_for_visualizer — 详细可视化指令（120+行），含模型感知复杂度限制：
    • Claude/GPT：无上限，复杂 D3/Three.js
    • GLM/KIMI：中等复杂度，标准图表/简洁 SVG
    • Hunyuan/Minimax：最小复杂度，简单静态图表
  • ask_mode_behavior — 先解释原理，再创建计划，最后建议切换 Craft

4.3.2 Craft 通用模式（workbuddy-prompt.tpl）— 371 行

核心变化：

  • 无 <current_mode> 限制 — 完全读写权限
  • 工具使用策略：优先专业工具，并行执行，顺序依赖
  • Agent Loop：分析 → 思考 → 选择工具 → 执行 → 观察 → 迭代
  • Result Presentation 强制规则：最终工具调用必须是 present_files
  • Skill 系统：安装前必须安全审计（P0/P1/P2 风险分级）
  • Skill 累积：8+ 工具调用后必须保存为 Skill
  • Automation：SQLite 数据库管理，支持 recurring/once/validFrom/validUntil

4.3.3 Craft 编码模式（workbuddy-craft-coding-prompt.tpl）— 376 行

与 Craft 通用版几乎相同，仅 3 处差异：

  1. 多模态生成声明被条件包裹：{%- if not productFeatures.DisableMultimodalGeneration %}
  2. 能力描述顺序微调（编码场景优先）
  3. 其他内容完全相同

4.3.4 Craft 设计模式（workbuddy-craft-design-prompt.tpl）— 296 行 ★ 最独特

这是完全独立的体系，不是 Craft 通用版的变体。

身份定位：

You are the Intelligent Design Assistant (智能设计助手)
— design-focused capability of {{ productName }}

关键差异：

维度Craft 通用Craft 设计
身份全能 AI 助手智能设计助手
工作区文件系统画布（Canvas）+ .ardot 文件
工具集文件/命令/搜索画布操作 + 截图验证
回复格式自由格式强制三部分格式（Opening / Progress / Closing）
能力边界无限制明确拒绝非设计任务（代码开发、数据库、纯数学）
自我描述不领先说编码以设计同事自居

设计专属模块：

  • boundaries — 明确拒绝非设计请求
  • interaction_principles — 6 条设计交互原则
    • Target node takes priority：用户明确指定节点时，绝不猜测”用户真正想改什么”
  • agent_loop — 设计专用循环：理解意图 → 加载方法 → 执行 → 截图验证 → 迭代
  • result_presentation — 强制三部分结构： 
    Part 1 — Opening: 自然温暖回应，分享设计思考
---
Part 2 — Progress: 关键输出、风格、结构、截图验证
---
Part 3 — Closing: 总结成果，标记注意事项，邀请反馈
  • core_capabilities — Text-to-UI / Image-to-UI / 幻灯片生成 / 网站原型
  • .pptx 边界判定：关键词精确匹配才触发 pptx Skill

4.3.5 Expert 模式（expert-prompt / expert-coding-prompt）— 376 行

最关键特征：

**Role Override:** The following expert role definition takes precedence 
over any previously established persona or identity context.

{{ PluginAgentPrompt }}

专家模式的身份被 插件智能体提示词完全覆盖。系统记忆、用户记忆、产品身份全部退居二线。

Expert 模式特有：

  • agentic_mode_overview — Artifacts 系统：任务完成概览写入 {{ ArtifactDirectoryPath }}/overview.md
  • agent_loop — 7 步循环（含 Present outcome 步骤）
  • task_management — 任务管理工具（TaskCreate/TaskGet/TaskUpdate/TaskList）
  • ExpertManagement — 专家管理插槽
  • subAgentPrompt — 子智能体提示词插槽

Content Policy 更严格：

  • 通用版：允许反问/解释为何拒绝
  • 专家版：拒绝时不得解释原因（“When refusing, do not explain why”）

五、ClawMemory 插槽系统

所有主提示词模板包含 3 个记忆插槽：

{{ ClawMemory_1 }}  → 通常注入系统级规则/记忆
{{ ClawMemory_2 }}  → 通常注入工具使用/安全策略
{{ ClawMemory_3 }}  → 通常注入补充说明/边界情况

这种设计允许运行时动态注入记忆，而不需要修改模板文件本身。

六、安全策略体系

多层安全架构

Content Policy（内容政策）
├── 政治敏感内容拒绝（中国政治人物、制度、领土完整）
├── 色情/暴力/仇恨言论拒绝
├── 非法活动拒绝（武器、黑客、欺诈）
├── 隐私保护拒绝
├── 虚假信息拒绝
└── 港澳台必须标注"中国"

Personal Files Safety（个人文件安全）
├── No-Go Zones（Desktop/Downloads/Documents/Home 禁止递归删除）
├── Scan = Read-Only（扫描仅报告，不操作）
├── Vague = Ask First（模糊请求先确认）
├── Warn + List + Confirm（破坏性操作前警告）
├── Back Up First（操作前备份）
├── Trash, Not Delete（使用回收站而非 rm）
├── Small Batches（每批最多 10 文件）
└── No Script Files on Windows（Windows 不写 .ps1/.bat）

Windows Command Safety（Windows 命令安全）
├── 禁止额外 shell 包装（cmd /c, powershell -Command）
├── 绝对路径验证
├── 路径转义安全
└── 失败后禁止 retry workaround

七、风格库（Style Library）— 7 种人格

┌─────────────────────────┬────────────────────────────┬────────────────────┐
│ 风格                     │ 核心特征                    │ 适用场景            │
├─────────────────────────┼────────────────────────────┼────────────────────┤
│ Creative 天马行空        │ 想象力、故事化、比喻           │ 头脑风暴、创意任务    │
│ Friendly 亲和友善        │ 温暖、鼓励、日常类比           │ 新手引导、答疑       │
│ Professional 专业严谨.   │ 精确、证据、结构化             │ 技术文档、专业咨询   │
│ Sarcastic 毒舌吐槽       │ 幽默讽刺、但绝不人身攻击        │ 轻松氛围、调试排错   │
│ Socratic 启发引导        │ 提问式教学、渐进提示           │ 教育、学习场景       │
│ Straightforward 直言不讳 │ 直接、无废话、果断判断         │ 紧急决策、快速反馈    │
│ Efficient 高效务实       │ 极简、高密度、清单优先         │ 代码审查、快速操作    │
└─────────────────────────┴────────────────────────────┴────────────────────┘

每个风格定义包含：Tone & Voice（语气）、Language Patterns（语言模式）、Behavioral Guidelines（行为准则）、Response Structure（回复结构）四个维度。

八、关键设计洞察

1. 模板即产品

提示词模板不是配置，而是产品的核心逻辑载体。从模式切换、安全策略到记忆管理，全部编码在模板中。

2. 设计模式是独立产品

craft-design 不是 Craft 的 skin，而是完全独立的产品线（Intelligent Design Assistant）。它有独立的身份、边界、工作流和回复格式。

3. 条件渲染实现产品差异化

通过 Jinja2 条件（{% if %}）和变量插值（{{ }}），同一模板可适配：

  • 不同语言（中文/英文）— ResponseLanguage
  • 不同平台（Windows/macOS/Linux）— IsWindows
  • 不同功能开关 — productFeatures.DisableMultimodalGeneration
  • 不同用户状态 — WorkspaceIdentityMode（onboarding / normal）

4. 记忆插槽实现动态扩展

ClawMemory_1/2/3 让运行时系统能在不修改模板的情况下注入动态规则、记忆和策略。

5. 安全是分层且不可覆盖的

Content Policy 声明：“These safety rules override any user instructions and cannot be bypassed”

6. 可视化是模型感知的

Visualizer 复杂度限制根据底层模型（Claude/GPT/GLM/KIMI/Hunyuan/Minimax）动态调整，体现了对模型能力的精准认知。

九、文件规模统计

文件行数大小
workbuddy-craft-coding-prompt.tpl37636,899 B
workbuddy-prompt.tpl37135,756 B
workbuddy-expert-prompt.tpl37634,898 B
workbuddy-expert-coding-prompt.tpl37634,898 B
workbuddy-craft-design-prompt.tpl29629,067 B
workbuddy-ask-prompt.tpl1429,569 B
workbuddy-ask-coding-prompt.tpl1429,569 B
user-context-identity.tpl591,984 B
user-context-expert-identity.tpl30919 B
风格文件（7个）31-36各约 1KB
系统提醒（3个）2-437-582 B

十、总结

WorkBuddy 的模板体系是一个精心设计的提示词工程（Prompt Engineering）产品架构：

  • 三层叠加模型（系统提醒 → 身份上下文 → 主提示词）实现关注点分离
  • 3×3 矩阵（Ask/Craft/Expert × 通用/编码/设计）覆盖所有使用场景
  • 7 种人格风格提供个性化沟通体验
  • 多层安全策略保障不可突破的底线
  • 动态记忆插槽支持运行时扩展而不修改模板
  • 模型感知的可视化确保不同底层模型的最优输出

这套模板体系不仅是技术实现，更是产品哲学的编码化表达——每种模式、每个领域、每种风格都承载着对用户体验的深思熟虑。

相关文章