@talesofai/neta-skills 0.12.0 → 0.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +11 -11
- package/README.zh_cn.md +8 -8
- package/bin/commands/{travel_campaign/create_travel_campaign.cmd.en_us.yml → adventure_campaign/create_adventure_campaign.cmd.en_us.yml} +5 -5
- package/bin/commands/{travel_campaign/create_travel_campaign.cmd.js → adventure_campaign/create_adventure_campaign.cmd.js} +3 -3
- package/bin/commands/{travel_campaign/create_travel_campaign.cmd.zh_cn.yml → adventure_campaign/create_adventure_campaign.cmd.zh_cn.yml} +2 -2
- package/bin/commands/{travel_campaign/list_my_travel_campaigns.cmd.en_us.yml → adventure_campaign/list_my_adventure_campaigns.cmd.en_us.yml} +4 -4
- package/bin/commands/{travel_campaign/list_my_travel_campaigns.cmd.js → adventure_campaign/list_my_adventure_campaigns.cmd.js} +3 -3
- package/bin/commands/{travel_campaign/list_my_travel_campaigns.cmd.zh_cn.yml → adventure_campaign/list_my_adventure_campaigns.cmd.zh_cn.yml} +2 -2
- package/bin/commands/{travel_campaign/request_travel_campaign.cmd.en_us.yml → adventure_campaign/request_adventure_campaign.cmd.en_us.yml} +3 -3
- package/bin/commands/{travel_campaign/request_travel_campaign.cmd.js → adventure_campaign/request_adventure_campaign.cmd.js} +3 -3
- package/bin/commands/{travel_campaign/request_travel_campaign.cmd.zh_cn.yml → adventure_campaign/request_adventure_campaign.cmd.zh_cn.yml} +1 -1
- package/bin/commands/{travel_campaign/update_travel_campaign.cmd.en_us.yml → adventure_campaign/update_adventure_campaign.cmd.en_us.yml} +3 -3
- package/bin/commands/{travel_campaign/update_travel_campaign.cmd.js → adventure_campaign/update_adventure_campaign.cmd.js} +3 -3
- package/bin/commands/{travel_campaign/update_travel_campaign.cmd.zh_cn.yml → adventure_campaign/update_adventure_campaign.cmd.zh_cn.yml} +1 -1
- package/bin/commands/load.js +1 -1
- package/package.json +2 -2
- package/skills/neta/SKILL.md +26 -6
- package/skills/neta-adventure/SKILL.md +71 -0
- package/skills/{neta-travel/references/travel-crafting.md → neta-adventure/references/adventure-crafting.md} +5 -5
- package/skills/{neta-travel/references/travel-examples.md → neta-adventure/references/adventure-examples.md} +1 -1
- package/skills/{neta-travel/references/travel-field-guide.md → neta-adventure/references/adventure-field-guide.md} +2 -2
- package/skills/{neta-travel/references/travel-playing.md → neta-adventure/references/adventure-playing.md} +2 -2
- package/skills/zh_cn/neta/SKILL.md +25 -7
- package/skills/zh_cn/{neta-travel → neta-adventure}/SKILL.md +15 -15
- package/skills/zh_cn/{neta-travel/references/travel-crafting.md → neta-adventure/references/adventure-crafting.md} +4 -4
- package/skills/zh_cn/{neta-travel/references/travel-field-guide.md → neta-adventure/references/adventure-field-guide.md} +1 -1
- package/skills/zh_cn/{neta-travel/references/travel-playing.md → neta-adventure/references/adventure-playing.md} +1 -1
- package/skills/neta-travel/SKILL.md +0 -71
- /package/skills/zh_cn/{neta-travel/references/travel-examples.md → neta-adventure/references/adventure-examples.md} +0 -0
package/CHANGELOG.md
CHANGED
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
**NETA Skills** is a collection of powerful AI agent skills and accompanying CLI tools designed for interacting with the [Neta Art](https://www.neta.art/) API. Built for developers and AI agents, it seamlessly extends any agent's capabilities to generate multimedia, manage characters, and process audio/video workflows.
|
|
14
14
|
|
|
15
|
-
You can get your access token from the [Neta Open Portal](https://www.neta.art/open/).
|
|
15
|
+
You can get your access token / NETA TOKEN from the [Neta Open Portal](https://www.neta.art/open/).
|
|
16
16
|
|
|
17
17
|
---
|
|
18
18
|
|
|
@@ -23,7 +23,7 @@ You can get your access token from the [Neta Open Portal](https://www.neta.art/o
|
|
|
23
23
|
- 👤 **Character & Style Management:** Search, fetch details, and manage characters and stylistic elements.
|
|
24
24
|
- 🏷️ **Community Integrations:** Explore trending hashtags, popular characters, and curated collections.
|
|
25
25
|
- 🧭 **Smart Discovery & Suggestions:** Explore interactive feeds and get keyword, tag, and category suggestions for progressive content discovery.
|
|
26
|
-
- 📖 **Interactive Story Adventures:** Craft and play AI-driven narrative campaigns (
|
|
26
|
+
- 📖 **Interactive Story Adventures:** Craft and play AI-driven narrative campaigns (Adventure) — the agent acts as DM and character roleplayer for immersive interactive fiction.
|
|
27
27
|
- 🤖 **Agent First:** Designed from the ground up to plug into your favorite AI agent frameworks.
|
|
28
28
|
|
|
29
29
|
---
|
|
@@ -61,8 +61,8 @@ npx skills add talesofai/neta-skills/skills/neta-character
|
|
|
61
61
|
# Elementum VToken creation and management
|
|
62
62
|
npx skills add talesofai/neta-skills/skills/neta-elementum
|
|
63
63
|
|
|
64
|
-
# AI-driven interactive story adventures (
|
|
65
|
-
npx skills add talesofai/neta-skills/skills/neta-
|
|
64
|
+
# AI-driven interactive story adventures (Adventure Campaigns)
|
|
65
|
+
npx skills add talesofai/neta-skills/skills/neta-adventure
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
### Available Commands
|
|
@@ -71,10 +71,10 @@ The skill includes **34 commands** for various tasks:
|
|
|
71
71
|
|
|
72
72
|
| Category | Command | Description |
|
|
73
73
|
|----------|---------|-------------|
|
|
74
|
-
| **
|
|
75
|
-
| | `
|
|
76
|
-
| | `
|
|
77
|
-
| | `
|
|
74
|
+
| **Adventure Campaigns** | `create_adventure_campaign` | Create an AI-driven interactive story adventure |
|
|
75
|
+
| | `update_adventure_campaign` | Update an existing adventure campaign |
|
|
76
|
+
| | `list_my_adventure_campaigns` | List your created adventure campaigns |
|
|
77
|
+
| | `request_adventure_campaign` | Load full campaign details for play mode |
|
|
78
78
|
| **Creation** | `make_image` | Generate images from text prompts |
|
|
79
79
|
| | `make_video` | Generate videos from images and prompts |
|
|
80
80
|
| | `make_song` | Compose songs with custom prompts and lyrics |
|
|
@@ -161,7 +161,7 @@ neta-skills/
|
|
|
161
161
|
│ ├── neta-space/ # Space navigation & exploration skills (EN)
|
|
162
162
|
│ ├── neta-character/ # Character VToken creation & management (EN)
|
|
163
163
|
│ ├── neta-elementum/ # Elementum VToken creation & management (EN)
|
|
164
|
-
│ ├── neta-
|
|
164
|
+
│ ├── neta-adventure/ # Interactive story adventures / Adventure Campaigns (EN)
|
|
165
165
|
│ └── zh_cn/ # Chinese-localized skills & references
|
|
166
166
|
│ ├── neta/
|
|
167
167
|
│ ├── neta-community/
|
|
@@ -170,7 +170,7 @@ neta-skills/
|
|
|
170
170
|
│ ├── neta-space/
|
|
171
171
|
│ ├── neta-character/
|
|
172
172
|
│ ├── neta-elementum/
|
|
173
|
-
│ └── neta-
|
|
173
|
+
│ └── neta-adventure/
|
|
174
174
|
├── src/ # TypeScript source for the CLI
|
|
175
175
|
│ ├── apis/ # Typed Neta API client helpers
|
|
176
176
|
│ ├── commands/ # CLI command definitions (TS + YAML meta)
|
|
@@ -203,7 +203,7 @@ Agents use these references to learn the optimal sequence of actions, parameter
|
|
|
203
203
|
- **Song & MV Creation:** Workflows for composing songs and creating music videos with synchronized visuals.
|
|
204
204
|
- **Character & Hashtag Research:** Processes for finding trending content, searching characters, and utilizing community trends.
|
|
205
205
|
- **Character & Elementum Creation:** Character creation and elementum alchemy workflows.
|
|
206
|
-
- **
|
|
206
|
+
- **Adventure Campaign Crafting & Play:** Multi-turn story creation workflow (Craft Mode), interactive session management (Play Mode), field reference, and complete genre examples. See `skills/neta-adventure/references/`.
|
|
207
207
|
|
|
208
208
|
---
|
|
209
209
|
|
package/README.zh_cn.md
CHANGED
|
@@ -64,7 +64,7 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-character
|
|
|
64
64
|
npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
|
|
65
65
|
|
|
66
66
|
# AI 驱动的交互式故事冒险(奇遇剧本)
|
|
67
|
-
npx skills add talesofai/neta-skills/skills/zh_cn/neta-
|
|
67
|
+
npx skills add talesofai/neta-skills/skills/zh_cn/neta-adventure
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
### 可用指令总览
|
|
@@ -73,10 +73,10 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-travel
|
|
|
73
73
|
|
|
74
74
|
| 分类 | 命令 | 说明 |
|
|
75
75
|
|------|------|------|
|
|
76
|
-
| **奇遇剧本
|
|
77
|
-
| | `
|
|
78
|
-
| | `
|
|
79
|
-
| | `
|
|
76
|
+
| **奇遇剧本 Adventure** | `create_adventure_campaign` | 创建 AI 驱动的交互式故事冒险剧本 |
|
|
77
|
+
| | `update_adventure_campaign` | 更新已有奇遇剧本 |
|
|
78
|
+
| | `list_my_adventure_campaigns` | 列出你创建的奇遇剧本 |
|
|
79
|
+
| | `request_adventure_campaign` | 加载完整剧本详情(游玩模式) |
|
|
80
80
|
| **创作 Creation** | `make_image` | 基于提示词生成图片 |
|
|
81
81
|
| | `make_video` | 基于图片与动作描述生成视频 |
|
|
82
82
|
| | `make_song` | 基于风格与歌词生成歌曲 |
|
|
@@ -169,7 +169,7 @@ neta-skills/
|
|
|
169
169
|
│ ├── neta-space/ # 英文空间与话题导航 / 探索技能
|
|
170
170
|
│ ├── neta-character/ # 英文角色 VToken 创建与管理技能
|
|
171
171
|
│ ├── neta-elementum/ # 英文元素 VToken 创建与管理技能
|
|
172
|
-
│ ├── neta-
|
|
172
|
+
│ ├── neta-adventure/ # 英文交互式故事冒险(奇遇剧本)技能
|
|
173
173
|
│ └── zh_cn/ # 中文本地化技能与参考文档
|
|
174
174
|
│ ├── neta/
|
|
175
175
|
│ ├── neta-community/
|
|
@@ -178,7 +178,7 @@ neta-skills/
|
|
|
178
178
|
│ ├── neta-space/
|
|
179
179
|
│ ├── neta-character/
|
|
180
180
|
│ ├── neta-elementum/
|
|
181
|
-
│ └── neta-
|
|
181
|
+
│ └── neta-adventure/
|
|
182
182
|
├── src/ # CLI 对应的 TypeScript 源码
|
|
183
183
|
│ ├── apis/ # 封装后的 Neta API 调用
|
|
184
184
|
│ ├── commands/ # CLI 命令定义(TS + YAML 描述)
|
|
@@ -210,7 +210,7 @@ neta-skills/
|
|
|
210
210
|
- **角色与标签调研**:如何通过角色 / 标签 / 空间找到合适的创作方向。
|
|
211
211
|
- **角色与元素创建**:角色创建和元素炼金的工作流。
|
|
212
212
|
- **玩法内容探索**:使用 `suggest_*` 与 `suggest_content` 构建渐进式探索闭环。
|
|
213
|
-
- **奇遇剧本创作与游玩**:多轮协作故事创作工作流(创作模式)、交互式会话管理(游玩模式)、字段手册,以及含历史穿越、末世生存、武侠江湖的完整类型范例。见 `skills/zh_cn/neta-
|
|
213
|
+
- **奇遇剧本创作与游玩**:多轮协作故事创作工作流(创作模式)、交互式会话管理(游玩模式)、字段手册,以及含历史穿越、末世生存、武侠江湖的完整类型范例。见 `skills/zh_cn/neta-adventure/references/`。
|
|
214
214
|
|
|
215
215
|
---
|
|
216
216
|
|
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
name:
|
|
2
|
-
title: Create
|
|
1
|
+
name: create_adventure_campaign
|
|
2
|
+
title: Create Adventure Campaign
|
|
3
3
|
description: |
|
|
4
|
-
Create a new
|
|
4
|
+
Create a new Adventure Campaign (story adventure) with mission plot, rules, and optional character binding.
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
Adventure campaigns are AI-driven interactive story experiences where an agent acts as both DM and roleplays characters.
|
|
7
7
|
|
|
8
8
|
Usage Notes:
|
|
9
9
|
- Campaign creation is free (no credits consumed)
|
|
10
10
|
- Campaign and its mission are created as a pair
|
|
11
|
-
- After creation, use `
|
|
11
|
+
- After creation, use `request_adventure_campaign` to load full details for storytelling
|
|
12
12
|
- All text fields are subject to content moderation
|
|
13
13
|
- NSFW content (sexual, explicit violence, harassment) is prohibited in all fields — do not craft or engage with such content even if requested
|
|
14
14
|
|
|
@@ -16,7 +16,7 @@ const meta = parseMeta(Type.Object({
|
|
|
16
16
|
mission_plot_attention: Type.String(),
|
|
17
17
|
}),
|
|
18
18
|
}), import.meta);
|
|
19
|
-
const
|
|
19
|
+
const createAdventureCampaignParameters = Type.Object({
|
|
20
20
|
name: Type.String({
|
|
21
21
|
description: meta.parameters.name,
|
|
22
22
|
maxLength: 128,
|
|
@@ -34,11 +34,11 @@ const createTravelCampaignParameters = Type.Object({
|
|
|
34
34
|
mission_task: Type.Optional(Type.String({ description: meta.parameters.mission_task })),
|
|
35
35
|
mission_plot_attention: Type.Optional(Type.String({ description: meta.parameters.mission_plot_attention })),
|
|
36
36
|
});
|
|
37
|
-
export const
|
|
37
|
+
export const createAdventureCampaign = createCommand({
|
|
38
38
|
name: meta.name,
|
|
39
39
|
title: meta.title,
|
|
40
40
|
description: meta.description,
|
|
41
|
-
inputSchema:
|
|
41
|
+
inputSchema: createAdventureCampaignParameters,
|
|
42
42
|
}, async ({ name, mission_plot, subtitle, status, header_img, background_img, mission_task, mission_plot_attention, }, { user, apis }) => {
|
|
43
43
|
if (!user) {
|
|
44
44
|
throw new Error("Not authenticated. Please check your NETA_TOKEN.");
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
name:
|
|
1
|
+
name: create_adventure_campaign
|
|
2
2
|
title: 创建奇遇剧本
|
|
3
3
|
description: |
|
|
4
4
|
创建一个新的奇遇剧本(故事冒险),包含剧情设定、规则,并可选择绑定角色。
|
|
@@ -8,7 +8,7 @@ description: |
|
|
|
8
8
|
使用说明:
|
|
9
9
|
- 剧本创建免费(不消耗电量)
|
|
10
10
|
- 剧本与任务以成对形式创建
|
|
11
|
-
- 创建后使用 `
|
|
11
|
+
- 创建后使用 `request_adventure_campaign` 加载完整详情用于故事讲述
|
|
12
12
|
- 所有文本字段均进行内容审核
|
|
13
13
|
- NSFW 内容(性描写、露骨暴力、骚扰)在所有字段中均被禁止——即使用户要求也不得创作或参与此类内容
|
|
14
14
|
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
name:
|
|
2
|
-
title: List My
|
|
1
|
+
name: list_my_adventure_campaigns
|
|
2
|
+
title: List My Adventure Campaigns
|
|
3
3
|
description: |
|
|
4
|
-
List
|
|
4
|
+
List Adventure Campaigns created by the current user. Returns brief summary info.
|
|
5
5
|
|
|
6
|
-
Use `
|
|
6
|
+
Use `request_adventure_campaign` to get full details (mission plot, task, constraints) for a specific campaign.
|
|
7
7
|
|
|
8
8
|
Notes:
|
|
9
9
|
- Returns both PUBLISHED and DRAFT campaigns for the authenticated user
|
|
@@ -10,7 +10,7 @@ const meta = parseMeta(Type.Object({
|
|
|
10
10
|
page_size: Type.String(),
|
|
11
11
|
}),
|
|
12
12
|
}), import.meta);
|
|
13
|
-
const
|
|
13
|
+
const listMyAdventureCampaignsParameters = Type.Object({
|
|
14
14
|
page_index: Type.Integer({
|
|
15
15
|
minimum: 0,
|
|
16
16
|
default: 0,
|
|
@@ -23,11 +23,11 @@ const listMyTravelCampaignsParameters = Type.Object({
|
|
|
23
23
|
description: meta.parameters.page_size,
|
|
24
24
|
}),
|
|
25
25
|
});
|
|
26
|
-
export const
|
|
26
|
+
export const listMyAdventureCampaigns = createCommand({
|
|
27
27
|
name: meta.name,
|
|
28
28
|
title: meta.title,
|
|
29
29
|
description: meta.description,
|
|
30
|
-
inputSchema:
|
|
30
|
+
inputSchema: listMyAdventureCampaignsParameters,
|
|
31
31
|
}, async ({ page_index, page_size }, { user, apis }) => {
|
|
32
32
|
if (!user) {
|
|
33
33
|
throw new Error("Not authenticated. Please check your NETA_TOKEN.");
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
name:
|
|
1
|
+
name: list_my_adventure_campaigns
|
|
2
2
|
title: 列出我的奇遇剧本
|
|
3
3
|
description: |
|
|
4
4
|
列出当前用户创建的奇遇剧本。返回简要摘要信息。
|
|
5
5
|
|
|
6
|
-
使用 `
|
|
6
|
+
使用 `request_adventure_campaign` 获取特定剧本的完整详情(剧情、任务、约束)。
|
|
7
7
|
|
|
8
8
|
说明:
|
|
9
9
|
- 为已认证用户返回 PUBLISHED 和 DRAFT 剧本
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
name:
|
|
2
|
-
title: Get
|
|
1
|
+
name: request_adventure_campaign
|
|
2
|
+
title: Get Adventure Campaign Details
|
|
3
3
|
description: |
|
|
4
|
-
Get full details of a
|
|
4
|
+
Get full details of a Adventure Campaign including mission plot, task, and AI constraints.
|
|
5
5
|
|
|
6
6
|
This is the primary command for "play mode" — load a campaign before starting a storytelling session.
|
|
7
7
|
|
|
@@ -9,16 +9,16 @@ const meta = parseMeta(Type.Object({
|
|
|
9
9
|
campaign_uuid: Type.String(),
|
|
10
10
|
}),
|
|
11
11
|
}), import.meta);
|
|
12
|
-
const
|
|
12
|
+
const requestAdventureCampaignParameters = Type.Object({
|
|
13
13
|
campaign_uuid: Type.String({
|
|
14
14
|
description: meta.parameters.campaign_uuid,
|
|
15
15
|
}),
|
|
16
16
|
});
|
|
17
|
-
export const
|
|
17
|
+
export const requestAdventureCampaign = createCommand({
|
|
18
18
|
name: meta.name,
|
|
19
19
|
title: meta.title,
|
|
20
20
|
description: meta.description,
|
|
21
|
-
inputSchema:
|
|
21
|
+
inputSchema: requestAdventureCampaignParameters,
|
|
22
22
|
}, async ({ campaign_uuid }, { apis }) => {
|
|
23
23
|
const campaign = await apis.travelCampaign.getCampaign(campaign_uuid);
|
|
24
24
|
return {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
name:
|
|
2
|
-
title: Update
|
|
1
|
+
name: update_adventure_campaign
|
|
2
|
+
title: Update Adventure Campaign
|
|
3
3
|
description: |
|
|
4
|
-
Update an existing
|
|
4
|
+
Update an existing Adventure Campaign. Only specify fields that need to change — omitted fields remain unchanged.
|
|
5
5
|
|
|
6
6
|
Usage Notes:
|
|
7
7
|
- You must be the creator of the campaign to update it
|
|
@@ -17,7 +17,7 @@ const meta = parseMeta(Type.Object({
|
|
|
17
17
|
mission_plot_attention: Type.String(),
|
|
18
18
|
}),
|
|
19
19
|
}), import.meta);
|
|
20
|
-
const
|
|
20
|
+
const updateAdventureCampaignParameters = Type.Object({
|
|
21
21
|
campaign_uuid: Type.String({
|
|
22
22
|
description: meta.parameters.campaign_uuid,
|
|
23
23
|
}),
|
|
@@ -35,11 +35,11 @@ const updateTravelCampaignParameters = Type.Object({
|
|
|
35
35
|
mission_task: Type.Optional(Type.String({ description: meta.parameters.mission_task })),
|
|
36
36
|
mission_plot_attention: Type.Optional(Type.String({ description: meta.parameters.mission_plot_attention })),
|
|
37
37
|
});
|
|
38
|
-
export const
|
|
38
|
+
export const updateAdventureCampaign = createCommand({
|
|
39
39
|
name: meta.name,
|
|
40
40
|
title: meta.title,
|
|
41
41
|
description: meta.description,
|
|
42
|
-
inputSchema:
|
|
42
|
+
inputSchema: updateAdventureCampaignParameters,
|
|
43
43
|
}, async ({ campaign_uuid, name, mission_plot, subtitle, status, header_img, background_img, mission_task, mission_plot_attention, }, { user, apis }) => {
|
|
44
44
|
if (!user) {
|
|
45
45
|
throw new Error("Not authenticated. Please check your NETA_TOKEN.");
|
package/bin/commands/load.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@talesofai/neta-skills",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.0",
|
|
4
4
|
"description": "Neta API pi coding agent skills for interacting with Neta API to generate images, videos, songs, and manage characters/elements.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"repository": {
|
|
@@ -31,7 +31,7 @@
|
|
|
31
31
|
},
|
|
32
32
|
"scripts": {
|
|
33
33
|
"lint": "biome check . --write --unsafe",
|
|
34
|
-
"validate": "skills-ref to-prompt ./skills/neta ./skills/neta-community ./skills/neta-creative ./skills/neta-suggest ./skills/neta-space ./skills/neta-character ./skills/neta-elementum",
|
|
34
|
+
"validate": "skills-ref to-prompt ./skills/neta ./skills/neta-community ./skills/neta-creative ./skills/neta-suggest ./skills/neta-space ./skills/neta-character ./skills/neta-elementum ./skills/neta-adventure",
|
|
35
35
|
"type-check": "tsc --noEmit",
|
|
36
36
|
"check": "pnpm lint && pnpm type-check && pnpm validate",
|
|
37
37
|
"changelog": "changeset",
|
package/skills/neta/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: neta
|
|
3
|
-
description: Neta capability index and routing skill - help choose the appropriate Neta-related skill (neta-space / neta-creative / neta-community / neta-suggest). Use this skill when you need to understand Neta's overall capabilities, decide which skill fits the current task, or migrate from older documentation that referenced the monolithic neta skill.
|
|
3
|
+
description: Neta capability index and routing skill - help choose the appropriate Neta-related skill (neta-space / neta-creative / neta-adventure / neta-community / neta-suggest). Use this skill when you need to understand Neta's overall capabilities, decide which skill fits the current task, or migrate from older documentation that referenced the monolithic neta skill.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Neta Skill
|
|
@@ -31,14 +31,18 @@ npx skills add talesofai/neta-skills/skills/neta-character
|
|
|
31
31
|
|
|
32
32
|
# Elementum (visual style/concept) creation and management
|
|
33
33
|
npx skills add talesofai/neta-skills/skills/neta-elementum
|
|
34
|
+
|
|
35
|
+
# Interactive story adventures (Adventure Campaigns)
|
|
36
|
+
npx skills add talesofai/neta-skills/skills/neta-adventure
|
|
34
37
|
```
|
|
35
38
|
|
|
36
39
|
## Instructions
|
|
37
40
|
|
|
38
|
-
1. **Identify the task type**: classify the user's need as one of: "space exploration", "content creation", "community interaction", "research/recommendation", or "character creation/management".
|
|
41
|
+
1. **Identify the task type**: classify the user's need as one of: "space exploration", "content creation", "interactive story adventures", "community interaction", "research/recommendation", or "character creation/management".
|
|
39
42
|
2. **Choose the corresponding sub-skill**:
|
|
40
43
|
- Spaces/worldbuilding/gameplay structure → use `neta-space`
|
|
41
44
|
- Image/video/song/MV creation and idea deconstruction → use `neta-creative`
|
|
45
|
+
- Crafting or playing AI-driven story campaigns (Adventure Campaigns) → use `neta-adventure`
|
|
42
46
|
- Browsing feeds, viewing collection details, liking/interacting, community-centric views → use `neta-community`
|
|
43
47
|
- Keyword/tag/category research and recommendation, progressive exploration from broad to narrow → use `neta-suggest`
|
|
44
48
|
- Creating or managing anime/cultural IP/original characters (VTokens/TCP/OC) → use `neta-character`
|
|
@@ -79,7 +83,22 @@ Use when:
|
|
|
79
83
|
|
|
80
84
|
See `skills/neta-creative/SKILL.md` for full details.
|
|
81
85
|
|
|
82
|
-
### 3.
|
|
86
|
+
### 3. Interactive story adventures: `neta-adventure`
|
|
87
|
+
|
|
88
|
+
Responsibilities:
|
|
89
|
+
|
|
90
|
+
- Create and update Adventure Campaigns (`create_adventure_campaign`, `update_adventure_campaign`).
|
|
91
|
+
- List the current user's campaigns (`list_my_adventure_campaigns`).
|
|
92
|
+
- Load full campaign details for play mode (`request_adventure_campaign`).
|
|
93
|
+
|
|
94
|
+
Use when:
|
|
95
|
+
|
|
96
|
+
- The user wants to design, write, or refine an interactive story / narrative campaign with plot, tasks, and governing rules.
|
|
97
|
+
- They want to run or continue a storytelling session as DM plus character roleplay from an existing campaign UUID.
|
|
98
|
+
|
|
99
|
+
See `skills/neta-adventure/SKILL.md` for full details.
|
|
100
|
+
|
|
101
|
+
### 4. Community browsing and interactions: `neta-community`
|
|
83
102
|
|
|
84
103
|
Responsibilities:
|
|
85
104
|
|
|
@@ -95,7 +114,7 @@ Use when:
|
|
|
95
114
|
|
|
96
115
|
See `skills/neta-community/SKILL.md` for full details.
|
|
97
116
|
|
|
98
|
-
###
|
|
117
|
+
### 5. Research and recommendation engine: `neta-suggest`
|
|
99
118
|
|
|
100
119
|
Responsibilities:
|
|
101
120
|
|
|
@@ -112,7 +131,7 @@ Use when:
|
|
|
112
131
|
|
|
113
132
|
See `skills/neta-suggest/SKILL.md` for full details.
|
|
114
133
|
|
|
115
|
-
###
|
|
134
|
+
### 6. Character creation and management: `neta-character`
|
|
116
135
|
|
|
117
136
|
Responsibilities:
|
|
118
137
|
|
|
@@ -129,7 +148,7 @@ Use when:
|
|
|
129
148
|
|
|
130
149
|
See `skills/neta-character/SKILL.md` for full details.
|
|
131
150
|
|
|
132
|
-
###
|
|
151
|
+
### 7. Elementum (visual style/concept) creation and management: `neta-elementum`
|
|
133
152
|
|
|
134
153
|
Responsibilities:
|
|
135
154
|
|
|
@@ -154,6 +173,7 @@ If you encounter older docs or scripts that call commands directly under `neta`,
|
|
|
154
173
|
|---------------------------------------------|------------------|
|
|
155
174
|
| Space/tag lore and space browsing | `neta-space` |
|
|
156
175
|
| Image/video/song/MV creation | `neta-creative` |
|
|
176
|
+
| Interactive story / Adventure Campaigns | `neta-adventure` |
|
|
157
177
|
| Collection details, feeds, likes/interacts | `neta-community` |
|
|
158
178
|
| Keyword/tag/category/recommendation research| `neta-suggest` |
|
|
159
179
|
| Character creation and management | `neta-character` |
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: neta-adventure
|
|
3
|
+
description: Neta Adventure Campaign skill - Create and play AI-driven interactive story adventures. Adventure campaigns provide story-crafting and story-telling modes where agents act as DM and roleplay characters following plot, rules, and special guidelines.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Neta Adventure Skill
|
|
7
|
+
|
|
8
|
+
Create and experience AI-driven interactive story adventures (Adventure Campaigns). The agent serves as both Dungeon Master and character, guiding narrative experiences built on crafted plots, objectives, and governing rules.
|
|
9
|
+
|
|
10
|
+
## Mode Detection
|
|
11
|
+
|
|
12
|
+
Determine mode before acting. Do not ask multiple questions.
|
|
13
|
+
|
|
14
|
+
| Signal | Mode | Load |
|
|
15
|
+
|--------|------|------|
|
|
16
|
+
| User wants to create / design / build a story | Craft | `references/adventure-crafting.md` |
|
|
17
|
+
| User provides UUID or refers to existing campaign | Play | `references/adventure-playing.md` |
|
|
18
|
+
| Field question arises during craft or play | — | `references/adventure-field-guide.md` |
|
|
19
|
+
| Ambiguous (genre mention, no further context) | — | Ask ONE question: *"Create a new story, or play one you've already made?"* |
|
|
20
|
+
|
|
21
|
+
Once mode is established, do not re-ask.
|
|
22
|
+
|
|
23
|
+
## Commands
|
|
24
|
+
|
|
25
|
+
**Create a campaign**
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
npx -y @talesofai/neta-skills create_adventure_campaign \
|
|
29
|
+
--name "Raccoon General: Final Shift" \
|
|
30
|
+
--mission_plot "The last maintenance log entry is dated three weeks ago..." \
|
|
31
|
+
--mission_task "Survive the night. Find Dr. Strauss. Discover what Umbrella did." \
|
|
32
|
+
--mission_plot_attention "Maintain survival-horror dread. No graphic gore — horror through implication."
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
📖 [Craft workflow](./references/adventure-crafting.md) — draft-first loop, field system, quality checklist.
|
|
36
|
+
|
|
37
|
+
**Update a campaign** (only provided fields are changed)
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
npx -y @talesofai/neta-skills update_adventure_campaign \
|
|
41
|
+
--campaign_uuid "campaign-uuid-here" \
|
|
42
|
+
--mission_plot_attention "Updated governing rules..."
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
**List your campaigns**
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
npx -y @talesofai/neta-skills list_my_adventure_campaigns
|
|
49
|
+
npx -y @talesofai/neta-skills list_my_adventure_campaigns --page_index 0 --page_size 10
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
**Get campaign details**
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
npx -y @talesofai/neta-skills request_adventure_campaign --campaign_uuid "campaign-uuid-here"
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
📖 [Play workflow](./references/adventure-playing.md) — initialization, proactive advance, steering mechanics.
|
|
59
|
+
|
|
60
|
+
## neta-creative Integration
|
|
61
|
+
|
|
62
|
+
If `default_tcp_uuid` is present on a campaign, check whether `request_character_or_elementum` is available in the current skill set before attempting to load the character profile. Do not suggest installing neta-creative; check first, then proceed with or without it.
|
|
63
|
+
|
|
64
|
+
## Reference Documents
|
|
65
|
+
|
|
66
|
+
| Scenario | Document |
|
|
67
|
+
|----------|----------|
|
|
68
|
+
| 📝 Craft workflow | [adventure-crafting.md](./references/adventure-crafting.md) |
|
|
69
|
+
| 🎮 Play workflow | [adventure-playing.md](./references/adventure-playing.md) |
|
|
70
|
+
| 📋 Field semantics | [adventure-field-guide.md](./references/adventure-field-guide.md) |
|
|
71
|
+
| ✨ Worked examples across genres | [adventure-examples.md](./references/adventure-examples.md) |
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Adventure Campaign Crafting Guide
|
|
2
2
|
|
|
3
3
|
Craft mode: translate any concept seed into a complete, playable campaign. Default behavior is draft-first — generate immediately, refine surgically.
|
|
4
4
|
|
|
@@ -24,7 +24,7 @@ Calibrate to the user's mode from signals, not meta-questions.
|
|
|
24
24
|
2. Agent generates ALL five fields immediately, labels assumptions inline.
|
|
25
25
|
3. Present as readable prose, not JSON. Include a brief "I assumed X" note.
|
|
26
26
|
4. User reacts → agent refines only the changed fields. No wholesale rewrites.
|
|
27
|
-
5. One explicit confirm → call `
|
|
27
|
+
5. One explicit confirm → call `create_adventure_campaign`.
|
|
28
28
|
|
|
29
29
|
**Edge cases**
|
|
30
30
|
- Mid-conversation pivot → synthesize from conversation history, generate a new draft immediately.
|
|
@@ -35,7 +35,7 @@ Calibrate to the user's mode from signals, not meta-questions.
|
|
|
35
35
|
|
|
36
36
|
## Five Fields as a Coherent System
|
|
37
37
|
|
|
38
|
-
Before generating, consult `
|
|
38
|
+
Before generating, consult `adventure-examples.md` for range across genres.
|
|
39
39
|
|
|
40
40
|
### `mission_plot` — What IS
|
|
41
41
|
Write like an opening paragraph, not a summary. The world, the situation, the hook. Start mid-wrong — something is already broken. The first sentence is the first thing the AI experiences; it sets atmosphere for the entire session.
|
|
@@ -70,9 +70,9 @@ If `mission_plot` is a paranoid thriller, `mission_plot_attention` should enforc
|
|
|
70
70
|
|
|
71
71
|
## After Creation
|
|
72
72
|
|
|
73
|
-
Call `
|
|
73
|
+
Call `request_adventure_campaign` immediately to confirm fields are stored correctly — especially `mission_plot_attention`, which governs all future play sessions.
|
|
74
74
|
|
|
75
|
-
After the first playtest, note where the AI drifted; use `
|
|
75
|
+
After the first playtest, note where the AI drifted; use `update_adventure_campaign` to tighten `mission_plot_attention` at those points.
|
|
76
76
|
|
|
77
77
|
---
|
|
78
78
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Adventure Campaign Field Guide
|
|
2
2
|
|
|
3
3
|
Reference for non-obvious field behaviors. Consult when a specific field question arises — not loaded by default.
|
|
4
4
|
|
|
@@ -40,6 +40,6 @@ If the character profile and campaign fields contradict, follow the campaign fie
|
|
|
40
40
|
|
|
41
41
|
## Field Update Semantics
|
|
42
42
|
|
|
43
|
-
`
|
|
43
|
+
`update_adventure_campaign` is partial: only provided fields are modified. Omitted fields retain current values. Updates apply atomically to both campaign and linked mission.
|
|
44
44
|
|
|
45
45
|
After tightening `mission_plot_attention` via update, the new rules apply immediately to all subsequent play sessions. Prior sessions are unaffected.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Adventure Campaign Playing Guide
|
|
2
2
|
|
|
3
3
|
Play mode is performance, not conversation. The agent is a proactive performer; the user is audience and director. The curtain rises — the agent does not wait for permission.
|
|
4
4
|
|
|
@@ -18,7 +18,7 @@ Play mode is performance, not conversation. The agent is a proactive performer;
|
|
|
18
18
|
|
|
19
19
|
Complete this checklist before the first narrative word.
|
|
20
20
|
|
|
21
|
-
1. Fetch campaign by UUID via `
|
|
21
|
+
1. Fetch campaign by UUID via `request_adventure_campaign`. Hold: `mission_plot`, `mission_task`, `mission_plot_attention`, `default_tcp_uuid`.
|
|
22
22
|
2. If `default_tcp_uuid` present → **check if `request_character_or_elementum` is available**. If yes, load the full profile. If no, proceed without — do not invent traits from the UUID alone.
|
|
23
23
|
3. If neta-creative is available → ask the user **once**: *"Text-only, or generate scene images at key moments?"* Record their preference. Never ask again.
|
|
24
24
|
4. Begin the first advance immediately. No "are you ready?" — the curtain rises.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: neta
|
|
3
|
-
description: Neta 能力索引与路由 skill——帮助选择合适的 Neta 相关 skill(neta-space / neta-creative / neta-community / neta-suggest)。当需要了解 Neta 整体能力、决定当前任务该用哪个 skill 或从旧文档迁移时使用本 skill。
|
|
3
|
+
description: Neta 能力索引与路由 skill——帮助选择合适的 Neta 相关 skill(neta-space / neta-creative / neta-adventure / neta-community / neta-suggest)。当需要了解 Neta 整体能力、决定当前任务该用哪个 skill 或从旧文档迁移时使用本 skill。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Neta Skill
|
|
@@ -31,14 +31,18 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-character
|
|
|
31
31
|
|
|
32
32
|
# 元素(视觉风格/概念)创建与管理
|
|
33
33
|
npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
|
|
34
|
+
|
|
35
|
+
# 交互式故事冒险(奇遇剧本 / Adventure Campaigns)
|
|
36
|
+
npx skills add talesofai/neta-skills/skills/zh_cn/neta-adventure
|
|
34
37
|
```
|
|
35
38
|
|
|
36
39
|
## Instructions
|
|
37
40
|
|
|
38
|
-
1.
|
|
41
|
+
1. **判断当前任务类型**:先根据用户需求判断是「空间游览」「内容创作」「交互式故事冒险(奇遇剧本)」「社区互动」「内容调研/推荐」「角色创建/管理」中的哪一类。
|
|
39
42
|
2. **选择对应子 skill**:
|
|
40
43
|
- 空间/世界观/玩法结构 → 使用 `neta-space`
|
|
41
44
|
- 生成图片/视频/歌曲/MV、拆解创作思路 → 使用 `neta-creative`
|
|
45
|
+
- 创作或游玩 AI 驱动的故事剧本(奇遇剧本 / Adventure Campaigns)→ 使用 `neta-adventure`
|
|
42
46
|
- 浏览推荐流、查看作品详情、点赞互动、社区视角浏览 → 使用 `neta-community`
|
|
43
47
|
- 关键词/标签/分类/推荐流调研、从宽到窄找题材 → 使用 `neta-suggest`
|
|
44
48
|
- 创建或管理动漫/文化IP/原创角色(VToken/TCP/OC)→ 使用 `neta-character`
|
|
@@ -75,7 +79,20 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
|
|
|
75
79
|
|
|
76
80
|
详见 `skills/zh_cn/neta-creative/SKILL.md`。
|
|
77
81
|
|
|
78
|
-
### 3.
|
|
82
|
+
### 3. 交互式故事冒险(奇遇剧本):`neta-adventure`
|
|
83
|
+
|
|
84
|
+
负责:
|
|
85
|
+
- 创建与更新奇遇剧本(`create_adventure_campaign`、`update_adventure_campaign`)
|
|
86
|
+
- 列出当前用户创建的剧本(`list_my_adventure_campaigns`)
|
|
87
|
+
- 加载完整剧本详情供游玩模式使用(`request_adventure_campaign`)
|
|
88
|
+
|
|
89
|
+
适用场景:
|
|
90
|
+
- 用户要「写故事 / 设计剧本 / 改剧情规则」等交互式叙事向需求
|
|
91
|
+
- 用户持有剧本 UUID,要以 DM + 角色扮演方式推进或继续一局故事
|
|
92
|
+
|
|
93
|
+
详见 `skills/zh_cn/neta-adventure/SKILL.md`。
|
|
94
|
+
|
|
95
|
+
### 4. 社区浏览与互动:`neta-community`
|
|
79
96
|
|
|
80
97
|
负责:
|
|
81
98
|
- 获取互动推荐流
|
|
@@ -89,7 +106,7 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
|
|
|
89
106
|
|
|
90
107
|
详见 `skills/zh_cn/neta-community/SKILL.md`。
|
|
91
108
|
|
|
92
|
-
###
|
|
109
|
+
### 5. 内容调研与推荐引擎:`neta-suggest`
|
|
93
110
|
|
|
94
111
|
负责:
|
|
95
112
|
- 关键词建议(`suggest_keywords`)
|
|
@@ -104,7 +121,7 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
|
|
|
104
121
|
|
|
105
122
|
详见 `skills/zh_cn/neta-suggest/SKILL.md`。
|
|
106
123
|
|
|
107
|
-
###
|
|
124
|
+
### 6. 角色创建与管理:`neta-character`
|
|
108
125
|
|
|
109
126
|
负责:
|
|
110
127
|
- 创建新角色为 VToken(虚拟Token,TCP/OC)
|
|
@@ -119,7 +136,7 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
|
|
|
119
136
|
|
|
120
137
|
详见 `skills/zh_cn/neta-character/SKILL.md`。
|
|
121
138
|
|
|
122
|
-
###
|
|
139
|
+
### 7. 元素(视觉风格/概念)创建与管理:`neta-elementum`
|
|
123
140
|
|
|
124
141
|
负责:
|
|
125
142
|
- 创建新元素(视觉概念)为 VToken(TCP/Elementum)
|
|
@@ -132,7 +149,7 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
|
|
|
132
149
|
- 用户想创建可复用的视觉概念(场景、道具、服装、姿势、氛围、梗)
|
|
133
150
|
- 用户想要「列出我的元素」或「搜索元素」
|
|
134
151
|
|
|
135
|
-
详见 `skills/neta-elementum/SKILL.md`。
|
|
152
|
+
详见 `skills/zh_cn/neta-elementum/SKILL.md`。
|
|
136
153
|
|
|
137
154
|
## 迁移说明(从旧 neta skill)
|
|
138
155
|
|
|
@@ -142,6 +159,7 @@ npx skills add talesofai/neta-skills/skills/zh_cn/neta-elementum
|
|
|
142
159
|
|----------------------------|--------------------|
|
|
143
160
|
| 空间/标签世界观、空间游览 | `neta-space` |
|
|
144
161
|
| 图片/视频/歌曲/MV 创作 | `neta-creative` |
|
|
162
|
+
| 交互式故事 / 奇遇剧本 | `neta-adventure` |
|
|
145
163
|
| 作品详情、推荐流、点赞互动 | `neta-community` |
|
|
146
164
|
| 关键词/标签/分类/推荐调研 | `neta-suggest` |
|
|
147
165
|
| 角色创建与管理 | `neta-character` |
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: neta-
|
|
2
|
+
name: neta-adventure
|
|
3
3
|
description: Neta 奇遇剧本技能 - 创建和游玩 AI 驱动的交互式故事冒险。奇遇模式提供故事创作和故事讲述两种模式,Agent 作为 DM 并扮演角色,遵循剧情、规则和特殊指南。
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -13,9 +13,9 @@ description: Neta 奇遇剧本技能 - 创建和游玩 AI 驱动的交互式故
|
|
|
13
13
|
|
|
14
14
|
| 信号 | 模式 | 加载 |
|
|
15
15
|
|------|------|------|
|
|
16
|
-
| 用户想要创建 / 设计 / 构建故事 | 创作 | `references/
|
|
17
|
-
| 用户提供 UUID 或提及已有剧本 | 游玩 | `references/
|
|
18
|
-
| 创作或游玩中出现字段相关问题 | — | `references/
|
|
16
|
+
| 用户想要创建 / 设计 / 构建故事 | 创作 | `references/adventure-crafting.md` |
|
|
17
|
+
| 用户提供 UUID 或提及已有剧本 | 游玩 | `references/adventure-playing.md` |
|
|
18
|
+
| 创作或游玩中出现字段相关问题 | — | `references/adventure-field-guide.md` |
|
|
19
19
|
| 意图模糊(提到类型但没有更多信息) | — | 只问一个问题:*「新建故事,还是游玩已有剧本?」* |
|
|
20
20
|
|
|
21
21
|
模式确定后不再重复询问。
|
|
@@ -25,19 +25,19 @@ description: Neta 奇遇剧本技能 - 创建和游玩 AI 驱动的交互式故
|
|
|
25
25
|
**创建剧本**
|
|
26
26
|
|
|
27
27
|
```bash
|
|
28
|
-
npx -y @talesofai/neta-skills
|
|
28
|
+
npx -y @talesofai/neta-skills create_adventure_campaign \
|
|
29
29
|
--name "汴京最后三天" \
|
|
30
30
|
--mission_plot "公元1127年,靖康元年十一月。金兵已兵临汴京城下..." \
|
|
31
31
|
--mission_task "在城破前查明密函来源和使者真实身份。" \
|
|
32
32
|
--mission_plot_attention "保持历史正剧质感。信息只通过调查获得,不主动透露。"
|
|
33
33
|
```
|
|
34
34
|
|
|
35
|
-
📖 [创作工作流](./references/
|
|
35
|
+
📖 [创作工作流](./references/adventure-crafting.md) — 先出草稿的循环、字段体系、质量自检。
|
|
36
36
|
|
|
37
37
|
**更新剧本**(只有提供的字段会被修改)
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
|
-
npx -y @talesofai/neta-skills
|
|
40
|
+
npx -y @talesofai/neta-skills update_adventure_campaign \
|
|
41
41
|
--campaign_uuid "campaign-uuid-here" \
|
|
42
42
|
--mission_plot_attention "更新后的统治规则..."
|
|
43
43
|
```
|
|
@@ -45,17 +45,17 @@ npx -y @talesofai/neta-skills update_travel_campaign \
|
|
|
45
45
|
**列出你的剧本**
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
|
-
npx -y @talesofai/neta-skills
|
|
49
|
-
npx -y @talesofai/neta-skills
|
|
48
|
+
npx -y @talesofai/neta-skills list_my_adventure_campaigns
|
|
49
|
+
npx -y @talesofai/neta-skills list_my_adventure_campaigns --page_index 0 --page_size 10
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
**获取剧本详情**
|
|
53
53
|
|
|
54
54
|
```bash
|
|
55
|
-
npx -y @talesofai/neta-skills
|
|
55
|
+
npx -y @talesofai/neta-skills request_adventure_campaign --campaign_uuid "campaign-uuid-here"
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
📖 [游玩工作流](./references/
|
|
58
|
+
📖 [游玩工作流](./references/adventure-playing.md) — 会话初始化、主动推进、方向操控机制。
|
|
59
59
|
|
|
60
60
|
## neta-creative 集成
|
|
61
61
|
|
|
@@ -65,7 +65,7 @@ npx -y @talesofai/neta-skills request_travel_campaign --campaign_uuid "campaign-
|
|
|
65
65
|
|
|
66
66
|
| 场景 | 文档 |
|
|
67
67
|
|------|------|
|
|
68
|
-
| 📝 创作工作流 | [
|
|
69
|
-
| 🎮 游玩工作流 | [
|
|
70
|
-
| 📋 字段语义 | [
|
|
71
|
-
| ✨ 跨类型完整范例 | [
|
|
68
|
+
| 📝 创作工作流 | [adventure-crafting.md](./references/adventure-crafting.md) |
|
|
69
|
+
| 🎮 游玩工作流 | [adventure-playing.md](./references/adventure-playing.md) |
|
|
70
|
+
| 📋 字段语义 | [adventure-field-guide.md](./references/adventure-field-guide.md) |
|
|
71
|
+
| ✨ 跨类型完整范例 | [adventure-examples.md](./references/adventure-examples.md) |
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
2. Agent 立即生成全部五个字段,行内标注假设。
|
|
25
25
|
3. 以可读散文(而非 JSON)呈现,附简短的「我假设了 X」说明。
|
|
26
26
|
4. 用户反馈 → Agent 只修改变化的字段,不大规模重写。
|
|
27
|
-
5. 用户明确确认 → 调用 `
|
|
27
|
+
5. 用户明确确认 → 调用 `create_adventure_campaign`。
|
|
28
28
|
|
|
29
29
|
**边缘情况**
|
|
30
30
|
- 对话中途转向 → 从对话历史综合信息,立即生成新草稿。
|
|
@@ -35,7 +35,7 @@
|
|
|
35
35
|
|
|
36
36
|
## 五个字段作为一个整体
|
|
37
37
|
|
|
38
|
-
生成前,参考 `
|
|
38
|
+
生成前,参考 `adventure-examples.md` 了解各类型的范例。
|
|
39
39
|
|
|
40
40
|
### `mission_plot` — 是什么
|
|
41
41
|
像开篇段落一样写,而非摘要。世界、情境、钩子。从「已经出了问题」开始——第一句话就是 AI 体验到的第一件事,它决定整个会话的氛围。
|
|
@@ -70,9 +70,9 @@ Victoria(绑定角色)有自己的议程;她提供信息但不解决问题
|
|
|
70
70
|
|
|
71
71
|
## 创建后
|
|
72
72
|
|
|
73
|
-
立即调用 `
|
|
73
|
+
立即调用 `request_adventure_campaign` 确认字段正确存储——尤其是 `mission_plot_attention`,它统治所有后续游玩会话。
|
|
74
74
|
|
|
75
|
-
首次试玩后,注意 AI 漂移的地方;用 `
|
|
75
|
+
首次试玩后,注意 AI 漂移的地方;用 `update_adventure_campaign` 在那些节点收紧 `mission_plot_attention`。
|
|
76
76
|
|
|
77
77
|
---
|
|
78
78
|
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
|
|
19
19
|
在第一个叙事词语之前,完成以下清单。
|
|
20
20
|
|
|
21
|
-
1. 通过 `
|
|
21
|
+
1. 通过 `request_adventure_campaign` 获取剧本。持有:`mission_plot`、`mission_task`、`mission_plot_attention`、`default_tcp_uuid`。
|
|
22
22
|
2. 如果存在 `default_tcp_uuid` → **检查 `request_character_or_elementum` 是否可用**。如果可用,加载完整档案。如果不可用,不要凭 UUID 捏造特质,直接继续。
|
|
23
23
|
3. 如果 neta-creative 可用 → **只问用户一次**:*「纯文字模式,还是在关键时刻生成场景图片?」* 记录偏好,之后不再询问。
|
|
24
24
|
4. 立即开始第一次推进。没有「准备好了吗?」——幕布升起。
|
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: neta-travel
|
|
3
|
-
description: Neta Travel Campaign skill - Create and play AI-driven interactive story adventures. Travel campaigns provide story-crafting and story-telling modes where agents act as DM and roleplay characters following plot, rules, and special guidelines.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Neta Travel Skill
|
|
7
|
-
|
|
8
|
-
Create and experience AI-driven interactive story adventures (Travel Campaigns). The agent serves as both Dungeon Master and character, guiding narrative experiences built on crafted plots, objectives, and governing rules.
|
|
9
|
-
|
|
10
|
-
## Mode Detection
|
|
11
|
-
|
|
12
|
-
Determine mode before acting. Do not ask multiple questions.
|
|
13
|
-
|
|
14
|
-
| Signal | Mode | Load |
|
|
15
|
-
|--------|------|------|
|
|
16
|
-
| User wants to create / design / build a story | Craft | `references/travel-crafting.md` |
|
|
17
|
-
| User provides UUID or refers to existing campaign | Play | `references/travel-playing.md` |
|
|
18
|
-
| Field question arises during craft or play | — | `references/travel-field-guide.md` |
|
|
19
|
-
| Ambiguous (genre mention, no further context) | — | Ask ONE question: *"Create a new story, or play one you've already made?"* |
|
|
20
|
-
|
|
21
|
-
Once mode is established, do not re-ask.
|
|
22
|
-
|
|
23
|
-
## Commands
|
|
24
|
-
|
|
25
|
-
**Create a campaign**
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
npx -y @talesofai/neta-skills create_travel_campaign \
|
|
29
|
-
--name "Raccoon General: Final Shift" \
|
|
30
|
-
--mission_plot "The last maintenance log entry is dated three weeks ago..." \
|
|
31
|
-
--mission_task "Survive the night. Find Dr. Strauss. Discover what Umbrella did." \
|
|
32
|
-
--mission_plot_attention "Maintain survival-horror dread. No graphic gore — horror through implication."
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
📖 [Craft workflow](./references/travel-crafting.md) — draft-first loop, field system, quality checklist.
|
|
36
|
-
|
|
37
|
-
**Update a campaign** (only provided fields are changed)
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
npx -y @talesofai/neta-skills update_travel_campaign \
|
|
41
|
-
--campaign_uuid "campaign-uuid-here" \
|
|
42
|
-
--mission_plot_attention "Updated governing rules..."
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
**List your campaigns**
|
|
46
|
-
|
|
47
|
-
```bash
|
|
48
|
-
npx -y @talesofai/neta-skills list_my_travel_campaigns
|
|
49
|
-
npx -y @talesofai/neta-skills list_my_travel_campaigns --page_index 0 --page_size 10
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
**Get campaign details**
|
|
53
|
-
|
|
54
|
-
```bash
|
|
55
|
-
npx -y @talesofai/neta-skills request_travel_campaign --campaign_uuid "campaign-uuid-here"
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
📖 [Play workflow](./references/travel-playing.md) — initialization, proactive advance, steering mechanics.
|
|
59
|
-
|
|
60
|
-
## neta-creative Integration
|
|
61
|
-
|
|
62
|
-
If `default_tcp_uuid` is present on a campaign, check whether `request_character_or_elementum` is available in the current skill set before attempting to load the character profile. Do not suggest installing neta-creative; check first, then proceed with or without it.
|
|
63
|
-
|
|
64
|
-
## Reference Documents
|
|
65
|
-
|
|
66
|
-
| Scenario | Document |
|
|
67
|
-
|----------|----------|
|
|
68
|
-
| 📝 Craft workflow | [travel-crafting.md](./references/travel-crafting.md) |
|
|
69
|
-
| 🎮 Play workflow | [travel-playing.md](./references/travel-playing.md) |
|
|
70
|
-
| 📋 Field semantics | [travel-field-guide.md](./references/travel-field-guide.md) |
|
|
71
|
-
| ✨ Worked examples across genres | [travel-examples.md](./references/travel-examples.md) |
|
|
File without changes
|