agentleFS
KurohaneKaorukoKurohaneKaoruko/Novelist-Skills/novel-project/SKILL.md

novel-project

Skill3 starsChanged 11 days agoMITView on GitHub

初始化作品工程、人物卡建档、设定集建档、世界观构建落盘、保存章节、归档、整理索引、导入旧稿、搭配 Obsidian 使用时加载。工程目录结构、每人/每类一文件约定、双链规范、人物卡与设定集模板、每章标准闭环流程、断更恢复、Obsidian 协作工作流。

The file

Files
SKILL.md

作品工程与落盘约定

长篇不靠模型记忆,靠工程文件。所有写作成果统一落盘 Markdown,目录结构与命名遵守本约定,Obsidian 直接可用。

一、工程目录结构

作品根/
├── README.md            # 全量双链索引(novel_project 整理索引 维护)
├── 文风卡.md            # 文风基准(格式见《novel-profiles》,写前必读对齐)
├── 伏笔清单.md          # | 伏笔 | 铺设位置 | 发酵 | 回收位置 | 状态 |
├── 时间线.md            # | 时间 | 事件 | 参与人物 | 影响/后续 |
├── 大纲/
│   ├── 总纲.md
│   └── 第N卷-卷名.md
├── 设定集/              # 每类一文件
│   ├── _索引.md
│   ├── 世界观.md / 力量体系.md / 地理.md / 势力.md / …
├── 人物卡/              # 每人一文件
│   ├── _索引.md
│   └── 角色名.md
├── 归档/
│   └── 第NNN章-标题-归档.md
└── 正文/
    └── 第NNN章-标题.md   # 纯文本,每章一文件
  • 章节文件名:第001章-标题.md,序号三位补零。
  • 人物卡一个角色一个文件;设定集按类别分文件;不用大文件堆所有内容。
  • 说明.md 是初始化脚手架,不算内容文件。

二、双链规范(Obsidian 图谱)

  • 人物卡 ↔ 人物卡:关系互链([[角色名]])。
  • 人物卡 ↔ 设定集:归属/掌握互链([[设定集/力量体系|力量体系]])。
  • 伏笔清单、时间线的行内提及人物、设定时用双链。
  • README.md 是全量索引:章节、人物、设定、归档、追踪表全部双链(novel_project 整理索引 自动生成)。

三、每章标准闭环(长篇连载循环)

每写一章走完整循环,顺序固定:

  1. 写前简报:novel_briefing 从工程材料浓缩本章上下文(主线进度/本章任务/出场人物要点/活跃伏笔/相关设定/衔接要点/注意事项)。没有简报不动笔。
  2. 单章成稿:你按《novel-prose-standards》的生成时干预亲自写整章(≥2500 字分场景分段),写完 novel_lint 自检清零后落盘正文(自己的文件工具或 novel_project 保存章节)。
  3. 章后归档:novel_archive 更新伏笔清单、时间线,生成归档记录;人物状态变化回填人物卡,新设定回填设定集。
  4. 整理索引:novel_project 整理索引(定期,如每卷末)。
  5. 发布前(可选):novel_reader_panel 读者团试读;上架章节 novel_compliance 合规体检。

断更恢复:隔了很久或新会话续写时,先读最近归档、伏笔清单与上一章结尾找回状态,再动笔。

四、工程操作对照

时机工具
开新书novel_project 初始化工程
有旧稿novel_import 自动分章落盘(逆推大纲/人物卡/设定集由你按《novel-profiles》建档格式完成)
写前novel_briefing 组装工程材料(原文返回,浓缩取舍由你判断)
定文风按《novel-profiles》文风卡格式从基准章节生成,保存到 文风卡.md
存稿novel_project 保存章节 或用你自己的文件工具按命名约定落盘
章后novel_archive 落盘归档三件套(你先提取,工具写入)
查进度novel_project 统计进度
全书体检novel_scan_book 组装体检材料,分析由你完成

文风卡建档

按《novel-profiles》的文风卡格式,从最能代表目标文风的已定稿正文(1-2 章,2000 字以上为宜)提取,保存到工程根目录 文风卡.md(初始化工程时已建占位)。写前必读对齐(见《novel-prose-standards》)。

归档三件套(novel_archive 的提取格式)

章后从本章正文提取三段,交给 novel_archive 落盘:

  1. 伏笔清单表(整表覆盖 伏笔清单.md):表头 | 伏笔 | 铺设位置 | 发酵 | 回收位置 | 状态 |;新伏笔追加(铺设中)、推进/回收的更新状态、无变化行原样保留。
  2. 时间线行(追加到 时间线.md):每行 | 时间 | 事件 | 参与人物 | 影响/后续 |,故事内相对时间;无新增写“无”。
  3. 归档记录(落盘 归档/第NNN章-*-归档.md):①本章摘要(150 字内)②人物状态变化(逐条“人物:变化”)③新增设定要点 ④遗留问题。

人物状态变化还需同步回填 人物卡/ 对应文件;新增设定补进 设定集/。

伏笔清单与时间线生成(开书/逆推时)

从大纲或已写内容梳理,格式与归档表一致;状态取“铺设中/发酵中/已回收/待回收”,信息不明标【待定】;时间线按故事内时间排序。生成后用文件工具保存(或让 novel_project 覆盖)。

五、Obsidian 协作工作流

把作品根目录(或工作区)作为 Obsidian Vault:

  1. 生成:Agent 产出章节/大纲/设定/人物卡(全部 Markdown,天然是 Obsidian 笔记)。
  2. 阅读批注:在 Obsidian 里读稿、高亮、评论;直接改字句后保存。
  3. 反馈:告诉 Agent“继续写”,它会读到你的修改(文件是同一份)。
  4. 图谱:双链构成设定网络,图谱视图检查人物/设定是否孤岛;标签与看板跟踪连载进度。
  5. 迭代:循环 1–4,人工与 AI 各取所长。

修改工程文件时的注意:保持表格结构(伏笔清单/时间线是 Markdown 表格,novel_archive 按行追加);文件名遵守命名约定(工具按 第NNN章 序号定位最新章);不要把多个角色合并回一个大文件。

任务流程

人物卡建档、设定集建档、世界观构建与文风卡生成的模板及落盘约定见《novel-profiles》;本章归档时的回填动作见上文“归档三件套”。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.