Claude提示词：命令行帮助文案限制条件完整指南

用大模型生成命令行帮助文本？表面简单，实际踩坑不少。大多数情况下，Claude 会自动追加一段“温馨提示”——像什么“例如”“你可以”“建议”这类词，初看体贴，实则彻底脱离 help 应有的基调。

要让模型输出一份能直接粘贴进终端的 help 文案，核心在于提示词内锁死三个维度：输出格式、内容边界、行为逻辑。三者一次性定死，才能杜绝冗余。

限定输出纯 help 文案内容

第一步，在提示词开头直接划定输出范围——【仅输出命令行 help 文案本身，不附加任何前导说明、不解释、不举例、不出现多余空行或换行】。

第二步，用括号明确标出标准结构。例如：“格式必须严格匹配 GNU 风格 help 输出：以 Usage: 开头，随后依次展示短选项（-h）、长选项（--help）、对齐缩进的描述，末尾无空行”。

第三步，追加一条否定式禁令：“禁止出现‘例如’‘比如’‘你可以’‘建议’‘注意’等任何引导性或教学性措辞”。

绑定具体命令与参数语义

方法一：给出完整的命令原型，比如 “curl -X POST -H ‘Content-Type: application/json’ -d @data.json https://api.example.com/v1/upload”，然后要求：“基于此命令生成其 --help 输出，所有选项必须真实对接上述参数，-X 对应 --request，-H 对应 --header，-d 对应 --data”。

方法二：用键值对显式定义映射关系，例如：-f → --force（强制覆盖已存在文件），-q → --quiet（静默模式，不输出进度）。Claude 会依据此映射逐项生成 help 描述，不会凭空编造语义。

控制排版与长度

指定每行最大字符数：“所有 help 行宽度 ≤ 80 字符，长选项描述换行时采用 4 空格缩进”。

这一步操作极简：直接将“≤ 80 字符”写入提示词即可。否则 Claude 默认按自然语句断行，最终 help 文案在终端中全部错位。

【必须显式声明是否包含 version 和 copyright 行】——多数 CLI 工具 help 末尾都会附带类似 “mytool 2.4.0” 或 “Copyright © 2024” 的信息。不锁定这一点，Claude 要么遗漏，要么擅自添加，结果完全不可控。