webnovel-query

Original：🇨🇳 Chinese
Translated

Queries project settings for characters, powers, factions, items, and foreshadowing. Supports urgency analysis and golden finger status. Activates when user asks about story elements or /webnovel-query.

6installs
Sourcelingfengqaq/webnovel-writer
Added on

NPX Install

npx skill4agent add lingfengqaq/webnovel-writer webnovel-query

Tags

Translated version includes tags in frontmatter
webnovel-querystory-element-analysisforeshadowing-urgencygolden-finger-trackingproject-data-management

SKILL.md Content (Chinese)

View Translation Comparison →

Information Query Skill

Project Root Guard (Must Confirm First)

  • Must be executed in the project root directory (
    .webnovel/state.json
    must exist)
  • If the file does not exist in the current directory, first ask the user for the project path and 
    cd
    into it
  • After entering, set the variable: 
    $PROJECT_ROOT = (Resolve-Path ".").Path
  • Forbidden to read or write project files under 
    .claude/

Workflow Checklist

Copy and track progress:
Information Query Progress:
- [ ] Step 1: Identify Query Type
- [ ] Step 2: Load Corresponding Reference Files
- [ ] Step 3: Load Project Data (state.json)
- [ ] Step 4: Confirm Sufficient Context
- [ ] Step 5: Execute Query
- [ ] Step 6: Format Output

Reference Loading Levels (strict, lazy)

  • L0: First identify the query type, do not preload all references.
  • L1: All queries only load the basic data flow specification.
  • L2: Only load corresponding thematic references based on query type.

L1 (minimum)

  • references/system-data-flow.md

L2 (conditional by query type)

  • Foreshadowing query: 
    references/advanced/foreshadowing.md
  • Pacing query: 
    ../webnovel-plan/references/strand-weave-pattern.md
  • Tag format query: 
    references/tag-specification.md
Do not load two or more L2 files unless the user request clearly spans multiple query types.

Step 1: Identify Query Type

KeywordQuery TypeRequired Loading
Character/Protagonist/Supporting CharacterStandard Querysystem-data-flow.md
Cultivation Realm/Foundation Establishment/Golden CoreStandard Querysystem-data-flow.md
Foreshadowing/Urgent ForeshadowingForeshadowing Analysisforeshadowing.md
Golden Finger/SystemGolden Finger Statussystem-data-flow.md
Pacing/StrandPacing Analysisstrand-weave-pattern.md
Tag/Entity FormatFormat Querytag-specification.md

Step 2: Load Corresponding Reference Files

All queries must execute:
bash
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-query/references/system-data-flow.md"
Additional execution for foreshadowing queries:
bash
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-query/references/advanced/foreshadowing.md"
Additional execution for pacing queries:
bash
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan/references/strand-weave-pattern.md"
Additional execution for tag format queries:
bash
cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-query/references/tag-specification.md"

Step 3: Load Project Data

bash
cat "$PROJECT_ROOT/.webnovel/state.json"

Step 4: Confirm Sufficient Context

Checklist:
  • Query type identified
  • Corresponding reference files loaded
  • state.json loaded
  • Know where to search for answers
If missing → Return to corresponding Step

Step 5: Execute Query

Standard Query

KeywordSearch Target
Character/Protagonist/Supporting Characterprotagonist-card.md, character-library/
Cultivation Realm/Powerpower-system.md
Clan/Factionworldview.md
Item/Treasureitem-library/
Location/Secret Realmworldview.md

Foreshadowing Urgency Analysis

Three-Tier Classification (from foreshadowing.md):
  • Core Foreshadowing: Main Plot - Weight 3.0x
  • Side Foreshadowing: Supporting Character/Side Plot - Weight 2.0x
  • Decorative Foreshadowing: Atmosphere/Details - Weight 1.0x
Urgency Formula:
Urgency = (Chapters Passed / Target Chapters) × Tier Weight
Status Determination:
  • 🔴 Critical: Exceeds target OR Core >20 chapters
  • 🟡 Warning: >80% of target OR Side >30 chapters
  • 🟢 Normal: Within planned range
Quick Analysis:
bash
python "${CLAUDE_PLUGIN_ROOT}/scripts/status_reporter.py" --focus urgency --project-root "$PROJECT_ROOT"

Golden Finger Status

Output includes:
  • Basic information (Name/Type/Activation Chapter)
  • Current level and progress
  • Unlocked skills and cooldowns
  • Preview of upcoming unlocked skills
  • Upgrade conditions
  • Development suggestions

Strand Pacing Analysis

Quick Analysis:
bash
python "${CLAUDE_PLUGIN_ROOT}/scripts/status_reporter.py" --focus strand --project-root "$PROJECT_ROOT"
Check Warnings:
  • Quest >5 consecutive chapters
  • Fire >10 chapters without appearance
  • Constellation >15 chapters without appearance

Step 6: Format Output

markdown
# Query Result: {Keyword}

## 📊 Overview
- **Match Type**: {type}
- **Data Source**: state.json + Setting Documents + Outline
- **Match Count**: X entries

## 🔍 Detailed Information

### 1. Runtime State (state.json)
{Structured Data}
**Source**: `.webnovel/state.json` (lines XX-XX)

### 2. Setting Document Match Results
{Matching content, including file path and line numbers}

## ⚠️ Data Consistency Check
{Differences between state.json and static files}