docs(ai): converge external wording to AI-assisted + human review, not full-auto

Per the architecture-review redline (EIP3 决策会纪要: AI claims limited to 'AI-assisted, human-reviewed'; never promise 'AI full-auto development'), soften endpoint @Operation summaries, the default task objective, and AI docs that read as committed full-automation. Endpoint paths/method names unchanged (API contract). Added a capability-boundary disclaimer at the top of AI_AGENT_AUTO_DEVELOPMENT.md. 33 platform-ai tests green.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-19 16:39:45 +08:00
parent c379f5b1ea
commit 9aea6c1cd0
5 changed files with 10 additions and 8 deletions

View File

@@ -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 和自动修复;线上变更只输出人工部署包,不连接线上环境执行,须人工复核后发布。
## 本地运行配置

View File

@@ -33,7 +33,7 @@ EIP4 当前已经有实体、页面 schema、服务流、菜单、smoke、部署
## 三、落地顺序
### P0:全自动开发主链路
### P0:AI 辅助开发主链路(人工复核发布)
状态:已完成。

View File

@@ -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`

View File

@@ -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);

View File

@@ -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();