🎬 HoRain 云小助手：个人主页

⛺️生活的理想，就是为了理想的生活!

---

⛳️ 推荐

前些天发现了一个超棒的服务器购买网站，性价比超高，大内存超划算！忍不住分享一下给大家。点击跳转到网站。

目录

⛳️ 推荐

1. 采用四段式结构锁定需求

2. 精简冗余，聚焦技术主干

3. 复杂任务分阶段执行

4. 语气与风格精准控制

5. 验证与迭代技巧

---

Codex CLI 的提示词质量直接决定代码生成的准确性和效率，核心在于结构化表达、精准约束和避免冗余。与其堆砌长篇描述，不如用动词主导的原子化指令+明确验收标准，让模型聚焦技术实现而非猜测意图。以下是经实战验证的关键技巧：

---

1. 采用四段式结构锁定需求

必须包含目标、上下文、约束、验收标准，缺一不可。

• Goal（目标）：用动词开头明确动作，避免模糊表述。
  错误示例：“优化时间格式” → 正确示例：“重写 src/utils/date.ts 中的 formatISODate 函数”。
• Context（上下文）：直接提供文件路径+关键代码片段，而非描述性语言。
  错误示例：“处理日期的工具函数” → 正确示例：粘贴 formatISODate 函数的具体实现代码。
• Constraints（约束）：列出硬性条件，避免主观表述。
  错误示例：“保持风格一致” → 正确示例：“函数命名用 camelCase，if 分支必须带大括号，单行语句不省略分号”。
• Done when（验收标准）：可量化的完成指标，而非抽象要求。
  错误示例：“保证健壮性” → 正确示例：“输出包含 3 个测试用例，覆盖 null、空字符串、ISO8601 时间戳三种输入”。

关键点：Codex 不会自动猜你指哪段代码，缺失具体路径或代码片段时，90% 以上概率会修改错误文件。

---

2. 精简冗余，聚焦技术主干

• 删除所有礼貌性前缀：“请”“麻烦”“希望你”等对模型无意义，仅保留动词+宾语+约束。
• 拆分复合需求：将多条件任务拆为原子动作。
  错误示例：“写一个能处理JSON、支持分页、带错误重试、输出CSV的API客户端”
  正确示例：
  1. “写一个Python函数，接收URL和JSON字典，发送POST请求”；
  2. “若返回状态码非2xx，则重试最多2次，间隔1秒”；
  3. “成功后将响应数据转为CSV字符串并返回”。
• 移除重复约束：同一要求只留一句明确声明，如 “必须用Type Hints” 足矣，无需多次强调。

关键点：提示词超过 1800 字符易被截断（Codex CLI 上下文窗口约 2048–4096 token），优先砍掉示例代码块——它们消耗极高 token 但效果不如清晰约束。

---

3. 复杂任务分阶段执行

• 用 Step N 显式分步：单次提示只提交一个步骤，避免超限或逻辑断裂。
  示例流程：
  1. Step 1：生成基础函数框架，含参数签名、返回类型及 docstring 大纲；
  2. Step 2：添加 HTTP 请求逻辑与状态码判断分支；
  3. Step 3：追加重试机制，明确最大尝试次数为 2。
• 大型重构前先规划：要求 Codex 先输出完整变更计划再执行。
  提示词模板：“先列出：1. 当前组件目录结构；2. 重复代码点；3. 高风险文件；4. 分阶段迁移计划。确认后再修改”。

关键点：分步执行比单次长提示更稳定，且能快速定位哪步出错，避免模型因上下文过长丢失关键约束。

---

4. 语气与风格精准控制

• 禁用模糊描述：不说 “改得自然一点”，而指定 具体风格锚点。
  错误示例：“让文案更友好” → 正确示例：“参考项目中‘再试一次吧’的停顿逻辑，输出 4 字以内带口语节奏的文案，禁用‘敬请’‘谨此’”。
• 分层注入信号：
  • 前置语气指令：“以一线产品运营口吻输出，带 0.3 分调侃感”；
  • 约束词替代法：“必须含语气助词（吧/啦），禁用‘予以’‘加以’”；
  • CLI 高级模式调温度：--temperature 0.75（低于 0.6 易死板，高于 0.8 可能失控）。

关键点：语气调整必须在提示词开头声明，否则模型默认按技术文档风格输出，生成 “确认提交” 等反人类表达。

---

5. 验证与迭代技巧

• 三步检查法：
  1. 读出来：用手机朗读功能测试文案流畅度；
  2. 对照锚点：与项目中 3 个典型句子并排比对节奏与用词；
  3. 人工验收：对关键输出必须运行测试命令验证，而非仅依赖模型自述。
• 迭代优化流程：
  1. Codex 完成初步实现；
  2. 明确指出改进点（如 “添加按创建时间排序功能”）；
  3. 模型调整后再次验证，避免模糊反馈如 “让它更快”。

关键点：模糊的提示词必然导致返工，明确要求 “查询时间从 500ms 降至 100ms 以内” 比 “优化性能” 高效 10 倍以上。

❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄

💘💘💘如果觉得这篇文对你有帮助的话，也请给个点赞、收藏下吧，非常感谢!👍 👍 👍

🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙