agentleFS
qingyabailu-gitqingyabailu-git/webfiction-write/skills/fiction-start/SKILL.md

fiction-start

Skill15 starsChanged 3 months agoMITView on GitHub

正式开书。运行开书前检查清单,确认构思充分后锁定基线、初始化 Story System 底本。 开书后设定集锁定为基线,修改需走 fiction-write 内建的变更传播流程。 开书前不支持写正文。 触发方式:/fiction-start、「开书」「正式开始」「锁定基线」「开始写作」「准备好了,开始吧」「可以动笔了」。

The file

Files
SKILL.md

fiction-start:正式开书

这是一个心理仪式 + 状态切换。开书前用户可自由调整设定/大纲/扫榜/拆书。 开书后设定锁定为基线,系统正式进入写作阶段。

前置条件

以下文件必须存在(由 fiction-setup + fiction-conceive 产生):

  • .novel/state.json
  • 设定集/主角卡.md(含欲望/缺陷/能力/代价)
  • 设定集/世界观.md
  • 设定集/核心冲突.md(含一句话梗概)
  • 大纲/总纲草案.md

缺失则提示用户先完成对应步骤,不强开。

检查清单

═══════════════════════════════════════
          正式开书前检查清单
═══════════════════════════════════════

  ☐ 书名: {读取}
  ☐ 题材: {读取}
  ☐ 主角设定: 欲望({}) + 缺陷({})
  ☐ 世界观框架: {已确立/未完成}
  ☐ 核心冲突: {已定/未定}
  ☐ 总纲草案: {存在/缺失}
  ⬜ 可选: 文风档案 → {存在/缺失}
  ⬜ 可选: 扫榜分析 → {已完成/未做}
  ⬜ 可选: 对标拆书 → {已完成/未做}

─────────────────────────────────
建议项(⬜)可选,不影响开书但建议准备。
必填缺失则提示补完再回来。

下一步:
  1. 补完必填项再回来
  2. 先做扫榜/拆文,再回来看市场

必填项未完成时不得跳过并开书;可选项缺失不阻断。

开书执行

用户确认后,系统执行:

# SCRIPTS_DIR 由安装宿主指向本仓库或已安装的 scripts/ 目录。
export PROJECT_ROOT="${CODEX_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-$PWD}}"

1. 锁定构思文件

将总纲草案升级为正式总纲:

  • 大纲/总纲草案.md → 去除"草案"标记
  • 在 大纲/总纲.md 中写入核心主线、创意约束(反套路规则/硬约束/主角缺陷/反派镜像)

2. 初始化 Story System 底本

# 生成 MASTER_SETTING.json(全局调性、核心禁忌、题材映射)
python -X utf8 "${SCRIPTS_DIR}/fiction.py" --project-root "${PROJECT_ROOT}" init-contract

3. 更新 state.json

{
  "progress": { "writing_started": true },
  "versions": { "baseline_version": 1 }
}

4. 输出开书报告

═══════════════════════════════════════
  🎉 正式开书完成!

  状态:
  · 设定集已锁定为基线
  · 底本已初始化(版本号以脚本输出为准)
  · 当前阶段:正文写作就绪

  现在可以规划第 1 卷:
  → fiction-plan 1

  或者继续调整构思:
  → fiction-conceive
═══════════════════════════════════════

开书前 vs 开书后行为差异

维度开书前开书后
修改设定随意改改完需传播检测
写正文不支持正常
底本不存在执行 init-contract 后存在(版本号以输出为准)
fiction-write提示"请先 fiction-start"正常
fiction-plan只做规划,不同步底本规划 + 同步底本

开书后每次 fiction-plan 只有在实际写入底本时才刷新对应版本号;若底本不存在或同步失败,必须报告未同步。

参考

Story System 底本初始化由 scripts/fiction.py 的 init-contract 子命令完成。 底本刷新由 fiction-plan 和 fiction-write 负责,start 只做初始建立。

致谢

本 skill 的开发参考了以下开源项目的思路与实现:

感谢原作者的开源贡献。

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.