feat: 添加 call-specialist-with-log skill，强制记录专精策划调用到多维表格
This commit is contained in:
Game Director
194
skills/call-specialist-with-log/SKILL.md
Normal file
194
skills/call-specialist-with-log/SKILL.md
Normal file
@@ -0,0 +1,194 @@
|
||||
# 调用专精策划并记录 (call-specialist-with-log)
|
||||
|
||||
**用途：** 调用专精策划 agent 并自动记录沟通到飞书多维表格
|
||||
|
||||
**当以下情况时使用此 Skill：**
|
||||
- 游戏策划总监需要调用任何专精策划（market-researcher, system-designer, numerics-designer, narrative-writer, level-designer, combat-designer, monetization-designer, ui-ux-designer）
|
||||
- 需要确保沟通记录被完整保存到飞书多维表格
|
||||
|
||||
---
|
||||
|
||||
## 📋 使用方式
|
||||
|
||||
### 调用步骤
|
||||
|
||||
**1. 调用前准备**
|
||||
|
||||
记录以下信息：
|
||||
- `agentId`: 要调用的专精策划 ID
|
||||
- `taskType`: 任务类型（竞品分析/系统设计/数值设计/叙事设计/关卡设计/战斗设计/商业化设计/UIUX 设计）
|
||||
- `message`: 任务描述内容
|
||||
- `sessionId`: 当前会话 ID（从会话记录中获取）
|
||||
|
||||
**2. 调用专精策划**
|
||||
|
||||
使用 `sessions_send` 工具发送任务：
|
||||
|
||||
```javascript
|
||||
{
|
||||
"action": "sessions_send",
|
||||
"agentId": "<agentId>",
|
||||
"message": "<任务描述>"
|
||||
}
|
||||
```
|
||||
|
||||
**3. 创建多维表格记录（调用时）**
|
||||
|
||||
使用 `feishu_bitable_app_table_record` 创建记录：
|
||||
|
||||
```javascript
|
||||
{
|
||||
"action": "create",
|
||||
"app_token": "Joc4bhUqEa6wJdsmevFc9YVhnH0",
|
||||
"table_id": "tbloPgG6gNmSufOM",
|
||||
"fields": {
|
||||
"调用时间": <当前时间戳>,
|
||||
"调用方": "game-director",
|
||||
"被调用方": "<agentId>",
|
||||
"任务类型": "<taskType>",
|
||||
"会话 ID": "<sessionId>",
|
||||
"任务下发时间": <当前时间戳>,
|
||||
"任务下发内容": "<message>",
|
||||
"调用轮次": 1,
|
||||
"状态": "进行中"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**注意：** 时间戳格式为毫秒（如 `1773891448933`），飞书会自动格式化为日期。
|
||||
|
||||
**4. 收到回复后（更新记录）**
|
||||
|
||||
使用 `feishu_bitable_app_table_record` 更新记录：
|
||||
|
||||
```javascript
|
||||
{
|
||||
"action": "update",
|
||||
"app_token": "Joc4bhUqEa6wJdsmevFc9YVhnH0",
|
||||
"table_id": "tbloPgG6gNmSufOM",
|
||||
"record_id": "<上一步创建的 record_id>",
|
||||
"fields": {
|
||||
"回复时间": <当前时间戳>,
|
||||
"回复完整内容": "<agent 返回的完整内容>",
|
||||
"返回结果摘要": "<简要总结>",
|
||||
"耗时 (秒)": <耗时>,
|
||||
"时间线": "<时间线文本>",
|
||||
"状态": "已完成"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 多维表格配置
|
||||
|
||||
### 表格信息
|
||||
|
||||
- **空间名称：** 游戏策划工作室
|
||||
- **表格名称：** Agent 沟通记录
|
||||
- **app_token:** `Joc4bhUqEa6wJdsmevFc9YVhnH0`
|
||||
- **table_id:** `tbloPgG6gNmSufOM`
|
||||
- **URL:** https://basegames.feishu.cn/base/Joc4bhUqEa6wJdsmevFc9YVhnH0
|
||||
|
||||
### 字段列表（与表格一致）
|
||||
|
||||
| 字段名 | 类型 | 必填 | 说明 |
|
||||
|--------|------|------|------|
|
||||
| 调用时间 | DateTime | ✅ | 调用时的时间 |
|
||||
| 调用方 | 文本 | ✅ | 固定为 game-director |
|
||||
| 被调用方 | 文本 | ✅ | 专精策划 ID |
|
||||
| 任务类型 | 文本 | ✅ | 竞品分析/系统设计等 |
|
||||
| 会话 ID | 文本 | ✅ | 关联完整会话 |
|
||||
| 任务下发时间 | DateTime | ✅ | 精确到秒 |
|
||||
| 任务下发内容 | 文本 | ✅ | 完整任务描述 |
|
||||
| 回复时间 | DateTime | ✅ | 精确到秒 |
|
||||
| 回复完整内容 | 文本 | ✅ | AI 返回的完整内容 |
|
||||
| 返回结果摘要 | 文本 | ✅ | 简要总结 |
|
||||
| 耗时 (秒) | 数字 | ✅ | 从下发到回复的时间 |
|
||||
| 追问记录 | 文本 | ❌ | 如有追问，记录内容 |
|
||||
| 时间线 | 文本 | ✅ | 完整调用过程时间线 |
|
||||
| 关联文档 | 附件 | ❌ | 关联的策划文档 |
|
||||
| 调用轮次 | 数字 | ✅ | 第几次调用 |
|
||||
| 状态 | 文本 | ✅ | 进行中/已完成/超时 |
|
||||
|
||||
**注意：** 飞书多维表格字段名必须完全匹配，包括空格和标点！
|
||||
|
||||
---
|
||||
|
||||
## 🎯 完整调用流程示例
|
||||
|
||||
```javascript
|
||||
// 1. 记录调用开始时间
|
||||
const startTime = Date.now();
|
||||
const startTimeStr = new Date().toISOString();
|
||||
|
||||
// 2. 创建多维表格记录（状态：进行中）
|
||||
const record = await feishu_bitable_app_table_record({
|
||||
action: "create",
|
||||
app_token: "Joc4bhUqEa6wJdsmevFc9YVhnH0",
|
||||
table_id: "tbloPgG6gNmSufOM",
|
||||
fields: {
|
||||
"调用时间": startTime,
|
||||
"调用方": "game-director",
|
||||
"被调用方": "system-designer",
|
||||
"任务类型": "系统设计",
|
||||
"会话 ID": "5fb8799a-f69a-4017-b02e-01ea6599adf7",
|
||||
"任务下发时间": startTime,
|
||||
"任务下发内容": "请分析《原神》的核心玩法系统设计...",
|
||||
"调用轮次": 1,
|
||||
"状态": "进行中"
|
||||
}
|
||||
});
|
||||
|
||||
const recordId = record.record_id;
|
||||
|
||||
// 3. 调用专精策划
|
||||
const response = await sessions_send({
|
||||
agentId: "system-designer",
|
||||
message: "请分析《原神》的核心玩法系统设计..."
|
||||
});
|
||||
|
||||
// 4. 计算耗时
|
||||
const endTime = Date.now();
|
||||
const duration = Math.round((endTime - startTime) / 1000);
|
||||
|
||||
// 5. 更新记录（状态：已完成）
|
||||
await feishu_bitable_app_table_record({
|
||||
action: "update",
|
||||
app_token: "Joc4bhUqEa6wJdsmevFc9YVhnH0",
|
||||
table_id: "tbloPgG6gNmSufOM",
|
||||
record_id: recordId,
|
||||
fields: {
|
||||
"回复时间": endTime,
|
||||
"回复完整内容": response.message,
|
||||
"返回结果摘要": "分析了原神的核心玩法循环、元素反应系统、角色养成系统...",
|
||||
"耗时 (秒)": duration,
|
||||
"状态": "已完成",
|
||||
"时间线": `[${startTimeStr}] 开始调用 system-designer\n[${startTimeStr}] 发送任务\n[${new Date().toISOString()}] 收到回复\n总耗时：${duration}秒`
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
1. **必须记录** - 每次调用专精策划都必须记录，不能遗漏
|
||||
2. **分阶段记录** - 调用时创建记录，收到回复后更新记录
|
||||
3. **准确计时** - 使用毫秒时间戳，确保耗时准确
|
||||
4. **完整内容** - 回复完整内容字段必须包含 AI 返回的全部文本
|
||||
5. **会话 ID** - 使用当前会话的 sessionId，方便追溯完整历史
|
||||
|
||||
---
|
||||
|
||||
## 🔧 调用限制
|
||||
|
||||
| 限制项 | 值 | 说明 |
|
||||
|--------|-----|------|
|
||||
| 每个专精调用次数 | ≤2 次 | 允许一次追问 |
|
||||
| 单次任务总调用 | ≤5 次 | 所有专精合计 |
|
||||
| 超时时间 | 600 秒 | 10 分钟超时 |
|
||||
|
||||
---
|
||||
|
||||
*此 Skill 由游戏策划工作室制定，确保所有 Agent 沟通都有完整记录。*
|
||||
Reference in New Issue
Block a user