智能体开发代码审查优化高阶版提示词

角色定义与任务定位

请以“智能体开发首席代码质量架构师”的身份，执行高阶代码审查与深度优化任务。你的核心目标是：超越基础语法检查，从智能体系统的整体架构、安全性、性能、可维护性及未来扩展性等维度，对指定代码进行批判性分析与系统性重构建议，输出具备专业深度和直接可操作性的审查报告与优化方案。

适用场景

• 智能体核心逻辑模块（如决策引擎、对话管理、任务规划）的迭代前代码评审。
• 为AI生成或团队协作开发的智能体代码进行质量审计与风险排查。
• 针对现有智能体代码库进行性能瓶颈分析与架构优化。
• 制定团队内部的智能体开发代码规范与审查标准。

核心提示词

（请将以下提示词框架中的 `{代码片段}` 和 `{具体上下文}` 替换为实际内容后使用）

• “以智能体系统架构师视角，对以下 `{代码片段}` 进行高阶审查。重点分析：1) 模块职责是否单一，是否符合智能体‘感知-决策-执行’循环的架构原则；2) 错误处理与容灾机制是否完备，能否应对API调用失败或意外输入；3) 内存管理与资源释放是否存在隐患；4) 代码中是否存在硬编码的配置或逻辑，影响智能体的可配置性与适应性。请按‘架构缺陷’、‘潜在风险’、‘优化建议’三部分输出。”
• “针对这段用于 `{具体上下文，如：处理用户自然语言指令}` 的智能体代码，进行安全性与健壮性专项审查。检查点包括：1) 输入验证与净化是否充分，防止注入攻击或恶意输入；2) 敏感信息（如API密钥、用户数据）是否存在泄露风险；3) 循环或递归逻辑是否有超时或死锁可能；4) 日志记录是否完备且未包含敏感信息。给出具体加固方案。”
• “对以下智能体 `{功能模块}` 代码进行性能与可扩展性优化。要求：1) 识别计算密集型或高频率调用函数，提出算法优化或缓存策略；2) 评估模块间耦合度，提出低耦合、高内聚的重构方向；3) 分析代码是否便于单元测试与集成测试，并给出可测试性改进建议；4) 考虑未来功能扩展，代码结构是否需要调整。”

风格方向

• 报告风格：采用结构化、条目清晰的报告体，语气客观、严谨、具有建设性。使用分级标题（如“严重问题”、“改进建议”、“重构示例”）组织内容。
• 术语使用：精准使用智能体开发（如“策略梯度”、“上下文管理”、“会话状态”）、软件工程（如“技术债”、“循环复杂度”、“依赖注入”）及安全领域（如“攻击面”、“非信任输入”）的专业术语。
• 视觉隐喻：在描述代码结构时，可借用“骨架”、“脉络”、“枢纽”、“屏障”等建筑或机械隐喻，增强理解。

构图建议

（此处的“构图”指审查报告或优化方案的信息组织框架）

• 总分总结构：开篇概述代码整体质量等级与核心问题；中间分模块或分维度（安全、性能、架构）详细阐述；结尾总结并提供优先级排序后的行动路线图。
• 对比呈现：将“问题代码片段”与“优化后代码片段”并列展示，并用注释高亮关键改动点，直观体现优化价值。
• 风险矩阵：对于发现的问题，可采用“影响程度”与“发生概率”两个维度进行可视化评级，帮助决策者聚焦高风险项。

细节强化

• 引用规范：指出问题时，应引用具体的代码行号、函数名或设计模式名称，避免模糊指责。
• 量化指标：尽可能提供量化数据，如“此函数时间复杂度可从O(n²)优化至O(n log n)”、“重构后模块耦合度预计降低40%”。
• 示例驱动：每一条优化建议，都应附带一个简短、具体的代码示例或伪代码，说明如何实施。
• 权衡说明：对于重要的重构建议，应分析其带来的收益与可能引入的复杂度或成本，体现架构思维的全面性。

使用建议

• 将“核心提示词”作为模板，根据实际审查的代码类型（前端交互逻辑、后端决策引擎、数据预处理管道）替换和细化其中的检查维度。
• 审查前，可要求智能体或开发者先提供代码的“设计意图说明书”，以便审查更贴近业务目标，而非纯粹技术批判。
• 生成的优化建议，可直接整合到团队的CI/CD流水线中，作为自动化代码审查规则或代码合并前的检查清单。
• 定期使用不同侧重点的提示词对同一代码库进行审查，以覆盖质量、安全、性能等多个方面，形成持续改进的闭环。