docs(studio): 补全扩展能力与观测设计

后端实现文档/6.MCP能力接入模块后端实现.md

@@ -0,0 +1,20 @@
+# MCP 能力接入模块后端实现
+
+## 1. 包建议
+
+后续实现建议新增 `com.bruce.mcp`，包含 Controller、DTO、Entity、Mapper、Service 和 MCP Client 适配。
+
+## 2. Service 草案
+
+| Service | 职责 |
+|---------|------|
+| `IMcpServerService` | Server 导入、启停用、健康检查 |
+| `IMcpCapabilityService` | 能力发现、保存、启停用 |
+| `IMcpImportService` | 处理 URL、package、Manifest 导入 |
+
+## 3. 校验规则
+
+- Server 编码唯一。
+- 能力编码在 Server 下唯一。
+- 导入方式必须来自枚举。
+- 能力 schema 必须为合法 JSON。

后端实现文档/7.Skill编辑模块后端实现.md

@@ -0,0 +1,20 @@
+# Skill 编辑模块后端实现
+
+## 1. 包建议
+
+后续实现建议新增 `com.bruce.skill`。
+
+## 2. Service 草案
+
+| Service | 职责 |
+|---------|------|
+| `ISkillDefinitionService` | Skill 定义管理 |
+| `ISkillVersionService` | 草稿保存、测试、发布、归档 |
+| `ISkillRunner` | 运行 Skill 并生成测试结果 |
+
+## 3. 校验规则
+
+- Skill 编码唯一。
+- 版本号在 Skill 内唯一。
+- Prompt、Code、Config 至少一种非空。
+- 变量 schema 必须为合法 JSON。

后端实现文档/8.运行观测模块后端实现.md

@@ -0,0 +1,24 @@
+# 运行观测模块后端实现
+
+## 1. 包建议
+
+后续实现可新增 `com.bruce.observability`，也可以先由 Workflow、Agent 和模型模块分别提供查询接口。
+
+## 2. Controller 草案
+
+- `ObservabilityRunController`
+- `ObservabilityModelCallController`
+
+## 3. Service 草案
+
+| Service | 职责 |
+|---------|------|
+| `IObservabilityRunService` | 聚合运行记录 |
+| `IObservabilityTraceService` | 聚合步骤、会话和模型调用 |
+| `IObservabilityExportService` | 导出脱敏日志 |
+
+## 4. 校验规则
+
+- 只允许查询脱敏后的运行摘要。
+- 导出接口必须过滤密钥和完整请求内容。
+- requestId 不存在时返回空结果而不是内部异常。