mcpField
S
story-init

story-init

github.com/bs779517创意与媒体862 次安装2 周前更新
代码仓库

关于 story-init

用于初始化故事项目的技能，会创建带 YAML 前置元数据的结构化 Markdown 文件及交叉引用。适合启动新小说项目或整理已有构思，不用于扩展已有故事。

主要功能

  1. 01创建故事文件夹结构
  2. 02生成故事圣经与各类登记表
  3. 03为文件添加 YAML 前置元数据
  4. 04设置情节与章节追踪文件
  5. 05在故事实体之间建立交叉链接

适用场景

  1. 01搭建新的小说或虚构作品项目
  2. 02整理已有的故事构思
  3. 03创建人物与世界观登记表
  4. 04开始追踪情节事件和章节

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bs779517/story-skills --skill story-init

安装后在 Claude Code 中输入/story-init确认已加载。

详细介绍

故事初始化

概述

使用结构化的 Markdown 文件夹布局初始化新的故事项目。创建故事设定集、角色注册表、世界构建索引、情节结构和章节跟踪文件，全部以带 YAML 前置元数据的 Markdown 文件形式保存，并相互交叉引用。

适用场景

  • 开始创作新的故事、书籍或虚构作品
  • 为已有的故事构想搭建文件夹结构
  • 不适用于向现有故事项目添加内容（请改用对应领域的技能）

工作流

  1. 询问故事的基本信息：

    • 标题
    • 类型和子类型
    • 简短梗概（2-3 句话）
    • 背景时代／时间段
    • 关键主题（2-4 个）
    • 视角风格（第一人称、第三人称有限视角、第三人称全知视角）
    • 时态（过去时、现在时）

  2. 在当前工作目录中创建文件夹结构：

{story-title-kebab}/
├── story.md
├── characters/
│   └── _index.md
├── worldbuilding/
│   ├── _index.md
│   ├── locations/
│   └── systems/
├── plot/
│   ├── _index.md
│   ├── arcs/
│   └── timeline.md
└── chapters/
    └── _index.md
  1. 使用故事设定集填充 story.md：
---
title: "{Title}"
genre: {genre}
sub-genre: {sub-genre}
setting-era: {era}
status: planning
themes:
  - {theme-1}
  - {theme-2}
pov: {pov-style}
tense: {tense}
---

在前置元数据下方添加以下部分：

  • 梗概 - 提供的 2-3 句话梗概
  • 语气与风格 - 简要说明故事的叙述风格（根据类型／主题推导）
  • 备注 - 留空，供用户填写
  1. 使用空注册表填充各个 _index.md：

characters/_index.md：

---
type: character-registry
story: {story-title-kebab}
---

# Characters

## Registry

| Name | Role | Status | File |
|------|------|--------|------|
| *No characters yet* | | | |

## Family Trees

*No family trees defined yet.*

## Relationship Map

*No relationships defined yet.*

worldbuilding/_index.md：

---
type: world-registry
story: {story-title-kebab}
---

# Worldbuilding

## World Overview

*Describe the world at a high level here.*

## Locations

| Name | Type | Region | File |
|------|------|--------|------|
| *No locations yet* | | | |

## Systems

| Name | Type | File |
|------|------|------|
| *No systems yet* | | |

plot/_index.md：

---
type: plot-registry
story: {story-title-kebab}
structure: three-act
---

# Plot Structure

## Story Structure

**Model:** Three-Act Structure (adjust as needed)

## Arcs

| Name | Type | Status | File |
|------|------|--------|------|
| *No arcs yet* | | | |

## Theme Tracking

| Theme | Arcs | Chapters |
|-------|------|----------|
| *No themes tracked yet* | | |

plot/timeline.md：

---
type: timeline
story: {story-title-kebab}
---

# Story Timeline

| When | Event | Arc | Chapter |
|------|-------|-----|---------|
| *No events yet* | | | |

chapters/_index.md：

---
type: chapter-registry
story: {story-title-kebab}
---

# Chapters

## Registry

| # | Title | POV | Status | Word Count | File |
|---|-------|-----|--------|------------|------|
| *No chapters yet* | | | | | |

## Total Word Count: 0
  1. 概述创建的内容，并建议后续步骤：
    • “添加你的第一个角色”（触发角色管理技能）
    • “开始构建世界”（触发世界构建技能）
    • “定义你的情节结构”（触发情节结构技能）

约定

这些约定适用于所有故事技能：

  • 所有实体文件均使用 kebab-case 文件名（例如，sera-voss.md、ashen-citadel.md）
  • 每个文件都使用 YAML 前置元数据存储结构化元数据
  • _index.md 文件是各领域的权威注册表
  • story.md 是所有技能读取以获取上下文的顶层设定集
  • 双向交叉链接 - 引用其他实体时，需同时更新两个文件
  • 角色标识符使用不带扩展名的 kebab-case 文件名（例如，sera-voss）

评论

支持 Markdown