DeepSeek命令行提示词复用指南:从零到精通
你是否总在编写命令行工具的帮助文档提示词时反复从零开始:逐一描述需求、列举参数、交代格式?到了第四次或第五次,不是遗漏关键字段,就是输出风格前后割裂,甚至莫名出现大段原理说明,根本无法直接套用。
本质上,解决路径很直接——将提示词固化为可复用的JSON模板,每次仅替换变量。以下直接进入实操。
先提取原始提示词的骨架
回顾你最近一次成功生成CLI帮助提示词的案例。把完整的提示词摊开,用笔划出:哪部分是固定结构指令,哪部分是随工具变换的变量。工具名称、核心功能、参数列表、输出示例——这些就是模板中需参数化的字段。
固定不变的部分,例如“生成符合POSIX标准的man page风格说明”“使用英文,不加markdown”,必须原封不动保留在模板里。一旦删减或弱化,模型会默认套用自身风格,输出大概率偏移预期。
按官方结构重写为可复用JSON模板
新建文本文件,命名为 cli-help-template.json,将以下结构粘贴进去:
{
"task_type": "generate_cli_help",
"context": "为命令行工具 {tool_name} 编写用户帮助文档,该工具用于 {purpose}。支持参数:{args_list}。典型用法示例:{example_usage}。",
"constraints": [
"输出严格遵循 man page 第1节格式",
"不使用任何 markdown 符号,仅用空格和换行排版",
"参数说明必须包含类型(string/bool/int)、是否必填、默认值(若适用)",
"首行必须为 '{tool_name}(1) — {brief_desc}'",
"禁止解释原理或提供教程式引导"
],
"output_format": "纯文本,无额外说明,无空行分隔"
}
占位符如 {tool_name}、{purpose} 必须用大括号包裹,后续替换时一一对应。特别强调:“禁止解释原理或提供教程式引导”这条约束必须保留,否则模型极易自动追加冗余说明段落,破坏man page排版。
用YPrompt管理并快速注入变量
安装YPrompt(GitHub开源项目),将刚保存的 cli-help-template.json 拖入工作区。
接下来用实际案例演示填充效果:
- 点击「New Prompt」→ 选择该JSON模板
- 在变量面板依次填入:
tool_name →git-squash
purpose →交互式合并多个commit为单个提交,保留原始author信息
args_list →-m(必填,合并后提交信息), -f(可选,强制覆盖当前分支)
example_usage →$ git-squash -m "feat: add login flow" HEAD~3
brief_desc →交互式Git提交压缩工具
点击「Run」,YPrompt自动完成变量替换并发送给模型。输出文本直接是开箱可用的man page格式,无需二次整理。
从此,每次编写命令行工具帮助文档的提示词,只需替换几个字段便可稳定产出统一风格的结果。不必逐字重写描述,无需反复核对是否遗漏关键参数字段,也不再头疼输出格式前后不一致。模板化带来的效率提升,一目了然。