rpg-roadmap

rpg-roadmap is a skill for Claude Code, Codex from recca0120/code-quest. It costs 78 tokens per session (1,637 once invoked), scanned A, original, MIT.

A future-design document for turning a Claude Code web client into an RPG-style interface. It describes proposed game elements such as maps, battles, companions, shops, worktrees, and experience points, but says these features are not implemented.

In plain words
What is it for?
Use it when discussing or designing possible RPG features, reviewing the long-term direction, or reading legacy interface-design documents.
Why use it?
It separates a long-term product idea from the application’s current architecture, reducing the risk of treating planned features as existing behavior.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/recca0120/code-quest/rpg-roadmap
Any agent
npx skills add recca0120/code-quest --skill rpg-roadmap
Clone the repo
git clone --depth 1 https://github.com/recca0120/code-quest

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for rpg-roadmap

README.md
[![agentmods](https://agentmods.dev/badge/skills/recca0120/code-quest/rpg-roadmap.svg)](https://agentmods.dev/skills/recca0120/code-quest/rpg-roadmap)
Your own site
<a href="https://agentmods.dev/skills/recca0120/code-quest/rpg-roadmap"><img src="https://agentmods.dev/badge/skills/recca0120/code-quest/rpg-roadmap.svg" alt="Measured on agentmods" height="20"></a>
Per session 78 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,637 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00078 $0.01637
Opus 5 $0.00039 $0.00818
Sonnet 5 $0.00016 $0.00327
Haiku 4.5 $0.00008 $0.00164

Measured 3d ago against content hash 0b0bd2a92b39, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

rpg-roadmap scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/rpg-roadmap/SKILL.md · 133 lines

How it starts

The opening of the file, as written. The whole thing — 133 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Code Quest — RPG Roadmap(尚未實作)

⚠️ 這份是願景,不是現況。 cc-office 目前是 Claude Code web client(見 project-overview)。本 skill 描述「如果未來加上 RPG 層」該長什麼樣。遇到現況跟此處衝突:現況優先

核心概念

把 Claude Code 使用體驗包裝成 RPG — 不修改 Claude 核心,只在 UI 層加遊戲化:

  • ✅ 分層架構:遊戲化在 UI 層
  • ✅ 尊重官方:Skills / Subagents 符合官方規範
  • ✅ 漸進增強:保留原始功能
  • ✅ Metadata 驅動:易擴展

AI → RPG 元素映射

AI 交互 RPG 元素 說明
用戶 冒險者 / 玩家 主角
Claude / Gemini NPC 導師 / 魔法師 AI 助手
Skills 技能 / 魔法 執行功能的方式
Subagents 戰鬥夥伴 協同作戰
對話任務 Quest 任務系統
API 配額 HP 生命值
Token 消耗 MP 魔力值
經驗累積 EXP / 等級 成長系統
任務完成 戰鬥勝利 獎勵機制

CodeLand 世界結構

CodeLand 世界
├── 🏰 城鎮區域(安全區)
│   ├── 商業街(7 商店:技能、工匠、MCP、傭兵、寶物、訓練、錢莊)
│   ├── 酒館(AI 對話,不消耗 MP)
│   ├── 靜止之間(Plan Mode)
│   ├── 公會大廳(Worktree 管理)
│   └── 玩家住所(休息、設定)
│
├── 🌲 野外區域(危險區)
│   ├── 森林 (Lv.5-8)
│   ├── 山脈 (Lv.8-12)
│   ├── 荒野 (Lv.12-15)
│   └── 火山 (Lv.15+)
│
└── 🏔️ 副本區域(特殊任務)
    ├── Bug 洞窟
    ├── 架構迷宮
    ├── 測試試煉場
    └── 安全地牢

核心系統(11 個)

L0 基礎系統

  1. 地圖系統:三大區域、場所管理、遭遇戰
  2. 場景系統:探索 / 戰鬥模式切換
  3. 商店系統:7 大商店、功能管理
  4. Worktree 系統:平行世界、分支管理

L1-L2 核心玩法

  1. 戰鬥系統:回合制、敵人生成
  2. 夥伴系統:Subagent 映射、協同戰鬥
  3. 召喚獸系統:4 種召喚、爆發支援
  4. 互動事件:戰鬥事件、工具映射

L3-L4 進階功能

  1. 非同步戰鬥:並發戰鬥、智能路由
  2. 多模型整合:Claude / Gemini 切換
  3. UI 互動:完整 UI 規範、動畫

資源機制

資源 對應 恢復
HP(生命值) API 配額 探索 2 HP/s;戰鬥 0.1 HP/s
MP(魔力值) Token 消耗 探索 1 MP/s;戰鬥 0.1 MP/s
EXP(經驗值) 成長系統 任務完成;升級公式 100 * (1.5 ^ (level - 1))
Gold(金幣) 遊戲貨幣 任務獎勵;購買道具 / 升級技能

戰鬥觸發機制

依 Prompt 複雜度自動判斷:

  • 0-2 分:對話型 → 不觸發戰鬥(酒館模式)
  • 3-7 分:簡單任務 → 主目錄同步戰鬥
  • 8+ 分:複雜任務 → 建 Worktree 異步戰鬥

視覺風格

Pixel Art:復古、8-bit/16-bit、像素字體(Press Start 2P)、像素動畫(攻擊、升級)

配色

情境 色碼
探索模式 綠色 #1a4d2e
戰鬥模式 紅色 #4d1a1a
HP 綠色 #4caf50
MP 藍色 #2196f3
EXP 金色 #ffc107

關鍵設計文檔

深入個別系統時參照(都是設計稿,非驗證過的 spec):

  • 總覽:docs/ui-design/00-OVERVIEW.md
  • 系統架構:docs/ui-design/01-SYSTEM-ARCHITECTURE.md
  • 世界地圖:docs/ui-design/02-WORLD-MAP.md
  • 核心機制:docs/ui-design/03-CORE-MECHANICS.md
  • 遊戲流程:docs/ui-design/04-GAME-FLOW.md
  • 戰鬥管理:docs/ui-design/05-BATTLE-MANAGEMENT.md

Read the full file on GitHub · 133 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 133 lines · 78 tokens per session scan A 0b0bd2a92b39

Subscribe to this mod's changes

rpg-roadmap is a skill published in the GitHub repository recca0120/code-quest (11 stars, last pushed 2mo ago), licensed MIT. It adds 78 tokens to every session and 1,637 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.