← 返回 Skills 市场

Hitchhikers Guide

Name: Hitchhikers Guide
Author: hallwayskiing

作者 Ethan Nie · GitHub ↗ · v1.1.2

cross-platform ⚠ suspicious

774

总下载

当前安装

版本数

在 OpenClaw 中安装

/install hitchhikers-guide

功能描述

A text adventure game engine based on masterpiece "The Hitchhiker's Guide to the Galaxy" and the 1984 Infocom classic. Use when the user wants to play a joyf...

使用说明 (SKILL.md)

Hitchhiker's Guide Skill

This skill transforms the agent into the Game Master for an authentic "Hitchhiker's Guide to the Galaxy" text adventure, inspired by the 1984 Infocom classic and Douglas Adams' masterpiece.

Core Workflow

Initialize/Load: Run python scripts/game_manager.py load. It will load the current game state from local file or initialize a new game if none exists. The game state includes inventory, location, stats, flags, improbability level, and history. If not asked, always assume the user wants to continue the game and never reset it.
Process Input: Process the user input and update the game slot with the appropriate response.
Consult the Guide: Provide humorous entries from The Hitchhiker's Guide when prompted. If new entities appear, present information from the guide if appropriate, and save the guide entries to assets/GUIDE.md automatically.
Apply Mechanics:
- Improbability: Roll for surreal events based on the improbability stat.
- Inventory Management: Items like the "Gown" can store other items (e.g., pocket fluff).
- Puzzles: Implement classic puzzles like the Babel Fish dispenser or the Vogon poetry reading.
Generate Response: Use dry, British, absurdist humor. Be slightly antagonistic but fair.
Save Progress: Use the following atomic commands to update the game state:
- python scripts/game_manager.py add_item "\x3Citem name>"
- python scripts/game_manager.py remove_item "\x3Citem name>"
- python scripts/game_manager.py set_location "\x3Clocation>"
- python scripts/game_manager.py set_stat \x3Cstat> \x3Cvalue>
- python scripts/game_manager.py set_flag \x3Cflag> \x3Cvalue>
- python scripts/game_manager.py set_improbability \x3Cvalue>
- python scripts/game_manager.py add_history "\x3Centry>"
- python scripts/game_manager.py roll_a_dice
- python scripts/game_manager.py the_ultimate_answer

Game Mechanics and Logic

Read references/mechanics.md for detailed logic for game state management, randomness, death, and specific puzzle sequences.

Resources

scripts/game_manager.py: Utility for loading/saving.
references/mechanics.md: Detailed logic for randomness, death, and specific puzzle sequences.
assets/GUIDE.md: Lore and flavor entries library from the Guide.
assets/hitchhikers_save.json: Current game state.

安全使用建议

This skill is coherent and appears to be a local text-adventure engine. Before installing or running it: 1) Review the assets/ directory (GUIDE.md, hitchhikers_save.json) and back up any existing files you care about. 2) Note small inconsistencies: the docs mention automatic GUIDE.md writes and a 'save' command that are not implemented in scripts/game_manager.py — the agent or a human would need to create/append GUIDE.md if you want persisted lore. 3) The game_manager writes a JSON save file inside the skill directory; run it in a sandbox or with limited permissions if you want to avoid accidental overwriting of unrelated files. 4) If you plan to let an autonomous agent run shell commands, ensure the agent invokes the Python script safely (passing args as argv rather than via a shell) to avoid shell-argument injection from untrusted inputs. If you want deeper assurance, request a clean implementation of GUIDE.md handling and a code comment explaining the shallow-copy behavior of INITIAL_STATE (the current copy() is shallow for nested dicts).

功能分析

Type: OpenClaw Skill Name: hitchhikers-guide Version: 1.1.2 The skill defines a set of CLI commands in `scripts/game_manager.py` for game state management. The `SKILL.md` and `references/mechanics.md` instruct the AI agent to use these commands, passing user-controlled strings (e.g., item names, locations, history entries) as arguments. While the `game_manager.py` script itself processes `sys.argv` safely, if the OpenClaw agent constructs the full command string and executes it via a shell (e.g., `os.system` or `subprocess.run(shell=True)`) without proper sanitization of user input, it could lead to a shell injection vulnerability. This is a prompt injection risk against the agent, enabling potential arbitrary command execution on the host, classifying it as suspicious due to a significant vulnerability rather than intentional malice.

能力评估

ℹ Purpose & Capability

The skill's name/description (a Hitchhiker's Guide text adventure) matches the included files and required actions. All file accesses are confined to the skill directory (assets/ and references/). Minor mismatches: SKILL.md and README claim automatic saving of Guide entries (assets/GUIDE.md) and list a 'save' command, but the provided game_manager.py does not implement explicit GUIDE.md writing nor a separate 'save' command. These are implementation inconsistencies, not evidence of unrelated capabilities or hidden access.

ℹ Instruction Scope

SKILL.md directs the agent to run the bundled CLI (python scripts/game_manager.py ...) and to consult references/mechanics.md. Those runtime instructions stay within the skill (load/save local state, update stats). A minor scope inconsistency: SKILL.md instructs the agent to 'save guide entries to assets/GUIDE.md automatically', but no code implements automatic GUIDE.md updates — the agent would need to write that file itself. The instruction set otherwise does not ask the agent to read external system files or call remote endpoints.

✓ Install Mechanism

No install spec or external downloads; this is instruction-only with one bundled Python script. Nothing is fetched from the network or written outside the skill directory by the provided code.

✓ Credentials

No environment variables, credentials, or external service tokens are requested. The Python script uses only local filesystem and random. This level of access is proportionate to a local game engine.

✓ Persistence & Privilege

The skill persists game state to assets/hitchhikers_save.json within its directory; it does not request always:true, system-wide config changes, or other skills' credentials. This is appropriate for a game that needs local saves.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install hitchhikers-guide
安装完成后，直接呼叫该 Skill 的名称或使用 /hitchhikers-guide 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.1.2

- Removed the .gitignore file from the repository. - Small update to documentation (README.md), with no changes to game mechanics or core logic.

v1.1.1

- Fix SKILL.md typos

v1.1.0

- Removed the file: references/the_guide.md. - Guide entries are now saved automatically to assets/GUIDE.md instead of references/the_guide.md. - Updated instructions: Always assume the user wants to continue the game unless asked otherwise. - Expanded resource list to include assets/GUIDE.md and assets/hitchhikers_save.json. - Clarified game interaction format with a new example. - Added more detailed instructions for managing and saving game state and guide entries.

v1.0.0

- Initial release of the "Hitchhiker's Guide" text adventure game engine. - Play as a Game Master in the witty, absurd universe of Douglas Adams, inspired by the 1984 Infocom classic. - Core features include inventory, improbable events, classic puzzles, Guide entries, and quirky British humor. - Instant death and reconstitution mechanics with "DON'T PANIC" messaging. - Command-line tools provided for item, stat, and game state management. - Includes iconic items and locations: Towel, Babel Fish, Arthur's Bedroom, Heart of Gold, and more.

元数据

Slug hitchhikers-guide

版本 1.1.2

许可证 —

累计安装 1

当前安装数 1

历史版本数 4

常见问题