SDD开发模式标准工作流与斜杠命令实践

准备工作

在使用华为云码道前，您需要先创建一个项目，用于集中存放工程中的各类文件。项目创建完成后，建议开启自动批准功能，AI将自动处理相关操作，无需人工干预。

1. 参考快速启动中操作，登录华为云码道。
2. 创建一个项目，用于存放工程中的文件。
   1. 在IDE工具顶部菜单栏中，单击“文件(F)”，选择“新建 > 新建项目”，进入新建项目页面。
   2. 选择项目存放位置，输入项目名称（例如SDD_Demo），单击“确定”。

      项目名称必须以字母开头，可包含字母、数字、中划线或下划线，且总长度不能超过64个字符。

      项目创建完成后，在“资源管理器”中可以查看到已创建的SDD_DEMO项目。

3. （可选）选择智能体运行模式并授权自动化操作。
   1. 单击华为云码道IDE右上角的设置图标 ，进入华为云码道IDE全局设置页面。
   2. 在“对话流 > 智能体 > 终端命令运行模式”中，选择智能体执行终端命令的运行策略，本实践使用默认运行策略，即沙箱运行。
   3. 在“对话流 > 智能体 > 自动批准”中，单击 以开启所需的自动批准项目。

      授权自动化操作后，复杂工程级代码生成流程中的各项任务可自动执行。如果您未开启自动化操作授权，在使用华为云码道进行编码时，部分操作将需要您手动确认。

      

      开启自动批准存在操作风险，请在开启前充分评估风险，并在安全可信环境中使用。

      表2 自动批准参数说明

      参数	说明	示例
      编辑	允许智能体调用edit、write、deleteFile等工具来编辑您计算机上的文件。	开启
      使用浏览器	允许智能体在浏览器中访问网站。	开启
      网页抓取工具	允许智能体访问并抓取指定网页的内容。	开启

   4. 退出当前页面，完成授权操作。

标准SDD工作流

标准SDD工作流是华为云码道代码智能体内置的规范驱动模式。用户在聊天界面选择“规范开发 Spec-Driven”后，输入需求描述，智能体会按照预设工作流逐步执行：首先生成需求规格文档spec.md，确认无误后自动进入方案创建，生成design.md，再生成任务清单tasks.md，最后执行编码实现。整个流程由AI自主驱动，用户主要在关键节点进行确认（接受或拒绝生成的文档）。

1. 在聊天界面的输入框下方选择“内置 > 智能体”，切换到智能体模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。
   

   如果没有正常显示华为云码道的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标 ，即可打开华为云码道。

2. 在聊天界面的模式选择中，单击“规范开发”，切换智能体到规范开发模式。
3. 在华为云码道聊天界面的输入框中，输入如下提示词，并单击发送。

   请开发一个用户登录接口，支持用户通过用户名和密码进行身份认证，认证成功后返回JWT令牌，登录失败时记录失败次数，连续失败5次后锁定账号15分钟。

4. 查看生成的需求规格文件spec.md。提出相应的修改意见，华为云码道代码智能体会修改spec.md文件。

   修改以下问题：
   登录成功后除了返回token，还需要返回用户基本信息（昵称、角色）
   锁定时间15分钟太长了，改为5分钟
   补充接口的限流机制，每分钟同一个IP最多请求10次
   响应码不要用200，统一使用业务码20000表示成功

5. 再次查看修改后的spec.md，确认需求理解准确后，单击“开始实现方案创建”。
6. 查看生成的design.md，确认技术方案合理后，单击“开始编码任务规划”。
7. 查看生成的tasks.md，确认任务拆解完整后，单击“开始任务执行”。
8. 等待任务执行完成后，获得完整的代码实现，同时沉淀了spec.md、design.md和tasks.md三份过程文档。

斜杠命令模式

华为云码道代码智能体通过底层Skills封装，统一定义了四个标准化斜杠命令。开发者可以根据已有过程交付件情况，按需调用命令，无需重跑全流程。例如，执行“/sdd-apply”编码中途发现加密库过时，手动修改“design.md”，再依次运行“/sdd-tasks”和“/sdd-apply”。

1. 在聊天界面的输入框下方选择“内置 > 智能体”，切换到智能体模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。
   

   如果没有正常显示华为云码道的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标 ，即可打开华为云码道。

2. 在聊天界面的模式选择中，单击“氛围编程”，切换智能体到氛围编程模式。
3. 按需调用命令完成SDD开发。
   • /sdd-new：创建需求规格。
     1. 在对话框输入“/”，在弹出的菜单中选择“/sdd-new”，输出如下需求描述，生成统一格式的spec.md。

        请帮我开发一个用户注册登录模块，包含手机号/邮箱注册、JWT登录认证、验证码发送、密码重置功能

        

     2. 进入{项目根路径}/.codeartsdoer/specs/产物文件夹目录下，获取生成的spec.md。
        图2 spec.md所在目录
        
     3. 您可基于当前需求规格文档进行评审，评审意见可以通过智能体修改或手动修改spec.md文件，直到需求规格文档符合业务预期。
   • /sdd-design：创建技术设计。

     如果当前您已有spec.md文件，您可直接调用“/sdd-design”，然后输入产物文件夹名称（如图2所示的user_auth），生成包含架构、接口描述的design.md。

     

   • /sdd-tasks：创建编码任务。

     在对话框输入“/”，在弹出的菜单中选择“/sdd-tasks”，然后输入产物文件夹名称（如user_auth），生成可执行的步骤清单tasks.md。

     

   • /sdd-apply：执行编码实现。

     在对话框输入“/”，在弹出的菜单中选择“/sdd-apply”，然后输入产物文件夹名称（如user_auth）。华为云码道代码智能体按tasks.md逐项执行编码任务。

场景选型

在实际的开发中，标准SDD工作流和斜杠命令两种模式并非互斥，而是可以根据不同的项目阶段和团队角色灵活切换。新项目初期使用标准工作流快速跑通框架，建立完整的SDD文档体系。进入中期迭代切换到斜杠命令模式，利用四个命令进行增量开发和局部重构。