feat(compat): 补齐文档草案接口兼容入口

common-agent-skill/src/main/java/com/bruce/skill/controller/SkillWorkspaceController.java

@@ -11,6 +11,7 @@ import lombok.extern.slf4j.Slf4j;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestParam;
@@ -41,6 +42,16 @@ public class SkillWorkspaceController {
         return RequestResult.success(skillVersionService.saveDraft(skillCode, request));
     }
 
+    /**
+     * 兼容前端实现文档中的 PUT 草稿保存路径。
+     */
+    @PutMapping("/{skillCode}/draft")
+    public RequestResult<Boolean> saveDraftCompat(@PathVariable("skillCode") String skillCode,
+                                                  @RequestBody SkillVersionSaveDTO request) {
+        log.info("Skill草稿兼容保存开始，skillCode={}, versionNo={}", skillCode, request.getVersionNo());
+        return RequestResult.success(skillVersionService.saveDraft(skillCode, request));
+    }
+
     @PostMapping("/{skillCode}/test")
     public RequestResult<SkillVersionVO> test(@PathVariable("skillCode") String skillCode,
                                               @RequestBody SkillVersionSaveDTO request) {

common-agent-skill/src/test/java/com/bruce/skill/controller/SkillWorkspaceControllerTests.java

@@ -1,6 +1,7 @@
 package com.bruce.skill.controller;
 
 import com.bruce.common.handler.GlobalExceptionHandler;
+import com.bruce.skill.dto.SkillVersionSaveDTO;
 import com.bruce.skill.service.ISkillVersionService;
 import com.bruce.skill.service.ISkillWorkspaceService;
 import com.bruce.skill.vo.SkillWorkspaceVO;
@@ -15,6 +16,7 @@ import org.springframework.test.web.servlet.setup.MockMvcBuilders;
 
 import static org.mockito.Mockito.when;
 import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
 
@@ -59,4 +61,22 @@ class SkillWorkspaceControllerTests {
                 .andExpect(jsonPath("$.data.skillCode").value("resume_extract"))
                 .andExpect(jsonPath("$.data.status").value("PUBLISHED"));
     }
+
+    @Test
+    void saveDraftCompatShouldReturnSuccess() throws Exception {
+        when(skillVersionService.saveDraft(org.mockito.ArgumentMatchers.eq("resume_extract"),
+                org.mockito.ArgumentMatchers.any(SkillVersionSaveDTO.class))).thenReturn(true);
+
+        mockMvc.perform(put("/api/skills/resume_extract/draft")
+                        .contentType(org.springframework.http.MediaType.APPLICATION_JSON)
+                        .content("""
+                                {
+                                  "versionNo": 2,
+                                  "promptText": "提取候选人经历"
+                                }
+                                """))
+                .andExpect(status().isOk())
+                .andExpect(jsonPath("$.resultcode").value("0"))
+                .andExpect(jsonPath("$.data").value(true));
+    }
 }