cursor中编写cli工具需用结构化提示词明确功能、参数、错误处理和交互：必须含动词指令，提供真实help样本，限定语气粒度，并验证是否满足工程规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中为AI编写命令行工具的说明提示词，需要让模型准确理解你期望生成的CLI工具功能、输入输出格式、错误处理逻辑和用户交互方式。直接给一段模糊描述，AI容易生成不符合实际使用场景的代码。
先明确命令行工具的核心要素
打开Cursor新建文件，输入以下结构化提示词（复制粘贴即可）：
“你是一个资深CLI工具开发者，请用Python + argparse生成一个命令行工具，实现【把指定目录下所有.md文件转成HTML并保存到output/子目录】。要求：1）必须支持--input-dir和--output-dir两个必选参数；2）自动创建output目录（若不存在）；3）转换失败时打印具体错误文件名和原因，不中断后续处理；4）最后输出成功转换的文件数量。”
这一步的关键是把“做什么”“怎么用”“边界情况怎么处理”全写进提示词，避免AI自由发挥。
参考风格怎么给才有效
方法一：贴一段你认可的真实CLI帮助文本
在提示词末尾追加：
“请严格参照以下风格输出help信息（注意缩进、标点、大小写）：”
“usage: md2html [-h] --input-dir INPUT_DIR --output-dir OUTPUT_DIR”
“Convert markdown files to HTML.”
“optional arguments:”
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
“ -h, --help show this help message and exit”
“ --input-dir INPUT_DIR source directory containing .md files”
“ --output-dir OUTPUT_DIR destination directory for generated HTML files”
注意：不要只说“按标准argparse风格”，必须给真实文本样本——AI对“标准”的理解常和你不同。
方法二：用自然语言限定语气和粒度
在提示词里插入这句话：
“生成的帮助文本要像click或typer文档那样简洁直接，不解释原理，不出现‘本工具用于’这类冗余主语，每个参数说明控制在12个字以内。”
三步验证提示词是否合格
第一步：检查是否包含明确动词指令——比如“生成”“实现”“确保”“禁止”，而不是“可以”“建议”“考虑”。
第二步：确认有没有漏掉关键约束条件——例如是否要求兼容Windows路径、是否需处理中文文件名、是否要支持--verbose开关。漏掉这些，AI默认按Linux+英文环境处理。
第三步：把提示词丢进Cursor的Agent模式，观察它第一轮生成的代码里有没有出现sys.argv硬编码、print代替logging、或者把所有逻辑塞进main()函数没做模块拆分。如果出现，说明提示词里缺少工程实践要求，要补上：“代码需拆分为parse_args()、convert_file()、main()三个函数，main仅负责调用。”
