track

track is a command for Claude Code from wordflowlab/novel-writer. It costs 12 tokens per session (1,633 once invoked), scanned A, original, MIT.

A command for tracking the progress and consistency of a novel across its writing, plot, timeline, characters, relationships, and unresolved clues.

In plain words
What is it for?
Use it to view writing statistics, inspect plot or character status, validate story records, and apply supported automatic fixes.
Why use it?
It brings scattered story records into one status report and can check for contradictions or simple problems.

Command for Claude Code

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

Good fit Use it to view writing statistics, inspect plot or character status, validate story records, and apply supported automatic fixes.

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

README.md
[![agentmods](https://agentmods.dev/badge/commands/wordflowlab/novel-writer/track.svg)](https://agentmods.dev/commands/wordflowlab/novel-writer/track)
Your own site
<a href="https://agentmods.dev/commands/wordflowlab/novel-writer/track"><img src="https://agentmods.dev/badge/commands/wordflowlab/novel-writer/track.svg" alt="Measured on agentmods" height="20"></a>
Per session 12 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,633 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.00012 $0.01633
Opus 5 $0.00006 $0.00816
Sonnet 5 $0.00002 $0.00327
Haiku 4.5 $0.00001 $0.00163

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

Security

Grade A, and why

track 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 8d 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.

.specify/templates/commands/track.md · 201 lines

How it starts

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

综合进度追踪

全面展示小说创作的各项进度和状态。

追踪维度

  1. 写作进度 - 字数、章节、完成率
  2. 情节发展 - 主线进度、支线状态
  3. 时间线 - 故事时间推进
  4. 角色状态 - 角色发展和位置
  5. 伏笔管理 - 埋设和回收状态

使用方法

执行脚本 {SCRIPT} [选项]:

  • 无参数 - 显示完整追踪报告
  • --brief - 显示简要信息
  • --plot - 仅显示情节追踪
  • --stats - 仅显示统计数据
  • --check - [增强] 执行深度一致性检查(包含角色验证)
  • --fix - [新增] 自动修复发现的简单问题

数据来源

整合多个追踪文件的信息:

  • progress.json - 写作进度
  • spec/tracking/plot-tracker.json - 情节追踪
  • spec/tracking/timeline.json - 时间线
  • spec/tracking/relationships.json - 关系网络
  • spec/tracking/character-state.json - 角色状态
  • spec/tracking/validation-rules.json - [新增] 验证规则(用于--check和--fix)

输出示例

📊 小说创作综合报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📖 《大明风华录》

✍️ 写作进度
  完成:60/240章 (25%)
  字数:162,000/800,000
  当前:第二卷《朝堂风云》

📍 情节状态
  主线:改革大业 [朝堂初入阶段]
  支线:感情线 [相互了解]

⏰ 时间线
  故事时间:万历三十年春
  时间跨度:5个月

👥 主要角色
  李中庸:翰林院编修 @北京
  沈玉卿:张居正义女 [活跃]

⚡ 待处理
  伏笔:3个未回收
  冲突:改革vs保守 [升级中]

✅ 一致性检查:通过

增强功能

数据一致性验证

基础检查(默认执行):

  • plot-tracker.json 与 outline.md 的一致性
  • timeline.json 的时间逻辑
  • relationships.json 的关系冲突
  • character-state.json 的位置合理性

深度验证模式 (--check)

当使用 --check 参数时,执行程序化的深度验证:

内部任务流程(自动执行)
# Phase 1: 基础验证 [并行执行]
- [x] T001 [P] 执行情节一致性检查 (plot-check逻辑)
- [x] T002 [P] 执行时间线验证 (timeline逻辑)
- [x] T003 [P] 执行关系验证 (relations逻辑)
- [x] T004 [P] 执行世界观验证 (world-check逻辑)

# Phase 2: 角色深度验证
- [x] T005 加载validation-rules.json验证规则
- [x] T006 扫描所有章节中的角色名称
- [x] T007 对比character-state.json验证名称一致性
- [x] T008 检查称呼是否符合relationships.json
- [x] T009 验证角色行为是否符合人设

# Phase 3: 生成综合报告
- [x] T010 汇总所有验证结果
- [x] T011 标记问题严重程度
- [x] T012 生成修复建议
验证报告示例
📊 深度验证报告
━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 通过项目: 15/18

❌ 发现问题 (3):
1. [高] 第3章: 主角名"李明"应为"李中庸"
2. [中] 第7章: 沈玉卿称呼错误,用了"师兄"
3. [低] 第12章: 时间线跳跃未说明

🔧 可自动修复: 2个
📝 需人工确认: 1个

运行 /track --fix 自动修复简单问题

自动修复模式 (--fix)

当使用 --fix 参数时,基于验证报告自动修复:

自动修复范围
  1. 角色名称错误 - 根据validation-rules.json自动替换
  2. 固定称呼错误 - 自动修正为正确称呼
  3. 简单拼写错误 - 修正明显的typo
修复流程
# 内部修复任务(自动执行)
- [x] F001 读取验证报告中的问题列表
- [x] F002 [P] 修复第3章角色名称错误
- [x] F003 [P] 修复第7章称呼错误
- [x] F004 生成修复报告
- [x] F005 更新追踪文件

Read the full file on GitHub · 201 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. 8d ago First seen · 201 lines · 12 tokens per session scan A ced2d973edec

Subscribe to this mod's changes

track is a command published in the GitHub repository wordflowlab/novel-writer (940 stars, last pushed 10mo ago), licensed MIT. It adds 12 tokens to every session and 1,633 once invoked, about $0.0001 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.