为Gemini编写CLI帮助文案时，须先锁定目标人群（如SRE、数据分析师）与具体场景（如灰度发布排查、Python脚本对接），再在参数说明中嵌入角色化注释、双视角描述及场景化默认值，并用含主语的动作短句替代模糊表述，示例需绑定角色与目的。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
为gemini编写命令行帮助文案时，需让提示词明确指向特定人群（如运维工程师、数据分析师）和具体场景（如ci/cd流水线报错排查、本地开发环境调试），否则生成的-help输出会泛泛而谈、缺乏实操指导性。在提示词开头锁定人群与场景
第一步：用一句话定义目标用户身份和当前所处环节。例如：“你是一名有3年Kubernetes运维经验的SRE，正在为内部CLI工具cli-tool编写--help文案，该工具专用于灰度发布阶段的Pod状态快照导出。”
第二步：紧接着说明该帮助文案的实际使用上下文。例如：“用户会在终端输入cli-tool snapshot --help后立刻看到这页内容，此时他们刚遇到Canary rollout卡住的问题，需要快速确认--timeout和--namespace参数是否支持缩写、是否必填、默认值是否合理。”
这一步不能省略。不锚定人群和场景，Gemini容易把--help写成教科书式定义，比如“--timeout：设置超时时间”，而不是“--timeout：【单位秒，默认30】灰度检查超时阈值，低于15秒可能导致误判Pod未就绪”。
用括号注入人群特征词到参数说明中
方法一：在每个参数描述末尾添加角色化注释。例如：
--format json 输出为JSON格式（【运维需对接Prometheus告警脚本，必须能被jq解析】）
--dry-run 仅打印将执行的操作（【新入职同事首次执行前必加，避免误删生产ConfigMap】）
方法二：对同一参数提供双视角说明。例如：
--label KEY=VALUE 为快照添加标签（开发者视角：用于标记A/B测试分支；SRE视角：该标签将自动同步至Grafana面板筛选器）
用对比句式强制区分场景优先级
在描述多用途参数时，直接写出不同场景下的首选值。例如：
--retry N 失败重试次数（本地调试建议设为1，跳过等待；CI环境请设为3，容忍临时网络抖动）
注意：不要写“可根据需要调整”，这种表述会让Gemini忽略场景约束。必须给出带主语、有动作、含判断依据的短句。
在示例部分绑定真实终端行为
给出的usage示例必须包含人群+场景关键词。例如：
# SRE在发布看板发现canary-pod异常，快速导出最近3次快照比对
cli-tool snapshot --since 3h --limit 3 --format yaml > /tmp/canary-debug.yaml
再例如：
# 数据分析师需将结果喂给Python脚本做趋势分析
cli-tool snapshot --format json --label team=ml --output - | python3 parse_snapshots.py
这两条示例不能只写“常用示例”，必须出现角色名（SRE/数据分析师）和动作目的（比对、喂给脚本）。Gemini依赖这种信号才能生成有上下文感的帮助文案。
