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

docs/模块完成度审计.md

@@ -159,15 +159,18 @@
   - `WorkflowWorkspaceController`
 - 前端工作台聚合使用 `GET /api/workflow-workspace/detail`；
   旧管理接口继续承担定义、版本与运行管理能力。
-
-说明：
-
-- 前端实现文档中的 REST 草案与当前聚合接口命名不完全一致，但职责已由 `WorkflowWorkspaceController` 承接，且不影响旧接口兼容。
+- 文档草案兼容路径已补充：
+  - `GET /api/workflows/{workflowId}`
+  - `POST /api/workflows/save-draft`
+  - `POST /api/workflow-versions/compat/workflows/{workflowId}/publish`
+  - `POST /api/workflow-runs/compat/workflows/{workflowId}/runs`
+  - `GET /api/workflow-runs/compat/workflows/runs/{runId}`
 
 证据：
 
 - 代码：`common-agent-workflow/src/main/java/com/bruce/workflow/**/*`
 - 测试：
+  - `common-agent-workflow/src/test/java/com/bruce/workflow/controller/WorkflowCompatControllerTests.java`
   - `common-agent-workflow/src/test/java/com/bruce/workflow/controller/WorkflowWorkspaceControllerTests.java`
   - `common-agent-workflow/src/test/java/com/bruce/workflow/workspace/WorkflowWorkspaceServiceTests.java`
   - `common-agent-workflow/src/test/java/com/bruce/workflow/version/WorkflowVersionServiceTests.java`
@@ -183,6 +186,7 @@
 - 接口已覆盖：
   - `POST /api/mcp/import`
   - `GET /api/mcp/servers`
+  - `POST /api/mcp/servers/query`
   - `GET /api/mcp/servers/{serverId}/capabilities`
   - `GET /api/mcp/servers/code/{serverCode}/capabilities`
   - `POST /api/mcp/capabilities/save`
@@ -206,6 +210,7 @@
 - 工作台接口已覆盖：
   - `GET /api/skills/{skillCode}`
   - `POST /api/skills/{skillCode}/draft`
+  - `PUT /api/skills/{skillCode}/draft`
   - `POST /api/skills/{skillCode}/test`
   - `POST /api/skills/{skillCode}/publish`
   - `POST /api/skills/{skillCode}/archive`
@@ -262,10 +267,29 @@
   - `frontend/src/pages/studio/__tests__/*`
   - `frontend/src/api/__tests__/*`
 
+## 4.1 文档草案路径兼容收口
+
+为减少“文档草案路径”和“现有聚合接口路径”之间的偏差，当前已额外补齐以下兼容入口：
+
+- Workflow：
+  - `GET /api/workflows/{workflowId}`
+  - `POST /api/workflows/save-draft`
+  - `POST /api/workflow-versions/compat/workflows/{workflowId}/publish`
+  - `POST /api/workflow-runs/compat/workflows/{workflowId}/runs`
+  - `GET /api/workflow-runs/compat/workflows/runs/{runId}`
+- Agent：
+  - `POST /api/agents/{agentId}/runs`
+  - `GET /api/agent-sessions/agents/{agentId}/sessions`
+  - `GET /api/agent-sessions/{sessionId}`
+- MCP：
+  - `POST /api/mcp/servers/query`
+- Skill：
+  - `PUT /api/skills/{skillCode}/draft`
+
 ## 5. 当前仍需持续关注的风险
 
 - 当前多数“mapper / repository 验证”仍以结构契约测试为主，真实数据库集成测试覆盖度有限。
-- 部分前端实现文档中的接口命名是草案，当前实现更多采用“旧管理接口 + Studio 聚合接口”的双轨方式；职责已覆盖，但验收时需要按“能力是否已落地”而非“路径字面一致”判断。
+- 当前实现仍保留“旧管理接口 + Studio 聚合接口 + 文档草案兼容路径”的三轨并行方式，能力已覆盖，但后续如进入正式 API 收敛阶段，仍建议选定长期主路径并逐步淘汰别名。
 - 现有运行链路以“主数据优先 + 最小可运行”实现为主，复杂分支调度、远程 MCP 实时执行编排、重型运行器能力仍适合后续继续增强。
 
 ## 6. 本次审计后的新增变更
@@ -273,3 +297,4 @@
 - 新增 `POST /api/knowledge/ingestion-runs`，补齐前端实现文档中的摄取运行创建入口。
 - 补充 `IngestionRunControllerTests` 与前端 `ingestion.spec.ts` 创建接口测试。
 - 补充 `WorkflowWorkspaceController` 中文注释与标准化业务日志。
+- 补充 Workflow / Agent / MCP / Skill 的文档草案兼容路径与控制器测试。