# Sw Workflow

Project orchestrator for the screenwriting skill set (剧本项目主线调度 / 状态存档 / story bible), ...

- Repository: https://github.com/jtydhr88/screenwriting-skills (1918 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-03
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add jtydhr88/screenwriting-skills --skill sw-workflow -g -a claude-code -y`
Codex: `npx skills add jtydhr88/screenwriting-skills --skill sw-workflow -g -a codex -y`
Cursor: `npx skills add jtydhr88/screenwriting-skills --skill sw-workflow -g -a cursor -y`
Gemini CLI: `npx skills add jtydhr88/screenwriting-skills --skill sw-workflow -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add jtydhr88/screenwriting-skills`

## Description

Project orchestrator for the screenwriting skill set (剧本项目主线调度 / 状态存档 / story bible), a meta-skill that adds no new craft knowledge but routes a screenplay or stage-play project through stages (premise → structure → character → scenes → draft → revision → submission) and a TV / streaming series project (电视剧 / 剧集 / pilot / 一季) through a separate series stage table (engine → character network & season arc → documents/bible → pilot structure → break story & outline → draft → submission), names which sw-* skill to invoke at each stage, defines each stage's deliverable and advisory exit check, and keeps all project state in a story-bible.md file so work can resume across sessions. Use when starting a new script project, resuming one ("continue my screenplay", "where were we"), when the user asks "what should I do next" on a script, when converting a vague idea into a full development pipeline, or when the other sw-* skills are firing individually and the overall process needs sequencing.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 剧本项目主线调度（Workflow & Story Bible）

本 skill 不含新的编剧知识，只做两件事：**排顺序**（哪个阶段调用哪个 skill、交什么、什么算过关）和**存状态**（把每阶段结论写进 `story-bible.md`，下次会话接着做）。所有方法都在其他 sw-* skill 里，本 skill 只负责在正确的时刻把它们叫出来。

设计依据来自一次对照实验：同一题目，按流程先填工作单再写，与不用流程直接写相比，篇幅、主角主动性、对手强度、潜台词全部不同；差别不在知识，在于"动笔前必须填的表、写完后必须过的清单"。本 skill 就是那张表和那份清单的调度器。

story-bible 模板与各阶段工作单见 [reference.md](reference.md)；跨语言输出时的术语锚定表见 [terms.md](terms.md)。

---

## 一、会话协议（每次开始与结束都执行）

### 开始

1. 在当前目录（或用户指定的剧本目录）找 `story-bible.md`。
2. **找到**：只读"当前阶段""已定决策""决策日志"三节，用三句话向用户复述：项目是什么、做到哪一步、上次定了什么。然后直接进入当前阶段，不重新讨论已定决策，除非用户主动推翻。
3. **一次性交付不建 bible**：用户要的是一份当场交出去的文档（开发方案、提案、一页梗概、分集大纲），且明显不会有下一次会话来接, , 这时建 bible 是净成本，直接在同一会话里按阶段表跑完即可。bible 解决的是**跨会话丢上下文**，不是"流程要有表"。
4. **没找到且是持续项目**：判断入口路径（见第三节），按 reference.md 模板新建 `story-bible.md`，只填"项目信息"和"当前阶段"，其余留空。不要一次问用户四个以上的问题；能从用户的话里推断的先填上，标"（待确认）"。

### 进行中

- 每完成一个阶段的交付物，立刻写进 story-bible 对应节，并把"当前阶段"推进一格。
- 任何改变既定决策的动作（换前提、换结尾、删人物）都在"决策日志"加一行：日期、改了什么、为什么。
- story-bible 保持在一次能读完的长度（约 25K token，中文 1.5 万字以内）。产物只写结论，不写推导过程；大纲、处理台本、剧本正文放独立文件，bible 里只记文件名和一句状态。

### 结束

- 会话结束前确认 story-bible 已更新到最新，最后一行写"下一步："一句话。

---

## 二、阶段图

The rest: https://github.com/jtydhr88/screenwriting-skills/blob/HEAD/plugins/screenwriting/skills/sw-workflow/SKILL.md