前言：AI时代，我们该如何与AI Coding协作？

随着AI技术在软件开发领域的快速发展，AI Coding作为一款强大的AI辅助开发工具，正在深刻改变着我们的开发模式。然而，在实际应用过程中，许多开发人员在早期使用这类工具时存在一些认知误区，影响了工具效能的最大化发挥。

误区一：过分依赖最终输出，忽视实现过程许多开发者认为有了AI加持后，可以不去详细了解功能和实现的过程，只关注最终的输出。这是一个非常大的误区。AI在后台开发中的输出过程存在非常大的不确定性。误区二：把AI当作具有丰富业务经验的专家另一个常见误区是把AI当成了和自己一样有着丰富所在业务方向经验的人，提示词写得过于简单。然而，受限于上下文长度，AI其实更像是一个有着丰富编程经验的编程高手，但他最缺乏的是思路。

本文档基于在AI Coding应用中的实践经验，旨在为后端开发人员提供系统性的使用指导。通过本次分享，开发者将重点掌握以下两个核心能力：

• 在AI Coding之外构建有效的个人上下文管理体系。
• 准确判断AI输出质量，确保代码实现的正确性。

我们期望通过本次分享，帮助开发者在享受AI带来效率提升的同时，能够保持对代码质量和需求理解的精准把控，真正实现人机协同的高效开发模式。

一、破解AI上下文限制——个人上下文管理

1.1 为什么AI上下文管理如此重要？

在AI Coding的实际应用中，我们发现有效的个人上下文管理是提升AI辅助开发效率的关键因素之一。这主要基于以下几个方面的考虑：

• AI Coding上下文长度限制：AI工具的上下文窗口有限，如何在有限空间内传递最有价值的信息成为关键挑战。
• 有效利用上下文空间的重要性：合理分配和利用上下文空间，能够显著提升AI输出的准确性和相关性。
• 个人上下文管理的价值：通过结构化的上下文管理，开发者能够在复杂项目中保持思路清晰，确保开发过程的连贯性。

1.2 上下文管理三步法

1.2.1 需求理解与文件筛选

在启动AI辅助开发之前，系统性的需求理解和文件筛选是必不可少的准备工作：

• 如何从需求中提取关键信息，明确核心功能点和约束条件；
• 识别代码仓库中相关文件，了解现有实现和架构设计；
• 建立需求与代码的映射关系，为后续提示词设计提供依据；
  

1.2.2 .md文档的创建与维护

.md文档作为上下文管理的核心载体，其创建和维护需要遵循一定的规范：

• 创建需求上下文文档，系统性记录关键信息和设计思路；
• 持续更新和完善文档内容，保持信息的时效性和准确性；
• 遵循文档结构的最佳实践，确保信息的可读性和可维护性；

1.2.3 跨会话记忆传递

在需要开启新会话时，如何有效传递和恢复上下文信息是保证开发连贯性的关键：

• 新会话中如何快速恢复上下文，减少重复工作；
• 文档阅读与上下文重建的策略和技巧；
• 上下文更新与迭代的最佳实践；
  

注：将1.2.2产生的.md文件跨会话引用，节省大量重复阅读所消耗的token。

1.3 实战技巧：让上下文管理事半功倍

基于在多个项目中的实践经验，我们总结了以下关键技巧：

• 关键信息提炼方法：用结构化的方式记录核心要点，提高信息传递效率；
• 文档组织结构建议：按照逻辑关系和重要性组织文档内容，便于快速查找；
• 版本控制与变更追踪：通过版本管理机制追踪文档变更历史，确保信息一致性；
• 分步骤保存：像输出代码仓库整体架构的文档会阅读大量文件，需要定义阶段，并分阶段进行保存，防止一次阅读过多，导致的上下文压缩后的记忆丢失问题。

二、成为AI的"质量把关人"——输出准确性判断

2.1 重新认识AI的能力边界

在AI辅助开发实践中，准确理解AI的能力边界是确保开发质量的前提。基于实践经验，我们需要重新审视以下几个关键认知：

• "模糊的输入，混乱的输出"的现实：AI输出质量与输入质量密切相关，精心设计的提示词和上下文信息是获得高质量输出的基础。
• AI在代码生成中的优势与局限：AI在模板代码生成、常见模式实现等方面具有显著优势，但在复杂业务逻辑处理、架构设计决策等方面仍存在局限性。
• 祛魅：AI是辅助工具而非替代品：AI应当被视为提升开发效率的有力工具，而非完全替代开发者思考和判断的自动化系统。

2.2 需求理解：判断AI输出准确性的基石

2.2.1 需求分析方法

准确的需求理解是判断AI输出是否符合预期的基础，这要求开发者具备以下能力：

• 如何深入理解业务需求，识别核心功能点和约束条件；
• 技术需求与业务需求的关联分析，确保技术实现与业务目标一致；
• 需求变更的识别与处理机制，及时调整开发方向；

2.2.2 代码仓库理解

对现有代码仓库的深入理解是判断AI输出准确性的关键参考：

• 项目架构与模块划分的理解，确保新代码与现有架构保持一致；
• 核心领域模型识别，避免重复造轮子或破坏现有设计；
• 关键接口与数据流理解，确保新功能与现有系统良好集成；

2.3 建立AI输出判断体系

2.3.1 判断标准建立

建立系统性的判断标准是确保AI输出质量的关键：

• 功能正确性验证（结果）：检查AI生成的代码是否正确实现了预期功能；
• 代码质量评估（过程）：从可读性、可维护性、性能等方面评估代码质量；
• 性能与安全性考量（影响范围）：识别潜在的性能瓶颈和安全风险；

2.3.2 常见错误识别

在实际应用中，我们总结了以下常见的AI输出问题类型：

• 逻辑错误识别方法：通过边界条件测试、异常路径验证等方式识别逻辑缺陷；
• 代码规范问题检查：确保生成代码符合团队编码规范和最佳实践；
• 潜在风险点分析：识别可能影响系统稳定性或安全性的风险因素；

2.3.3 反馈与迭代机制

建立有效的反馈和迭代机制能够持续提升AI输出质量：

• 与AI的交互式优化策略，通过多轮对话逐步完善输出（结合1.2 上下文管理方法论）；
• 结果验证与确认流程，确保修改后的输出符合预期。

2.4 从编码者到架构师：思维模式的升级

通过AI辅助开发的实践，我们发现开发者需要实现从单纯编码向全局思考的思维转变：

• 全局视角的重要性：不仅关注代码实现，更要关注系统架构、业务逻辑、用户体验等多维度因素；
• 需求、技术、团队的综合考量：在开发过程中需要平衡业务需求、技术实现等多重因素。

三、AI Coding核心使用流程实战

3.1 后台项目开发标准化流程

3.1.1 PRD理解与系统分析

基于实践经验，我们推荐采用以下标准化流程进行PRD理解与系统分析：

该流程的具体实施要点如下：

• 输入PRD文件：将产品的PRD文档作为输入提供给AI Coding，确保文档内容完整、需求明确。在实际操作中，建议对PRD进行结构化处理，提取关键信息点。
• 人工介入分析：开发人员首先需通过经验/AI Coding分析当前代码仓库，识别三类内容：
• 可复用的现有代码模块：识别可直接复用或稍作调整即可使用的现有功能；
• 需要新增的功能模块：明确需要从零开始开发的新功能点；
• 需要调整的现有功能：识别需要修改或扩展的现有功能模块；
• 生成开发概要：将PRD、代码分析结果和人工理解一并提供给AI Coding，要求AI Coding结合这些信息生成开发概要或大纲。此阶段建议采用分步骤渐进式方式，避免一次性处理过多信息。
• 审核与指正：人工审核生成的开发概要，对不正确或不完善的部分进行指正，重复此过程直到产出准确的系统分析文档。审核时应重点关注架构设计的合理性、技术选型的恰当性等关键点。

3.1.2 代码开发与迭代

代码开发阶段建议采用以下迭代式开发流程：

该流程的实施要点包括：

• 会话管理：建议开启新的会话进行代码开发，新会话直接读取第一阶段产出的.md文件以获取上下文。这样既能保持会话的清晰性，又能有效传承关键信息。
• 开发准备：指定代码开发的目标目录，提供参考代码以帮助AI Coding理解项目结构。参考代码应包含项目中典型的代码模式和架构规范。
• 代码开发与版本管理：AI Coding根据系分文档进行代码生成，重要的版本管理策略：
• 及时提交可用版本：确保每个可运行的版本都能及时提交，便于回溯和协作
• 避免积累过多修改：防止大量修改积压导致问题定位困难
• 防止多轮修改后难以回退：通过合理的版本控制策略确保能够快速回退到稳定状态
• 功能验证与迭代：对生成的代码进行功能验证，发现问题时及时提出并要求修改，完善相关文档内容，循环执行此过程直到满足所有需求。验证应包括单元测试、集成测试等多个层次。
• 上下文管理：当上下文不足时，开启新的会话，新会话直接阅读.md文件以补全上下文。通过文档化管理确保上下文信息的完整性和一致性。

3.1.3 最佳实践建议

基于多个项目的实践经验，我们总结了以下关键建议：

• 分阶段处理：严格区分PRD理解和代码开发两个阶段，每个阶段都有明确的输入和产出。这种分阶段处理方式有助于降低复杂度，提高处理效率。
• 文档驱动开发：以.md文件作为核心文档进行开发指导，确保文档与代码保持同步更新。文档不仅是信息载体，更是开发过程的重要指导工具。
• 版本控制：频繁提交，避免大量积压修改，便于问题追踪和版本回退。建议采用语义化的提交信息，便于理解每次修改的内容和目的。
• 会话管理：合理使用新会话避免上下文混乱，利用文档快速恢复上下文。在复杂项目中，良好的会话管理策略能够显著提升开发效率。

3.2 Python脚本协助数据处理

3.2.1 应用场景

在日常开发工作中，除了核心的代码开发任务，我们还会遇到大量重复性的脚本工作，如数据处理（csv转json《合并技能评估提示词》）、批量操作（国际化信息数据录入《多语言》、sql脚本数据迁移）等。通过合理运用AI Coding结合Python脚本，能够显著提升这类任务的处理效率和质量。

典型的应用场景包括但不限于：

• 批量数据清洗和转换
• 系统配置文件的自动化生成
• 日志文件的分析和统计
• 测试数据的批量生成
• 系统状态监控和报告生成

*注：由大模型底层架构决定了，模型本身就非常适合做寻找规律的事情，所以使用脚本来协助我们梳理日常的业务数据、寻找规律、提取内容都是非常适合的。

3.2.2 实现思路

基于实践经验，我们推荐采用以下标准化流程来实现Python脚本辅助的数据处理任务：

该流程的具体实施步骤如下：

1. 准备阶段：

• 收集处理所需的数据源信息，明确数据格式和结构
• 定义清晰的处理逻辑和输出格式要求

2. AI Coding处理阶段：

• 将处理需求和数据格式提供给AI Coding
• 利用AI Coding生成处理脚本的框架和核心逻辑

3. Python脚本执行阶段：

• 结合生成的框架代码和实际需求编写Python脚本
• 通过配置文件管理参数，实现自动化执行

4. 效果验证：

• 对处理结果进行校验，确保数据准确性和完整性
• 对比处理前后的性能指标，评估优化效果
• 建立处理过程监控机制，及时发现和处理异常

3.2.3 成果收益

通过采用上述方法，我们观察到以下显著收益：

1. 效率提升：相比手工处理，自动化脚本能够大幅缩短处理问题的时间；

2. 质量保障：自动化处理有效避免了手工操作中常见的错误；

3. 可复用性：标准化的脚本结构可轻松复用于其他类似处理任务，降低重复开发成本；

3.2.4 最佳实践建议

基于多个项目的实践经验，我们总结了以下关键建议：

• 标准化输入：统一数据格式要求，规范配置文件格式，确保脚本的通用性和可维护性
• 模块化设计：将不同处理逻辑封装为独立模块，使脚本结构清晰，便于维护和扩展
• 自动化程度：尽可能减少人工干预环节，提供详细的日志记录和监控信息，便于问题追踪
• 可扩展性：在设计时考虑支持更多数据类型的处理能力，确保脚本的长期可用性

3.3 Agent应用与提示词工程

3.3.1 应用场景

在面对较为复杂的Agent应用开发时，提示词工程和工作流设计变得至关重要。通过合理运用AI Coding作为辅助工具，开发者能够更高效地整理思路、设计提示词和工作流，从而显著提升Agent应用的开发效率和质量。

典型的应用场景包括：

• 智能客服系统：处理用户咨询和技术支持请求
• 业务流程自动化：实现复杂业务逻辑的自动化处理
• 数据分析助手：提供智能化的数据洞察和报告生成
• 代码审查助手：辅助进行代码质量检查和优化建议

3.3.2 开发流程

基于在多个Agent项目中的实践经验，我们推荐采用以下标准化开发流程：

该流程的具体实施要点如下：

1. 需求分析阶段：

• 应用背景定义：明确Agent应用的具体场景和目标，确保与业务需求对齐；
• 服务人群识别：确定应用面向的用户群体及其特点，为用户体验设计提供依据；
• 输入格式规范：定义用户输入的数据格式和类型，确保输入处理的准确性；
• 输出格式要求：明确应用需要返回的结果格式，保证输出的一致性和可用性；
• 复杂度评估：判断是否需要分布式处理或工作流设计，为技术选型提供指导；

2. 技术方案设计：

• 将上述需求信息提供给AI Coding；
• 要求AI Coding整理出完整的技术方案；
• 方案应包含：架构设计、模块划分、数据流设计、错误处理机制等关键要素；

3. 提示词工程：

• 单LLM场景：利用AI Coding生成针对性的提示词文本；
• 多LLM工作流场景：通过AI Coding生成一整套提示词体系；
• 提示词应包含：角色定义、任务描述、输出格式约束、示例输入输出等关键要素；

4. Agent平台搭建：

• 将生成的技术方案和提示词在Agent平台实现；
• 搭建完整的应用流程；
• 配置必要的参数和环境；

5. 验证与优化：

• 功能验证：全面测试Agent应用的各项功能；
• 性能测试：评估应用的响应速度和准确性；
• 问题反馈：将验证中发现的问题返回给AI Coding；
• 迭代优化：基于反馈优化提示词和流程设计；
• 重复此过程直到符合预期效果；

*注：通过AI Coding对工作的编排能力，协助我们完成一些复杂的agent提示词构建，可以快速的论证一些agent方案的可行性，并且是后续的调整成本更低，也更加灵活。

3.4 文档整理与输出

3.4.1 应用场景

在日常工作中，我们经常需要整理和输出各类文档，包括但不限于工作汇报、系统设计文档、技术方案等。通过合理运用AI Coding作为文档辅助工具，能够帮助我们快速生成结构化、高质量的文档，显著提升文档编写效率。

典型的应用场景包括：

• 项目进展汇报：周报、月报、季度总结等；
• 系统设计文档：架构设计、模块设计、接口设计等；
• 技术方案文档：技术选型、实现方案、风险评估等；
• 知识沉淀文档：最佳实践、经验总结、技术分享等；

3.4.2 工作流程

基于实践经验，我们推荐采用以下标准化流程进行文档整理与输出：

该流程的具体实施要点如下：

1. 需求输入阶段：

• 文档大纲：提供文档的整体框架和章节划分，确保结构清晰；
• 重点内容：明确哪些部分需要详细描述，哪些部分可以由AI Coding发散；
• 结构要求：定义文档的组织方式和逻辑关系，保证内容连贯性；
• 图文形式：指定需要使用的图表类型（如mermaid、plantuml等），提升文档可读性；

2. AI Coding处理阶段：

• 将用户提供的要求和大纲输入AI Coding；
• 对于重点内容，提供详细指导以确保准确性；
• 对于非重点内容，允许AI Coding进行合理发散以提升效率；
• 生成包含文字和图表的完整文档内容；

3. 文档产出阶段：

• 以.md格式输出文档，确保格式兼容性；
• 确保文档结构清晰、内容完整，符合预期要求；
• 包含必要的图表和代码示例，提升文档实用性；

4. 平台转换与验证：

• 将.md文档粘贴到协作平台，实现团队共享；
• 利用平台的自动格式转换功能，确保显示效果；
• 检查转换后的文档结构是否符合预期，及时调整；

5. 迭代优化：

• 如结构不符合预期，将问题反馈给AI Coding；
• 调整文档结构或内容表达方式；
• 重新生成直到满足要求；

注：文档整理和输出具有天然的跨会话记忆管理的优势，因为每次对话都会整理内容到.md文档中，很适合作为夸回话记忆管理的入门实践。

3.4.3 实际应用

日常工作汇报：

1. 输入要求：

• 汇报周期：周报/月报
• 重点内容：项目进展、遇到的问题、解决方案
• 结构：工作概述、详细进展、问题与风险、下周计划

2. AI Coding处理：

• 根据项目管理系统自动整理工作进展
• 结合历史记录生成问题分析
• 提出合理的下一步计划建议

3. 产出效果：

• 从2小时的手工整理缩短到30分钟
• 文档结构统一，便于上级审阅
• 内容完整，不会遗漏重要信息

系统设计文档：

1. 结合代码仓库：

• 基于第一阶段生成的系统分析文档
• 结合实际代码结构进行详细设计
• 自动生成模块间关系图

2. 内容生成：

• 架构设计说明
• 模块详细设计
• 接口定义
• 数据库设计
• 部署方案

3. 图表支持：

• 使用mermaid生成架构图
• 使用plantuml生成时序图
• 使用其他图表工具生成流程图

3.4.4 支持的图表类型

1. Mermaid

• 流程图：用于展示业务流程、系统架构等

• 时序图：用于展示系统组件间的交互时序

• 类图：用于展示系统中的类及其关系

• 状态图：用于展示对象的状态变化

• 甘特图：用于项目进度管理

2. PlantUML

• 用例图：用于展示系统功能和用户关系

• 活动图：用于展示业务流程的活动

• 组件图：用于展示系统组件结构

• 部署图：用于展示系统部署架构

• 数据库ER图：用于展示数据库表结构和关系

3. 其他图表

• 表格：用于展示结构化数据

• 代码块：用于展示代码示例

publicclassUserService {
  public User getUserById(Long id){
    // 查询用户逻辑
    return userRepository.findById(id);
  }
  
  public List<User> getAllUsers(){
    // 获取所有用户
    return userRepository.findAll();
  }
}

3.4.5 最佳实践建议

基于多个项目的实践经验，我们总结了以下关键建议：

• 明确分工：重要内容由人工提供详细指导，次要内容可由AI Coding合理发散，保持人工审核关键内容；
• 结构优先：先确定文档结构再填充内容，使用标准模板提高效率，保持章节间逻辑关系清晰；
• 图表规范：统一图表风格和配色，为图表添加必要的说明文字，确保图表与文字内容一致；
• 版本管理：保留文档的多个版本，记录每次修改的内容和原因，建立文档审核流程；
• 平台适配：了解目标平台的格式支持情况，测试文档转换效果，建立标准化的转换流程。

3.5 提示词沉淀与最佳实践平台

在使用AI Coding进行开发的过程中，我们会积累大量的提示词和最佳实践流程。为了更好地管理和复用这些知识资产，建议使用专门的知识管理平台来沉淀和优化我们的提示词。

1. 提示词模板管理

• 创建和管理各种场景下的提示词模板，支持分类管理；
• 支持新功能开发、BUG修复、接口文档编写、系分文档编写等常见场景；
• 提供版本控制和变更历史追踪，确保知识资产的可追溯性；

2. 最佳实践沉淀

• 将成功的开发流程和方法论沉淀为可复用的最佳实践；
• 建立标准化的开发流程模板，提升团队整体效率；
• 支持团队间的经验分享和学习，促进知识传播；

3. 持续优化机制

• 基于实际使用效果对提示词进行调优，确保持续改进；
• 收集用户反馈，不断改进提示词质量；
• 建立A/B测试机制，科学验证不同提示词的效果；

3.5.1 应用场景

1. 新功能开发

• 沉淀新功能开发的标准提示词模板，确保开发一致性；
• 建立从需求分析到代码实现的完整流程，提升开发效率；
• 确保新功能开发的一致性和质量，降低沟通成本；

2. BUG修复

• 建立BUG分析和修复的标准提示词，提升问题解决效率；
• 沉淀常见问题的解决模式，形成问题解决知识库；
• 提高BUG修复效率和质量，减少重复劳动；

3. 文档编写

• 固化接口文档、系分文档等各类文档的编写规范；
• 提供文档结构和内容的标准模板，确保文档质量；
• 确保文档质量和一致性，提升知识传递效果；

3.5.2 使用建议

基于团队在多个项目中的实践经验，我们总结了以下关键建议：

1. 及时沉淀

• 在完成重要开发任务后，及时将有效的提示词和流程沉淀到平台；
• 记录使用场景和效果，便于他人理解和复用；

2. 持续优化

• 定期回顾和优化已有的提示词模板；
• 根据实际使用反馈进行调整和改进；
• 跟踪提示词效果，不断提升质量；

3. 团队协作

• 鼓励团队成员共享优秀的提示词和实践；
• 建立团队内部的知识分享机制；
• 通过平台实现知识的传承和积累。

总结：成为AI时代的超级开发者

通过本篇文章，希望开发者能够：

1. 建立有效的个人上下文管理体系，在有限的AI上下文空间中发挥最大价值；

2. 具备准确判断AI输出的能力，确保代码质量和功能正确性；

3. 实现从单纯编码向全局思考的思维转变，成为具备超级单兵能力的研发人员；

AI Coding作为强大的辅助工具，其价值的发挥最终还是取决于使用者的需求理解能力和技术判断能力。只有将AI工具与个人能力有效结合，才能真正提升开发效率和质量。

本文档的五个主要部分涵盖了AI Coding在后台开发中的主要应用场景：

1. 个人上下文管理：解决AI上下文限制问题，通过外部文档管理实现上下文传承；

2. AI输出准确性判断：培养开发者对需求和代码仓库的理解能力，以准确判断AI输出质量；

3. AI Coding核心使用流程：从PRD理解到代码开发的完整流程，Python脚本协助数据处理，Agent应用与提示词工程，文档整理与输出；

4. 实践案例与练习：通过具体案例和练习，巩固培训内容，提升实际应用能力；

5. 提示词沉淀与最佳实践。

来源  |  阿里云开发者公众号

作者  |  犁野