dicepp-shell

Test DicePP chat commands in named sessions with fixed dice sequences.

34|12|Updated Aug 1, 2021
One-click install
npx skills add https://github.com/pear-studio/nonebot-dicepp --skill dicepp-shell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dicepp-shell
Source: https://github.com/pear-studio/nonebot-dicepp/tree/main/docs/agent/skills/dicepp-shell
Command: npx skills add https://github.com/pear-studio/nonebot-dicepp --skill dicepp-shell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You need a fast way to verify that DicePP bot commands, dice results, and role/card workflows behave correctly before shipping or integrating changes.

Core Features & Use Cases

  • Interactive session testing: Create and manage named sessions to run multi-step TRPG scenarios consistently.
  • Deterministic dice control: Use a predefined dice sequence to make outcomes reproducible for acceptance testing.
  • Command-level verification: Validate common flows like rolling dice, initiative,角色卡 creation, and HP updates using real chat commands.
  • Debug-friendly output: Optionally request JSON output to inspect structured results during tests.

Quick Start

Start a test session and send the roll command with a fixed dice outcome: run uv run dicepp-shell start test followed by uv run dicepp-shell send test --user player1 --msg ".r 1d20 攻击" --dice 20.

Frequently Asked Questions about dicepp-shell

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test TRPG bot commands with deterministic dice rolls?

You can test TRPG bot commands deterministically by starting a named session and passing a predefined dice sequence to ensure reproducible outcomes for acceptance testing. This verifies dice rolls, initiative flows, and HP updates consistently.

What is deterministic session-based testing for TRPG chat commands?

Deterministic session-based testing for TRPG chat commands involves creating managed sessions that execute multi-step scenarios with fixed dice outcomes and optional JSON output to inspect structured results during development.

How do I send a DicePP roll command to a specific test session?

Send a DicePP roll command by starting a session and executing a send command with the session name, user, message, and a fixed dice value. This applies real chat commands to validate role card creation and combat flows.

Do I need a preconfigured project environment to run session-based TRPG tests?

Yes, session-based TRPG testing requires a preconfigured project environment where the testing shell can start and send commands to a named session for development-time verification of bot behavior.

Can I get JSON output from TRPG dice roll testing for debugging?

Yes, you can request JSON output during TRPG dice roll testing to inspect structured results. This debug-friendly format helps verify command-level logic and state updates accurately during development.

What's the best way to verify role card creation and HP updates in a TRPG bot?

The best way to verify role card creation and HP updates is using a deterministic testing shell that applies real chat commands to a managed session, ensuring reproducible state changes before shipping changes.