角色：您是一位构建 {COMPONENT_TYPE} 的高级 {LANGUAGE} 工程师。
目标：实现 {FUNCTION_NAME}，使其 {FUNCTION_PURPOSE}。
约束：
- 遵循 {STYLE_GUIDE}（命名、文档、错误处理）。
- 时间复杂度目标：{BIG_O}。内存约束：{LIMITS}。
- 为不明显的逻辑包含文档字符串和内联注释。
- 避免外部依赖，除非有正当理由；如果添加，请解释。
输入：
- 接口/类型：{TYPES}
- 边缘情况：{EDGE_CASES}
- 示例输入/输出：{EXAMPLES}
交付件：
1) 仅最终代码块。
2) 代码后的简要理由（要点）。

角色：您是一位构建数据清理实用程序的高级 Python 工程师。
目标：实现 `normalize_names`，使其标准化用户名。
约束：
- 遵循 PEP8；在无效类型上引发 ValueError。
- O(n) 时间；处理空格和重音符号；保持内存线性。
- 文档字符串 + 注释。
输入：
- 类型：List[str] 或 Iterable[str]
- 边缘情况：null 值、多个空格、重音符号、带连字符的姓氏
- 示例：[" José Álvarez ", "ANNA-lou "] → ["jose alvarez", "anna-lou"]
交付件：
1) 仅最终代码块。
2) 简要理由。

角色：高级 {LANGUAGE} 重构专家。
任务：重构提供的代码以实现 {GOAL}：{READABILITY|PERFORMANCE|SAFETY}。
规则：
- 保留公共 API 和行为。
- 在缺少类型提示和文档字符串的地方添加它们。
- 提取纯函数以进行测试。
- 替换魔术数字；强制执行 {STYLE_GUIDE}。
- 提供重构前/后的复杂度说明。
输入代码：
```{LANGUAGE}
{SOURCE}

### 3) 测试生成模板（单元测试 + 属性测试）
**何时使用**：快速增加覆盖率。

### 4) 代码审查模板（自动审查员模式）
**何时使用**：在人工批准之前进行快速、一致的审查。

{UNIFIED_DIFF}

### 5) 调试模板（最小重现 → 根本原因）
**何时使用**：查找和修复错误，创建重现。

---
## 示例：使用 Grok 4 Fast 从 Ticket 到 PR
让我们来看一个真实的场景：一个产品 ticket 请求“具有防抖 API 调用和乐观 UI 的边输入边搜索”。
1) **起草 hook**

2) **请求测试**

3) **运行审查**

4) **优化**

结果：您将拥有可用于生产的代码和测试，并且 AI 将记录其推理过程，以便队友可以跟进。
---
## 提升输出质量的提示模式
- **角色 + 目标 + 约束 + 输入 + 交付件**：此结构为 Grok 4 Fast 提供了保持正轨所需的一切。
- **边缘情况枚举**：始终列出棘手的情况。该模型会将它们纳入测试和防护中。
- **复杂度目标**：要求 O(n) 或内存限制会促使更好的算法。
- **API 约定**：尽早粘贴类型/接口；该模型将与它们对齐。
- **输出约定**：首先请求最终代码，然后请求理由。这使响应保持干净，以便复制/粘贴。
---
## 风格指南和一致性：使其团队就绪
如果您希望团队获得一致的输出，请标准化：
- **语言风格指南**：PEP8、Effective Go、Airbnb JS、Rust API Guidelines。
- **错误约定**：return vs throw、错误代码、重试语义。
- **测试规范**：命名、fixture 目录、覆盖率阈值。
- **安全默认值**：输入验证、转义、密钥处理。
将这些作为常量包含在您的模板中，以便 Grok 4 Fast 每次都将其内化。
---
## 安全优先的提示，确保代码安全
将这些安全条款添加到您的模板中：
- **输入验证**：“验证并清理所有不受信任的输入。”
- **密钥卫生**：“代码中没有密钥。从 env 读取并记录所需的变量。”
- **依赖关系审查**：“解释并证明任何新依赖关系的合理性；首选标准库。”
- **序列化安全**：“使用安全解析器；避免 eval/Function/不安全的反序列化。”
- **AuthZ 检查**：“在敏感路由上强制执行授权；为绕过尝试添加测试。”
---
## 性能提示：避免常见的 Footguns
- “最小化分配；在大型有效负载时重用缓冲区。”
- “避免 N+1 查询；批量或预取。”
- “对大数据使用流/迭代器。”
- “记忆纯函数；分析热点。”
- “添加基准并解释权衡。”
---
## 您可以粘贴到 PR 中的审查清单
包含一个简短的清单，以便每次审查都保持一致：
- API 兼容性已确认
- Null/undefined 和空集合处理
- 资源清理（文件、套接字、订阅）
- 并发防护（锁、原子、幂等性）
- 日志级别适当；没有敏感数据
- 测试已更新；迁移已记录
---
## 团队工作流程：使提示模板成为共享资产
- **集中模板**在您的 repo 中（例如，`/.prompts` 目录）。
- 使用代码段或编辑器宏**参数化**变量，如 `{LANGUAGE}`、`{STYLE_GUIDE}`、`{BIG_O}`。
- **版本控制**您的提示模板，并像代码一样审查它们。
- 为功能起草、重构、测试编写和发布检查**创建行动手册**。
顺便说一句，如果您的团队更喜欢一个并排编码的 copilot，它可以驻留在浏览器和文档中，那么值得注意的是，[Sider.ai](https://sider.ai/) 可以帮助您存储和重用提示模板，在 diff 上运行代码审查，并在选项卡之间保持上下文。这是一种方便的方式，可以在您的组织中实施这些 Grok 4 Fast 提示，而无需复制/粘贴的疲劳。
---
## 复制粘贴库：随时可用的提示
### TypeScript API 处理程序 (Node/Express)

### Python 数据管道步骤

### Go 并发防护

### React 可访问组件

---
## 如何通过 Grok 4 Fast 快速迭代（紧密反馈循环）
1) **从小处着手**：只要求一个函数，而不是整个服务。
2) **约束输出**：“一个代码块，然后是项目符号列表。”
3) **要求测试**：每个功能都在同一轮中进行测试。
4) **确定决策**：“解释权衡。如果不确定，请提出澄清问题。”
5) **逐步改进**：分层改进——首先是正确性，然后是性能，然后是可读性。
---
## 衡量成功：模板是否有帮助？
跟踪简单的指标：
- PR 周期时间（创建 → 合并）
- Review 重做率（每个 PR 请求的更改）
- 每个功能的测试覆盖率增量
- 与 AI 审查的代码相关的生产事故
如果数字朝着正确的方向发展，则加倍投入。如果不是，请调整您的模板并包含更多上下文（类型、日志、差异）。
---
## 要避免的常见错误
- 过于宽泛的提示，例如“构建后端”。将其拆分为单元。
- 忘记边缘情况。始终列出它们。
- 允许库蔓延。要求提供理由。
- “稍后”跳过测试。将它们嵌入到提示中。
- 接受模糊的审查。要求提供清单和严重程度级别。
---
## 快速入门清单
- 在您的存储库中创建一个 `/prompts` 文件夹。
- 保存起草、审查和测试模板。
- 使用代码片段变量参数化常用字段。
- 本周在一个功能上进行试点；衡量结果。
- 根据审查者的反馈和事故进行迭代。
---
## 最终总结
Grok 4 Fast 非常擅长快速生成代码，但真正的力量来自结构良好的提示模板，这些模板编码了您的标准。像对待基础设施一样对待提示。对它们进行版本控制。审查它们。让 Grok 4 Fast 处理样板代码，以便您的团队可以专注于架构和产品。
下一步：选择上面的一个模板，将其粘贴到您的编辑器中，替换为您的上下文，然后立即提交 PR。
### 常见问题解答
Q1: 如何使用 Grok 4 Fast 进行代码起草，并保持一致的风格？
使用结构化的提示模板，该模板设置角色、目标、约束和样式指南。包括复杂性目标、边缘情况和可交付成果，以便 Grok 4 Fast 输出一致的、可用于生产的代码。
Q2: Grok 4 Fast 可以使用提示模板进行可靠的代码审查吗？
是的。提供差异、您团队的标准以及安全、性能和 API 兼容性的检查表。要求提供按严重程度排序的发现和最小的补丁建议。
Q3: 使用 Grok 4 Fast 生成测试的最佳方法是什么？
使用测试生成模板，指定框架、覆盖率目标和边缘情况。请求单元测试和基于属性的测试，以及简要的覆盖率计划。
Q4: 如何防止 AI 输出不安全的代码？
在您的提示中添加安全条款：输入验证、密钥卫生、依赖项理由和安全序列化。要求对安全权衡进行明确说明。
Q5: 提示模板如何使用 Grok 4 Fast 加速 PR 周期？
模板减少了歧义，标准化了输出，并预先加载了测试和审查。这缩短了来回时间，降低了重做率，并帮助您更快地合并。