你是一个 cli 工具文档工程师。请为以下命令生成可直接发布的 --help 文案:azd deploy --environment dev --verbose。要求:① 严格使用 posix help 格式;② usage 行必须为第一行,形如 usage: azd deploy \[options\];③ 所有选项按字母序排列,每行格式为 -e, --environment 设置部署环境(必填);④ 不添加解释性句子,不使用冒号分隔说明,不换行;⑤ 最后新增 ‘examples’ 段落,仅包含两行:$ azd deploy --environment prod 和 $ azd deploy --environment dev --verbose。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要把 Copilot 生成的命令行帮助文案,直接用于产品文档或 CLI 工具的 --help 输出,但当前结果口语化、格式混乱、缺少结构层级,无法直接发布。
明确命令行帮助文案的发布标准
先确认你的目标输出是否符合 POSIX 和 GNU 帮助惯例:首行是 usage 行(粗体/等宽字体),参数用方括号标注可选性,必选项不加括号;子命令单独成段并缩进;每个选项后紧跟短横线说明,说明文字左对齐、不换行;最后是 “Examples” 段落,每例独占一行、带 $ 前缀。Copilot 默认不遵循这套规范,必须强制约束。
这一步不能跳过——若提示中未声明格式标准,Copilot 会按自然语言习惯排版,生成的文案需人工重排,耗时翻倍。
构造强约束型提示词
方法一:用「指令+模板」双锁定法
在 Copilot 提示框中输入以下完整内容(含换行):
“你是一个 CLI 工具文档工程师。请为以下命令生成可直接发布的 --help 文案:`azd deploy --environment dev --verbose`。要求:① 严格使用 POSIX help 格式;② usage 行必须为第一行,形如 `usage: azd deploy [options]`;③ 所有选项按字母序排列,每行格式为 ` -e, --environment
【务必复制整段文字粘贴,不可删减任何格式要求条款】
方法二:引用已有合规文案作为锚点
Microsoft Copilot是微软推出的AI助手,整合于Windows、Edge、GitHub及Microsoft 365等产品中。它内置于Word、Excel、PowerPoint、Outlook和Teams等应用,通过大型语言模型与Microsoft Graph中的组织数据(如文件、邮件)相结合,提供文档起草、数据分析、会议总结等上下文感知的智能协助,旨在提升工作效率与创造力。
打开一个已发布的 CLI 工具(如 git、jq 或 terraform)的官方 --help 输出,截取其 help 文案前 15 行,保存为文本文件 help_template.txt。在 Word 或 Copilot 对话框中,点击「引用文件」→ 上传该文件 → 在提示中写:“参照附件中的 help_template.txt 格式,为 `kubectl rollout status deployment/myapp` 生成等效 --help 文案。”
此方法成功率更高,Copilot 会模仿真实排版细节,包括空格数、缩进宽度和标点位置。
验证与微调操作路径
第一步:生成初稿后,立即检查三项硬指标:
• usage 行是否为首行且无额外文字;
• 所有选项是否以两个空格开头、短选项与长选项是否用逗号连接;
• Examples 段落是否以大写 E 开头、无编号、每行以 $ 起始。
第二步:若某项不满足,不要重新生成,直接在原提示末尾追加修正指令,例如:“修正:-v 选项应写作 `-v, --verbose`,说明文字改为‘启用详细日志输出’,不加句号。”
第三步:确认无误后,在 Word 中全选文案 → Ctrl+C → 粘贴到代码编辑器(如 VS Code)→ 切换为纯文本模式 → 复制为 Markdown 或 AsciiDoc 片段 → 提交至文档仓库。










