ai-agentic-workflow

ai-agentic-workflow

对于每项非平凡任务，都遵循结构化的三阶段工作流——分析、规划、执行——以确保结果准确且经过充分推理。

适用场景

在以下情况下使用此技能：

• 收到需要多个步骤才能完成的任务
• 请求涉及多个文件、组件或概念
• 问题含糊不清，需要先澄清再采取行动
• 如果未充分了解上下文就采取行动，可能会导致失败

对于简单请求（例如“重命名此变量”“修复此拼写错误”），不要使用此工作流，直接处理即可。

说明

阶段 1：分析

在提出任何解决方案之前，先全面理解问题。

1. 仔细阅读请求。 明确用户提出的要求，以及用户可能有所期待但未明确说明的内容。
2. 收集上下文。 检查代码库中的相关文件、依赖项和现有模式。不要猜测——使用工具验证假设。
3. 识别约束。 留意技术选型、架构模式、编码规范，以及适用的任何相关技能。
4. 消除歧义。 如果请求存在多种合理解释，且无法根据上下文判断哪种正确，请提出一个重点明确的问题。否则，采用最合理的解释继续，并说明你的假设。
5. 总结发现。 生成简短的内部摘要：
   • 需要更改的内容
   • 现有的相关内容
   • 必须遵守的约束或模式
   • 存在的风险或边缘情况

阶段 2：规划

在编写任何代码之前，先设计解决方案。

1. 将任务分解为独立步骤。 每个步骤都应能单独验证。
2. 根据依赖关系安排步骤顺序。 先处理基础工作（类型、接口、模型），再实现依赖这些内容的功能。
3. 确定受影响的文件。 列出所有将要创建或修改的文件。
4. 考虑副作用。 此更改是否会破坏现有测试、导入或集成？为此做好规划。
5. 选择最精简的方案。 优先采用能够完全满足请求的最小更改。除非用户明确要求，否则不要重构无关代码。
6. 展示计划。 输出简洁的编号清单，列出将要执行的事项。如果任务规模较大或风险较高，请暂停并等待用户确认后再执行。对于较小的任务，立即继续。

阶段 3：执行

逐步实施计划。

1. 按计划顺序执行。 不要跳过步骤，也不要在执行中途更改方案而不重新规划。
2. 一次实施一项逻辑更改。 完整完成每个步骤后，再进行下一步。
3. 边做边验证。 每次完成重要更改后：
   • 检查修改过的文件中是否存在错误。
   • 如果有相关测试或构建命令，则运行这些命令。
   • 在上下文中验证更改是否有效（导入能否解析、类型是否一致、逻辑流程是否正确）。
4. 处理意外问题。 如果某个步骤失败或暴露出问题：
   • 停下来，重新分析具体问题。
   • 必要时调整剩余计划。
   • 除非别无更好的选择，否则不要用权宜之计强行绕过错误。
5. 确认完成。 完成所有步骤后，验证整体解决方案：
   • 清单中的所有事项均已完成
   • 未引入错误或回归问题
   • 已完全满足原始请求

应用各阶段

任务复杂度	分析	规划	执行
简单（单一且明确的操作）	跳过	跳过	直接处理
小型（2–5 个步骤，路径明确）	简要建立思路	内联清单	立即执行
中型（涉及多个文件，存在一定歧义）	充分收集上下文	明确的编号计划	逐步执行并验证
大型（跨领域、涉及架构）	深入探索，有疑问时提出问题	详细计划，等待确认	分阶段执行并设置检查点

应避免的反模式

• 尚未理解就开始编写代码。 完成分析之前，切勿编辑文件。
• 脱离上下文制定计划。 基于假设而非已核实事实制定的计划注定会失败。
• 悄悄偏离计划。 如果需要改变方向，请说明原因并重新规划。
• 过度设计。 实现所要求的内容，而不是那些将来或许会用到的功能。
• 执行不完整。 不要做到“基本完成”就停下——完成所有步骤，包括验证。