diff --git a/docs/AI_AGENT_AUTO_DEVELOPMENT.md b/docs/AI_AGENT_AUTO_DEVELOPMENT.md index f2b594b..4131f6b 100644 --- a/docs/AI_AGENT_AUTO_DEVELOPMENT.md +++ b/docs/AI_AGENT_AUTO_DEVELOPMENT.md @@ -1,6 +1,8 @@ -# AI Agent 全自动开发运行说明 +# AI Agent 辅助开发运行说明(生成草稿 + 本地验证 + 人工复核发布) -`platform-ai` 的自动开发入口是 `POST /api/ai/features/auto-develop`。它只在本地环境执行草稿生成、本地落库、smoke 和自动修复;线上变更只输出人工部署包,不连接线上环境执行。 +> **能力边界(对外口径,红线)**:本能力是「**AI 辅助生成草稿 + 人工复核发布**」,**不是** AI 全自动开发。当前只覆盖最简单的 CRUD recipe,存量复杂场景未取得数据;按《EIP3架构决策会纪要》红线,**严禁在报价/合同中承诺「AI 全自动开发 / 人力大幅下降」**。线上变更一律输出人工部署包、由人工复核后发布。 + +`platform-ai` 的辅助开发入口是 `POST /api/ai/features/auto-develop`。它只在本地环境执行草稿生成、本地落库、smoke 和自动修复;线上变更只输出人工部署包,不连接线上环境执行,须人工复核后发布。 ## 本地运行配置 diff --git a/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md b/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md index 8dd12a9..d3bf124 100644 --- a/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md +++ b/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md @@ -33,7 +33,7 @@ EIP4 当前已经有实体、页面 schema、服务流、菜单、smoke、部署 ## 三、落地顺序 -### P0:全自动开发主链路 +### P0:AI 辅助开发主链路(人工复核发布) 状态:已完成。 diff --git a/docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md b/docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md index 49d09c4..5d747b0 100644 --- a/docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md +++ b/docs/AI_AGENT_PAGE_BLUEPRINT_CONTRACT.md @@ -28,7 +28,7 @@ AI 可查询入口: 工具注册表中对应工具为 `page-recipe.read`,所需 scope 为 `ai:page-recipe:read`。Agent 生成 PageBlueprint 前应先读取 recipe 定义,再生成草稿。 -AI 自动开发链路中的 `PAGE_SCHEMA` 草稿仍然保存编译后的 amis schema,保持现有落库和前端渲染契约不变;草稿 metadata 额外保存: +AI 辅助开发链路中的 `PAGE_SCHEMA` 草稿仍然保存编译后的 amis schema,保持现有落库和前端渲染契约不变;草稿 metadata 额外保存: - `pageRecipe` - `pageBlueprintVersion` diff --git a/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java b/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java index d91db4e..2236103 100644 --- a/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java +++ b/platform-ai/src/main/java/com/eip4/platform/ai/service/AiAgentService.java @@ -184,7 +184,7 @@ public class AiAgentService { public AiFeatureDevelopment developFeature(AiFeatureRequest request) { String objective = request == null || request.objective() == null || request.objective().isBlank() - ? "AI Agent 自动开发功能" + ? "AI Agent 辅助开发功能" : request.objective(); AiTask task = createTask(objective); return developFeature(task.id(), request); diff --git a/platform-ai/src/main/java/com/eip4/platform/ai/web/AiAgentController.java b/platform-ai/src/main/java/com/eip4/platform/ai/web/AiAgentController.java index f9db18a..67e7d25 100644 --- a/platform-ai/src/main/java/com/eip4/platform/ai/web/AiAgentController.java +++ b/platform-ai/src/main/java/com/eip4/platform/ai/web/AiAgentController.java @@ -79,14 +79,14 @@ public class AiAgentController { return service.createTask(req.objective()); } - @Operation(summary = "自动开发功能草稿", description = "创建任务并生成实体/页面/服务流/菜单/测试草稿,门禁通过后生成待人审变更包") + @Operation(summary = "AI 辅助生成功能草稿", description = "创建任务并生成实体/页面/服务流/菜单/测试草稿,门禁通过后生成待人审变更包(草稿仍需人工复核)") @PostMapping("/features/develop") public AiFeatureDevelopment developFeature(@RequestBody AiFeatureRequest req) { requireAdmin(); return service.developFeature(req); } - @Operation(summary = "一键自动开发功能", description = "生成草稿、变更包、发布计划,执行本地落库和 smoke,并生成线上人工部署包") + @Operation(summary = "AI 辅助一键生成功能(本地验证 + 待人工复核发布)", description = "生成草稿、变更包、发布计划,执行本地落库和 smoke,并生成线上人工部署包;不连接线上执行,线上变更须人工复核发布") @PostMapping("/features/auto-develop") public AiAutoDevelopmentRun autoDevelopFeature(@RequestBody(required = false) AiAutoDevelopmentRequest req) { requireAdmin(); @@ -112,7 +112,7 @@ public class AiAgentController { return service.listDrafts(taskId); } - @Operation(summary = "在既有任务下自动开发功能草稿") + @Operation(summary = "在既有任务下 AI 辅助生成功能草稿") @PostMapping("/tasks/{taskId}/develop-feature") public AiFeatureDevelopment developFeature(@PathVariable String taskId, @RequestBody AiFeatureRequest req) { requireAdmin();