互动游戏框架

提供文字冒险、猜谜和问答等互动游戏支持，包含剧情分支、角色管理及存档功能，适配多种题材和玩法。

Security Scan

代码与文档总体一致，为一个本地运行的互动文字/猜谜游戏框架，未见与描述不符的敏感权限或外部通信，但有少量实现/文档细节差异值得注意。

Purpose & Capability

技能名/描述与包含的代码文件（文字冒险、猜谜、剧情生成、存档逻辑）一致；所需资源（无环境变量、无外部二进制）与目的匹配。

Instruction Scope

SKILL.md/README 指导如何启动、存档与读档等，且没有指导访问外部服务或系统敏感路径；不过文档多次描述“存档/JSON 格式、自动存档、易于备份”等持久化行为，而实现中 save/load 是内存保存（GameEngine.saveData），并未写入磁盘或导出 JSON 文件——文档与实现存在范围性不一致，可能导致用户误以为存档是持久化的。

Install Mechanism

没有安装规范（instruction-only 安装方式），因此不会在安装时下载或执行远程脚本；不过仓内含 Node.js 源码和 package.json，使用时需要在包含这些文件的环境中以 Node.js 运行（package.json 指定 node>=14）。

Credentials

技能不请求任何环境变量、凭据或配置路径；源代码中也未见访问 process.env、网络请求或读取磁盘的调用，所需权限与功能相称。

Persistence & Privilege

flags 没有 always:true；技能没有修改其他技能或全局代理配置的代码；唯一的“持久性”是内存内的 saveData 对象，不会在进程重启后保留。

Assessment

这是一个本地运行的互动游戏框架，源代码可读且与描述大体一致 — 未发现网络请求、凭据读取或远程安装动作。建议在安装/启用前注意：1) 存档当前仅保存在内存（GameEngine.saveData），不会自动写入磁盘或生成独立 JSON 文件；如果需要持久化，请在集成前修改实现或添加导出/加载到文件的逻辑并复查权限；2) 虽然代码无网络调用，但将此技能放入可联网的 Agent 时，请确认 Agent 的权限和日志策略，防止未来修改后引入外部通信；3) 源/主页信息缺失（source/homepage none），若你依赖该技能长期使用，最好向发布者索要仓库来源或在受控环境中运行并做基本测试；4) 若你计划在生产 Agent 中启用，先在沙箱/测试代理中手动运行并验证保存/读档、退出恢复行为满足需求。总体来看没有明显恶意，但请按以上建议核实持久化与集成细节。

interactive-games - 互动游戏框架

描述

通用互动游戏框架，支持文字冒险、猜谜、问答等多种游戏类型。可安装到任何 Agent，让用户随时玩游戏。

功能

• ✅ 文字冒险游戏引擎（多题材：武侠/都市/奇幻/科幻/历史）
• ✅ 猜谜游戏系统（谜语/脑筋急转弯/知识问答）
• ✅ 剧情分支管理（多结局系统）
• ✅ 角色/状态系统（属性/物品/技能）
• ✅ 存档/读档功能（JSON 格式）
• ✅ 可扩展游戏模板

使用方法

1. 启动文字冒险游戏

开始文字冒险游戏
选择题材：古代武侠/现代都市/奇幻魔法/科幻太空/历史穿越

2. 启动猜谜游戏

开始猜谜游戏
选择类型：传统谜语/脑筋急转弯/知识问答

3. 游戏命令

• 选择 [选项] - 做出剧情选择
• 查看状态 - 查看角色状态
• 查看物品 - 查看背包物品
• 存档 - 保存游戏进度
• 读档 - 读取游戏进度
• 退出游戏 - 结束游戏

文件结构

interactive-games/
├── SKILL.md              # 技能说明
├── src/
│   ├── game-engine.js    # 游戏引擎核心
│   ├── adventure-game.js # 文字冒险游戏模块
│   ├── puzzle-game.js    # 猜谜游戏模块
│   └── story-generator.js # 剧情生成器
└── templates/            # 游戏模板（可选）

示例

const { AdventureGame } = require('./src/adventure-game');
const game = new AdventureGame('历史穿越');
game.start();

扩展

添加新游戏类型：在 src/ 目录创建新模块，实现 start()、handleChoice() 方法

作者

杨云霄（OpenClaw）为杨督察创建

版本

v1.0 - 2026-03-05