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

设计文档/6.MCP能力接入模块设计.md

@@ -0,0 +1,26 @@
+# MCP 能力接入模块设计
+
+## 1. 核心模型
+
+| 对象 | 说明 |
+|------|------|
+| MCP Server | 外部能力服务 |
+| MCP Capability | Server 暴露的工具或资源 |
+| Manifest | Server 能力声明 |
+
+## 2. 导入流程
+
+```mermaid
+flowchart LR
+    Input["输入 URL/package/Manifest"] --> Validate["校验连接与声明"]
+    Validate --> Server["写入 mcp_server"]
+    Server --> Capability["写入 mcp_capability"]
+    Capability --> Binding["绑定给 Workflow/Agent"]
+```
+
+## 3. 设计约束
+
+- `secret_ref` 只保存密钥引用，不保存明文密钥。
+- `manifest_json` 保存原始能力声明摘要。
+- `schema_json` 保存单个能力输入输出 schema。
+- Server 停用时，其能力不应被新运行选择。

设计文档/7.Skill编辑模块设计.md

@@ -0,0 +1,23 @@
+# Skill 编辑模块设计
+
+## 1. 核心模型
+
+| 对象 | 说明 |
+|------|------|
+| Skill 定义 | Skill 主数据 |
+| Skill 版本 | Prompt、Code、Config 与测试结果快照 |
+
+## 2. 版本规则
+
+- 草稿版本可编辑。
+- 发布版本不可直接修改。
+- 归档版本仅可查看。
+- Workflow 运行必须引用确定版本。
+
+## 3. 数据设计
+
+- `prompt_text` 保存提示词。
+- `code_text` 保存脚本或函数片段。
+- `config_json` 保存运行配置。
+- `variable_schema_json` 保存输入输出变量定义。
+- `test_result_json` 保存最近测试结果摘要。

设计文档/8.运行观测模块设计.md

@@ -0,0 +1,35 @@
+# 运行观测模块设计
+
+## 1. 观测主键
+
+运行观测以 `request_id` 为主线串联：
+
+- Workflow 运行。
+- Workflow 步骤。
+- Agent 会话。
+- 模型调用日志。
+
+## 2. 展示维度
+
+- 名称。
+- 类型。
+- 状态。
+- 延迟。
+- 成本。
+- 步骤输出。
+- 错误摘要。
+
+## 3. 数据来源
+
+| 来源 | 表 |
+|------|----|
+| 流程运行 | `workflow_run` |
+| 步骤日志 | `workflow_run_step` |
+| 模型调用 | `model_call_log` |
+| Agent 会话 | `agent_session`、`agent_message` |
+
+## 4. 设计约束
+
+- 观测模块只读业务运行数据。
+- 不保存完整 Prompt 或敏感密钥。
+- 错误信息只保存摘要，详细日志由运行环境负责。