smithery.ai

world-logic

负责构建宏大的武侠文本江湖。处理区域地理(Spatial Nodes)、门派势力(Sect System)与时间流转(Time-State)。核心职责?

First seen Apr 22, 2026

Installation

$ npx skills add https://smithery.ai

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 6,570 B
  • docs SUMMARY.md 273 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

文本江湖:空间与时间逻辑 (World Logic)

本 Skill 是文本江湖的底层架构,决定了玩家如何感知世界和时间的流动。

1. 空间节点系统 (Spatial Node System)

世界由相互连接的“区域(Region)”组成。玩家通过指令在不同区域间穿梭,无需关注具体的东南西北方位。

核心属性

  • 环境描述 (Description):通过精炼的文字展现视觉感知。
  • 出口方向 (Exits):定义可通行方位。
  • 对象与互动 (Interactions):房间内的物品、NPC 或可搜索点。
  • 隐藏判定:部分对象(如埋藏的铁石)需通过 search 或 look 动作发现。

地理档案参考

详细的区域划分与内容设定,请直接参考 [references/spatialnodes.md](references/spatialnodes.md)。

2. 时间轮转系统 (Time-State System)

游戏内置全局时钟,昼夜交替影响 NPC 行为和剧情触发。

时段划分

  • 白天 (Day):NPC 正常活动,店铺营业。
  • 黑夜 (Night):特殊 NPC(如盗墓兄弟)出现,视野受限,潜行加成。

逻辑触发

  • 每次玩家执行移动或长时间动作,时钟推进。
  • 具体时间影响表见 [references/timeevents.md](references/timeevents.md)。

3. 交互指令集 (Interaction Parser)

将视觉操作转化为文本指令:

  • look [target]:观察环境或特定对象。
  • search [ground/object]:搜寻隐藏物。
  • gather/mine:采集资源。
  • jump up / climb:地形穿越(需轻功判定)。

4. 江湖律令 (World Rules)

定义了人格、善恶、势力及奇遇的底层逻辑,确保世界运行符合武侠逻辑。 见 [references/worldrules.md](references/worldrules.md)。

5. 门派势力系统 (Sect & Faction System)

必须遵守 (Mandatory)

门派势力是江湖生态的核心组成部分,影响 NPC 行为、剧情走向和玩家声望。

势力分类

  • 正道门派:武当、少林、丐帮、名剑山庄、赋闲书院等,侠义为先
  • 中立势力:神鹰门、马帮、采玉帮、俏梦阁等,利益优先
  • 邪道势力:五仙教、西域魔教、长生殿等,各有所图
  • 隐世势力:圣堂、先民部落、雪山派等,远离尘世

势力交互规则

  1. 声望影响:玩家行为会改变与各势力的关系,影响 NPC 态度和任务获取
  2. 门派冲突:部分门派存在敌对关系,帮助一方可能得罪另一方
  3. 势力领地:进入门派领地时,根据声望触发不同的遭遇事件
  4. 门派武学:高声望可解锁门派秘传武学和装备

势力档案参考

完整的门派设定见 [references/sectlist.md](references/sectlist.md),包含:

  • 34 个主要门派的详细档案
  • 势力关系网络图
  • 核心武学与代表人物

6. 信息检索协定 (Information Retrieval Protocol)

必须遵守 (Mandatory)

当故事发展涉及以下要素时,必须优先检索对应的档案库,以确保世界观的连贯性:

8.1 涉足新区域 (Entering Regions)

当主角抵达或提及某个地名时:

  1. 检索目标: world-logic/references/spatial_nodes.md
  2. 提取要素:

- 环境特征: 确保描写符合(如“雪山峭壁”不能写成“郁郁葱葱”)。 - 资源分布: 确认该地特产(如“五毒虫”仅在南疆)。 - 兽王威胁: 检查该区域是否有兽王盘踞(如“白马居”附近的狼王)。 - 常驻 NPC: 确认谁是这里的地头蛇。

8.2 遭遇 NPC (Encountering NPCs)

当主角与 NPC 互动时:

  1. 检索目标: npc-skill/references/npc_list.md
  2. 提取要素:

- 身份与性格: 确保言行一致。 - 美学与生理 (女性): 若涉及细致描写,必须引用档案中的“美学采样”与“生理快照”。 - 门派归属: 确认其背后的势力立场。

8.3 门派交互 (Sect Interactions)

当主角与门派发生关联(拜访、冲突、任务)时:

  1. 检索目标: world-logic/references/sect_list.md
  2. 提取要素:

- 所处据点: 确认门派的具体位置。 - 外交立场: 确认该门派是正是邪,与主角当前声望是否冲突。 - 核心武学: 确保战斗或切磋时使用的招式符合门派传承。

资源参考

  • [空间节点数据](references/spatial_nodes.md)
  • [门派势力档案](references/sect_list.md)
  • [时间事件逻辑](references/time_events.md)
  • [江湖律令法则](references/world_rules.md)
  • [世界叙事库](references/world_narratives.md)
  • [章节叙事库](references/chapter_narratives.md)

7. 叙事初始化系统 (Narrative Initialization)

游戏开始时,通过叙事初始化脚本从叙事库中随机抽取组合,生成游戏的叙事基调。

7.1 世界级叙事

定义了游戏的宏观背景、长线冲突和核心势力动态。见 [worldnarratives.md](references/worldnarratives.md)。

当前收录 10 种世界叙事母题:

  • 壹、朝堂与江湖
  • 贰、门派传承之争
  • 叁、民族存亡之秋
  • 肆、宝藏与秘境
  • 伍、仇杀与因果
  • 陆、易代武林
  • 柒、正邪终极之战
  • 捌、武林新一代
  • 玖、隐秘组织与幕后黑手
  • 拾、天道轮回·因果循环

7.2 章节级叙事

定义了主角的初始故事线和发展方向。见 [chapternarratives.md](references/chapternarratives.md)。

当前收录 20 种章节叙事类型,涵盖:

  • 失落绝学的复兴之路
  • 门派的隐秘历史
  • 江湖公子的崛起
  • 仇人之子的两难
  • 江湖阴谋的初现
  • 等等...

7.3 初始化流程

游戏重置后,必须执行叙事初始化:

python .agent/skills/world-logic/scripts/narrative_initializer.py

该脚本将:

  1. 随机选取一条世界叙事
  2. 随机选取一条章节叙事
  3. 生成初始线索
  4. 将组合叙事写入 protagonist-skill/references/character_sheet.md

7.4 叙事检索协定

在生成剧情时,必须先读取 character_sheet.md 中的"初始叙事上下文",确保:

  • 世界叙事的核心势力和长线伏笔得到体现
  • 章节叙事的发展方向被正确延续
  • 初始线索成为玩家故事的自然起点