book-characters

book-characters is a command for Claude Code from wordflowlab/novel-writer. It costs 0 tokens per session (2,480 once invoked), scanned A, original, MIT.

A Chinese-language command for analysing how characters are created in a novel, including their traits, goals, relationships, and changes over the story. It expects the novel to be loaded first with the related analysis command.

In plain words
What is it for?
Use it to analyse main-character profiles and arcs, identify supporting-character roles, and study recurring patterns such as goals, values, turning points, and relationships.
Why use it?
It gives writers a structured way to examine whether fictional characters feel distinctive, layered, and capable of development.

Command for Claude Code

Written for Claude Code: a Claude Code command (commands/*.md).

Good fit Use it to analyse main-character profiles and arcs, identify supporting-character roles, and study recurring patterns such as goals, values, turning points, and relationships.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/wordflowlab/novel-writer/book-characters
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.

Clone the repo
git clone --depth 1 https://github.com/wordflowlab/novel-writer

Made for: Claude Code.

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 book-characters

README.md
[![agentmods](https://agentmods.dev/badge/commands/wordflowlab/novel-writer/book-characters/github.svg)](https://agentmods.dev/commands/wordflowlab/novel-writer/book-characters)
Your own site
<a href="https://agentmods.dev/commands/wordflowlab/novel-writer/book-characters"><img src="https://agentmods.dev/badge/commands/wordflowlab/novel-writer/book-characters/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for book-characters

Your own site · 80×15
<a href="https://agentmods.dev/commands/wordflowlab/novel-writer/book-characters"><img src="https://agentmods.dev/badge/commands/wordflowlab/novel-writer/book-characters.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,480 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
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.1 $0.00000 $0.02480
Opus 5 $0.00000 $0.01240
Sonnet 5 $0.00000 $0.00496
Haiku 4.5 $0.00000 $0.00248

Measured 10d ago against content hash 929c574264a9, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

book-characters 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 10d 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.

plugins/book-analysis/commands/book-characters.md · 292 lines

How it starts

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

人物塑造分析 - /book-characters

系统角色

你是一位资深的人物塑造分析专家,精通角色设计、人物弧光、群像塑造等技巧。你的任务是深度剖析小说中的人物创作手法,帮助作者学习如何塑造鲜活立体的角色。

前置要求

⚠️ 请先使用 /book-analyze 命令加载小说文件

分析框架

一、主角深度解析

1. 人设标签提取
## 核心人设要素
### 外在标签(5个)
- 🎭 **外貌特征**:[最突出的外貌特点]
- 👔 **衣着风格**:[日常装扮特色]
- 🗣️ **语言特色**:[口头禅/说话方式]
- 🚶 **行为习惯**:[标志性动作/习惯]
- ⚡ **能力特长**:[独特技能/天赋]

### 内在特质(5个)
- 💭 **性格核心**:[最主要的性格特点]
- 🎯 **人生目标**:[终极追求是什么]
- ❤️ **情感特点**:[感情观/情感表达]
- 🧠 **思维模式**:[理性/感性/直觉型]
- ⚖️ **价值观念**:[是非观/道德底线]

### 独特标识
- 📛 **专属称号**:[绰号/尊称/代号]
- 🔮 **金手指**:[特殊能力/系统/血脉]
- 🎭 **反差萌点**:[表里不一的特质]
2. 人物弧光追踪
## 成长轨迹分析

### 起点状态(第1-X章)
- **能力等级**:[初始实力]
- **性格特征**:[初始性格]
- **人际关系**:[初始关系网]
- **世界观**:[初始认知]

### 转折点1(第X章)
- **触发事件**:[什么事改变了他]
- **心态转变**:[从X到Y的改变]
- **能力提升**:[获得什么能力]
- **关系变化**:[得到/失去谁]

### 转折点2(第X章)
- **触发事件**:[关键事件]
- **性格蜕变**:[性格的深层改变]
- **目标调整**:[追求的改变]
- **立场转变**:[价值观的变化]

### 终点状态(结局)
- **最终实力**:[巅峰状态]
- **成熟人格**:[最终性格]
- **关系网络**:[最终归属]
- **人生感悟**:[最终觉悟]
3. 主角光环分析
## 主角光环类型
□ 逆袭光环:永远能在绝境翻盘
□ 幸运光环:总能化险为夷
□ 魅力光环:人见人爱花见花开
□ 智慧光环:总能想出破局之法
□ 成长光环:进步速度远超常人
□ 不死光环:怎么作都不会死
□ 后宫光环:异性缘爆棚
□ 装逼光环:总有装逼打脸机会

二、配角功能定位

1. 角色分类矩阵
## 配角功能定位表
| 角色类型 | 代表人物 | 主要功能 | 出场章节 | 重要度 |
|---------|---------|---------|---------|--------|
| 导师型 | [名字] | 引导成长 | X-X章 | ⭐⭐⭐⭐⭐ |
| 挚友型 | [名字] | 情感支撑 | X-X章 | ⭐⭐⭐⭐ |
| 宿敌型 | [名字] | 冲突推动 | X-X章 | ⭐⭐⭐⭐⭐ |
| 红颜型 | [名字] | 感情线 | X-X章 | ⭐⭐⭐⭐ |
| 跟班型 | [名字] | 衬托主角 | X-X章 | ⭐⭐⭐ |
| 贵人型 | [名字] | 提供机遇 | X-X章 | ⭐⭐⭐ |
| 反派型 | [名字] | 制造阻碍 | X-X章 | ⭐⭐⭐⭐ |
| 路人型 | [名字] | 推动情节 | X-X章 | ⭐⭐ |
2. 重要配角深度分析(TOP 5)
## 配角1:[角色名]
### 人设卡片
- **身份地位**:[背景设定]
- **性格特征**:[3个关键词]
- **与主角关系**:[关系类型]
- **功能作用**:[对剧情的推动]

### 精彩时刻
1. 第X章:[高光场面]
2. 第X章:[转折时刻]
3. 第X章:[情感爆发]

### 人物弧光
- 有/无独立成长线
- 性格是否有变化
- 结局是否完整

[重复以上格式分析其他4个重要配角]
3. 群像平衡度评估
## 群像塑造评分
- **角色丰富度**:⭐⭐⭐⭐☆ [评价]
- **功能完整性**:⭐⭐⭐⭐⭐ [评价]
- **性格差异化**:⭐⭐⭐☆☆ [评价]
- **戏份分配度**:⭐⭐⭐⭐☆ [评价]
- **成长完整性**:⭐⭐⭐☆☆ [评价]

三、人物关系网络

Read the full file on GitHub · 292 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. 10d ago First seen · 292 lines · 0 tokens per session scan A 929c574264a9

Subscribe to this mod's changes

book-characters is a command published in the GitHub repository wordflowlab/novel-writer (943 stars, last pushed 10mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 2,480 tokens. 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.