如何让助手准确理解并执行持久化计划
一行提示词的背后
"You are Claude Code executing a jianfei-plan durable plan. Plan dir: /Users/apple64/Documents/jf-plans/plans/jp047-plan"
这是一条看起来有些特殊的提示词。它不是传统的问答对话,而是一个带有明确指令格式的初始化语句。用户通过这种方式,让 AI 助手进入一个特定的"计划执行模式"。
这个场景值得我们深入分析:为什么用户要这样写?这种提示词格式是如何设计的?它背后遵循什么样的判断逻辑?
问题背景:协作中的上下文丢失
在实际的 AI 辅助工作中,一个常见的痛点是上下文的连续性问题。
用户可能制定了一个包含多个步骤的工作计划,但在实际执行过程中,每次新的对话都是"重新开始"。助手不会自动记住上一轮对话中讨论的计划内容,也不会自动继续未完成的任务。
这种情况下,用户不得不做两件事:
- 在每个新会话中重新描述计划内容
- 手动告诉助手"上次做到哪一步了"
这不仅浪费时间,还容易出错。如果描述不完整,助手可能会重复执行已完成的步骤,或者遗漏关键任务。
解决方案:通过提示词注入计划上下文
"You are Claude Code executing a jianfei-plan durable plan" 这行提示词,就是为了解决上述问题而设计的。
它的核心思路是:通过标准化的提示词格式,在会话初始化时就把计划上下文注入到助手的"记忆"中。
让我们拆解这个提示词的设计:
第一层:角色定位
"You are Claude Code executing a jianfei-plan durable plan" —— 这句话定义了助手的角色。它不是一个通用的对话助手,而是一个正在执行持久化计划的执行者。这个角色定位会影响助手后续的所有行为:它会优先处理计划相关的内容,而不是随意闲聊。
第二层:计划路径
"Plan dir: /Users/apple64/Documents/jf-plans/plans/jp047-plan" —— 这里指定了计划文件的位置。助手知道去哪里读取计划的详细内容。通过文件路径而不是内联文本的方式,既保持了提示词的简洁,又确保了计划内容的完整性和可更新性。
第三层:技能绑定
"Project: /Users/apple64/.agent/skills/jianfei-plan" —— 这指明了相关的技能模块。助手在执行计划时,可以调用这个技能中定义的方法和工作流程。
判断链:为什么这样设计有效?
这种提示词格式之所以有效,是因为它遵循了 AI 助手的"判断链"逻辑。
当助手收到这段提示词时,它会进行以下判断:
判断一:我在扮演什么角色?
通过 "You are..." 语句,助手明确了自己的身份定位。这不是一个需要用户解释的前提,而是一个直接被"告知"的事实。助手不需要推断,只需要接受并按这个角色行事。
判断二:我要执行什么任务?
"durable plan" 这个关键词告诉助手:这是一个需要跨会话持续执行的计划,不是一次性任务。助手会建立相应的执行心态:查找当前进度、确认下一步行动、记录执行结果。
判断三:资源在哪里?
通过路径信息,助手知道去哪里获取计划的详细内容。这避免了用户重复描述计划的问题,也确保了计划内容的一致性。
判断四:我有哪些工具可用?
技能路径告诉助手,执行这个计划时可以使用哪些预定义的方法。这降低了助手"从零开始设计执行方案"的负担,提高了执行的规范性。
从这个案例中学到什么?
这个场景给我们的启示是:好的提示词不是"多说话",而是"说对位置"。
传统的提示词优化思路是:把所有相关信息都写进去,让助手"看到一切"。但这种方法有两个问题:
- 提示词会变得很长,增加理解和处理的复杂度
- 内联的内容难以更新,每次修改都需要重新编写提示词
而 "You are executing a plan" 这种模式采用了不同的思路:
- 通过角色定位建立执行框架
- 通过路径引用实现内容分离
- 通过技能绑定提供方法支持
这种方法的核心是:用最少的提示词,建立最清晰的上下文框架。具体的内容(计划详情、执行方法)则通过引用的方式加载。
可复用的设计模式
从这个案例中,我们可以提炼出一套可复用的提示词设计模式:
模式一:角色定义 + 任务类型
"You are [角色] executing a [任务类型]" —— 这个格式让助手立即进入正确的"工作模式"。
模式二:路径引用而非内容内联
把详细内容放在文件中,提示词只提供路径。这样做的好处是:提示词保持简洁,内容可以独立更新。
模式三:技能绑定
对于复杂任务,指定相关的技能模块,让助手知道"有哪些工具可用"。
模式四:关键词设计
"durable" 这个词很关键。它传递了"持久化"的意图,暗示助手需要考虑跨会话的连续性。好的关键词能准确传递意图,减少误解。
结语
"You are Claude Code executing a jianfei-plan durable plan" 这行提示词,看起来只是一句简单的指令。但它背后体现的是一种系统化的协作思维:通过标准化的格式,让 AI 助手快速进入正确的上下文状态。
这种方法不仅提升了单次协作的效率,更重要的是,它提供了一种可复用的工作模式。当你下次需要让助手执行一个持久化任务时,可以借鉴这种格式:角色定位 + 计划路径 + 技能绑定。
这就是从单次协作到可复用方法的提炼过程。每一次有效的对话,都是一次方法沉淀的机会。