Skip to content

zjs105910/workbuddy-market / bundled/novel-writing-suite/skills/story-long-write

story-long-write

Verified

长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲,明确要求正文后再写章节。触发方式:/story-long-write、/写长篇、「帮我开书」「定设定」「出卷纲」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。

FileKindSize
SKILL.mdskill md14.2 KB
references/agent-calls.mdmarkdown7.3 KB
references/anti-ai-writing.mdmarkdown36.3 KB
references/artifact-protocols.mdmarkdown14.5 KB
references/author-memory-maintenance.mdmarkdown8.6 KB
references/author-memory.mdmarkdown11.3 KB
references/banned-words.mdmarkdown10.2 KB
references/benchmark-recall.mdmarkdown5.5 KB
references/character-basics.mdmarkdown16.5 KB
references/character-design-methods.mdmarkdown15.9 KB
references/character-relations.mdmarkdown17.4 KB
references/commercial-core-methods.mdmarkdown20.2 KB
references/cross-book-recall.mdmarkdown7.1 KB
references/deslop-gates.mdmarkdown14.1 KB
references/dialogue-mastery.mdmarkdown11.5 KB
references/emotion-on-page.mdmarkdown4.6 KB
references/emotional-arc-design.mdmarkdown12.0 KB
references/emotional-methods.mdmarkdown9.9 KB
references/female-audience-writing.mdmarkdown11.2 KB
references/genre-prose-cards.mdmarkdown7.0 KB
references/genre-prose-cards/东方仙侠.mdmarkdown2.7 KB
references/genre-prose-cards/传统玄幻.mdmarkdown2.7 KB
references/genre-prose-cards/历史古代.mdmarkdown2.6 KB
references/genre-prose-cards/历史脑洞.mdmarkdown2.9 KB
references/genre-prose-cards/双男主.mdmarkdown3.2 KB
references/genre-prose-cards/古言脑洞.mdmarkdown2.6 KB
references/genre-prose-cards/古风世情.mdmarkdown2.6 KB
references/genre-prose-cards/女频悬疑.mdmarkdown2.6 KB
references/genre-prose-cards/女频种田.mdmarkdown2.6 KB
references/genre-prose-cards/宫斗宅斗.mdmarkdown2.5 KB
references/genre-prose-cards/年代.mdmarkdown3.0 KB
references/genre-prose-cards/快穿.mdmarkdown2.8 KB
references/genre-prose-cards/悬疑灵异.mdmarkdown2.6 KB
references/genre-prose-cards/悬疑脑洞.mdmarkdown2.7 KB
references/genre-prose-cards/战神赘婿.mdmarkdown2.7 KB
references/genre-prose-cards/抗战谍战.mdmarkdown2.7 KB
references/genre-prose-cards/星光璀璨.mdmarkdown2.7 KB
references/genre-prose-cards/民国言情.mdmarkdown2.8 KB
references/genre-prose-cards/游戏体育.mdmarkdown2.8 KB
references/genre-prose-cards/玄幻脑洞.mdmarkdown2.9 KB
references/genre-prose-cards/玄幻言情.mdmarkdown2.5 KB
references/genre-prose-cards/现言脑洞.mdmarkdown2.7 KB
references/genre-prose-cards/科幻末世.mdmarkdown2.6 KB
references/genre-prose-cards/职场婚恋.mdmarkdown2.6 KB
references/genre-prose-cards/西方奇幻.mdmarkdown2.8 KB
references/genre-prose-cards/豪门总裁.mdmarkdown3.3 KB
references/genre-prose-cards/都市修真.mdmarkdown2.5 KB
references/genre-prose-cards/都市日常.mdmarkdown3.7 KB
references/genre-prose-cards/都市种田.mdmarkdown2.5 KB
references/genre-prose-cards/都市脑洞.mdmarkdown3.4 KB
references/genre-prose-cards/都市高武.mdmarkdown2.9 KB
references/genre-prose-cards/青春甜宠.mdmarkdown2.7 KB
references/genre-readers.mdmarkdown10.7 KB
references/long-chapter-hooks.mdmarkdown8.6 KB
references/long-chapter-quality.mdmarkdown8.6 KB
references/long-format.mdmarkdown2.5 KB
references/long-genre-catalog.mdmarkdown17.0 KB
references/long-genre-mechanics.mdmarkdown17.0 KB
references/long-reversal.mdmarkdown15.2 KB
references/long-suspense.mdmarkdown15.2 KB
references/opening-design.mdmarkdown12.5 KB
references/outline-conflict.mdmarkdown17.2 KB
references/outline-methods.mdmarkdown10.6 KB
references/outline-rhythm.mdmarkdown12.6 KB
references/outline-structure-theory.mdmarkdown12.4 KB
references/plot-core-methods.mdmarkdown19.8 KB
references/plot-emotion-system.mdmarkdown15.5 KB
references/plot-frameworks.mdmarkdown27.1 KB
references/plot-special-topics.mdmarkdown25.0 KB
references/project-files.mdmarkdown11.6 KB
references/reader-contract-and-progression.mdmarkdown11.3 KB
references/reference-index.mdmarkdown6.0 KB
references/stop-and-fix.mdmarkdown940 B
references/style-combat-face.mdmarkdown16.9 KB
references/style-craft.mdmarkdown13.1 KB
references/style-genre-modules.mdmarkdown24.2 KB
references/style-resolution.mdmarkdown3.9 KB
references/tracking-initialization.mdmarkdown1.3 KB
references/tracking-transaction.mdmarkdown14.9 KB
references/workflow-chapter.mdmarkdown14.4 KB
references/workflow-daily.mdmarkdown7.5 KB
references/workflow-outline.mdmarkdown20.7 KB
references/workflow-revision.mdmarkdown6.6 KB
references/workflow-setup.mdmarkdown13.4 KB
references/workflow-volume.mdmarkdown17.1 KB
references/writer-prompt-fallback.mdmarkdown3.5 KB
references/writing-craft.mdmarkdown28.1 KB
scripts/author_memory_commit.pyscript77.9 KB
scripts/build_architect_brief.pyscript15.8 KB
scripts/build_writer_prompt.pyscript31.8 KB
scripts/check-ai-patterns.jsscript73.5 KB
scripts/check-degeneration.jsscript14.8 KB
scripts/check-outline-contract.jsscript23.4 KB
scripts/check-outline-copy.jsscript13.0 KB
scripts/normalize-punctuation.jsscript13.2 KB
scripts/outline_view.pyscript11.8 KB
scripts/storyctl.pyscript25.0 KB
scripts/style-whitelist.jsscript1.1 KB
scripts/tracking_commit.pyscript81.8 KB
scripts/wordcount_core.pyscript17.9 KB

scripts/build_architect_brief.py

View on GitHub
#!/usr/bin/env python3
"""build_architect_brief.py — 把「出卷纲」「出一批细纲」这一时刻要用的流程与模板拼成任务包。

用法:
    python build_architect_brief.py --project <书目录> --task world
    python build_architect_brief.py --project <书目录> --task volume [--volume N]
    python build_architect_brief.py --project <书目录> --task outline --chapters A-B
    python build_architect_brief.py --project <临时目录> --task <任务> --rules-only   # 仓库预算守卫计量用

开书与规划按作者确认点分时刻(见 references/workflow-setup.md)。卷纲与每批细纲最重,
有子代理时交给 story-architect 在新上下文里做:主会话只跑本脚本、把任务包路径交给它,
自己不读包里的内容。任务包写在书内 `.story/work/排纲/`,是这次任务的输入数据,不是 reference。

包里只有该时刻需要的东西,三种任务都附 SKILL.md 的「新增物三级」判据(包外读不到 SKILL.md):
- world:workflow-setup.md 的 Phase 2 与设定模板、character-basics.md、long-genre-mechanics.md 的
  「核心梗三层递进设计」、character-relations.md 的「人物关系类型」、reader-contract-and-progression.md。
- volume:workflow-volume.md(卷纲流程、排纲自查、节奏锚与对标迁移)、artifact-protocols.md
  (大纲与卷纲模板)、emotional-methods.md 的「长篇单元情绪引擎」(排纲自查第 1 项)、
  reader-contract-and-progression.md(第 4 项契约四问)。
- outline:workflow-outline.md(批次步骤、细纲模板与验收、补纲、设定补全、排纲底稿模板)、
  character-basics.md 的主角卡与配角卡模板;首章在范围内时加 opening-design.md。
流程里点名、但只在某些书才用得上的参考(多对标时的跨书召回、女频手册、弧线与反转速查、灵感库)
不进包,列在包末「按条件可读」,给出绝对路径与小节,条件满足才读。
本书的方向、设定与作者口头定下的事都在 `设定/`,不进包,由执行者按包里的流程定点读。
`--rules-only` 只拼规则部分(不取本书卷纲),供仓库的预算守卫计量每次调用的加载量。

stdout 输出一行 JSON:任务包路径、字数(去空白)、包含的资料。
Exit: 0 = 已写出;2 = 参数或资料缺失(含卷纲单元只覆盖了请求章节的一部分)。
"""

from __future__ import annotations

import argparse
import json
import re
import sys
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent))
from outline_view import parse as parse_volume, slice_arc, strip_retired, unit_chapter_range  # noqa: E402

SKILL_ROOT = Path(__file__).resolve().parent.parent
REFERENCES = SKILL_ROOT / "references"
WORK_DIR = (".story", "work", "排纲")
# 包外按条件可读:(文件, 小节或 None=整份, 条件)。条件由执行者读 `设定/` 判断。
CROSS_BOOK = ("cross-book-recall.md", None, "`设定/题材定位.md`「对标登记」里有 2 本及以上对标书")
INSPIRATION = ("cross-book-recall.md", "公共灵感标签召回", "工作区有 `灵感库/`(零命中不阻塞)")
CONDITIONAL = {
    "world": [("female-audience-writing.md", None, "本书是女频"), CROSS_BOOK, INSPIRATION],
    "volume": [CROSS_BOOK, ("emotional-arc-design.md", "六种弧线速查", "情绪弧线选型拿不准"),
               ("long-reversal.md", "反转类型", "本卷规划了反转"), INSPIRATION],
    "outline": [CROSS_BOOK, INSPIRATION],
}


def read_reference(name: str) -> str:
    path = REFERENCES / name
    if not path.is_file():
        raise SystemExit(f"ERROR: 缺少 reference:{path}")
    return path.read_text(encoding="utf-8").lstrip("")


def section(text: str, start: str, end: str | None = None) -> str:
    """取 start 标题行到 end 标题行之前(end 省略则到文末);找不到 start 就报错,不静默给空。"""
    match = re.search(rf"^#+\s*{re.escape(start)}.*$", text, re.M)
    if match is None:
        raise SystemExit(f"ERROR: reference 里找不到小节「{start}」")
    stop = re.search(rf"^#+\s*{re.escape(end)}.*$", text[match.end():], re.M) if end else None
    return text[match.start(): match.end() + stop.start() if stop else len(text)].rstrip()


def new_addition_tiers() -> str:
    """SKILL.md 的「新增物三级」判据:排纲、定设定都要按它分级,而任务包外的 SKILL.md 读不到。"""
    text = (SKILL_ROOT / "SKILL.md").read_text(encoding="utf-8")
    match = re.search(r"^> \*\*新增物三级\*\*.*?(?=^(?!>))", text, re.M | re.S)
    if match is None:
        raise SystemExit("ERROR: SKILL.md 里找不到「新增物三级」")
    return "\n".join(line[2:] if line.startswith("> ") else line.lstrip(">") for line in match.group(0).rstrip().splitlines())


def conditional_reads(task: str) -> str:
    lines = ["下面几份在包外,只在条件满足时读,只读点名的那一节(没点名读整份);条件不满足不读:"]
    for name, part, when in CONDITIONAL[task]:
        where = f"「{part}」一节" if part else "整份"
        lines.append(f"- {when}:读 `{REFERENCES / name}` {where}")
    return "\n".join(lines)


def emit(text: str, stream) -> None:
    """统一按 UTF-8 写出:Windows 控制台默认 GBK/ASCII 时直接 print 中文会崩。"""
    stream.buffer.write((text + "\n").encode("utf-8"))
    stream.flush()


def render(sections, chosen, span, preamble) -> str:
    """与 outline_view.emit 同一取法(剔除已退役条目、情绪弧线按单元截段),只是返回文本。"""
    out = ["\n".join(strip_retired(preamble, False)).rstrip()] if preamble else []
    for sec in sections:
        if sec not in chosen:
            continue
        body = slice_arc(sec, span) if ("情绪弧线" in sec.title or "排班" in sec.title) else sec.lines
        out.append("\n".join(strip_retired(body, False)).rstrip())
    return "\n\n".join(out) + "\n"


def unit_closures(project: Path, first: int, last: int) -> list[tuple[str, str]]:
    """story-architect 没有执行命令的权限:由脚本先把覆盖本批章节的剧情单元闭包取出来放进包里。

    取法同 `outline_view.py --unit U --stage outline`;一卷里有几个单元时,卷契约与卷级常任只随第一个单元给一次。"""
    found: list[tuple[str, str]] = []
    covered: set[int] = set()
    undeclared: list[str] = []
    for volume in sorted((project / "大纲").glob("卷纲_第*卷.md")):
        lines, sections = parse_volume(volume.read_text(encoding="utf-8"))
        # 单元卡有标题、没写作用域行时取段器认不出它——点名缺哪一行,而不是笼统说找不到单元。
        undeclared += [f"{volume.name}「{s.title.strip()}」" for s in sections
                       if s.scope is None and s.unit and "剧情单元" in s.title]
        if any(s.scope and (s.kind is None or (s.kind != "卷级常任" and s.unit is None)) for s in sections):
            raise SystemExit(f"ERROR: {volume.name} 作用域声明无效,先跑 outline_view.py --check 修正")
        active = [s for s in sections if s.status != "已退役"]
        shared = [s for s in active if s.kind == "卷级常任" or s.scope is None]
        units = sorted({s.unit for s in active if s.unit and s.kind == "单元级"})
        given = False
        for unit in units:
            span = unit_chapter_range(active, unit)
            if not (span and span[0] <= last and span[1] >= first):
                continue
            covered.update(range(span[0], span[1] + 1))
            live = [s for s in active if s.unit == unit and s.kind in ("单元级", "批次底稿")]
            if given:
                text = "(卷契约与卷级常任同上一段,不重复。)\n\n" + render(sections, set(live), span, None)
            else:
                text = render(sections, set(shared + live), span, lines[:sections[0].start] if sections else None)
            given = True
            found.append((f"{volume.name} · 单元 {unit}(第{span[0]}-{span[1]}章)", text))
    missing = [n for n in range(first, last + 1) if n not in covered]
    if missing:
        hint = (f";这些单元卡缺「> 作用域:单元级 {{单元ID}}」声明行:{'、'.join(undeclared)}"
                if undeclared else "(单元卡要写「> 作用域:单元级 {单元ID}」和「章节范围:第A-B章」)")
        where = "找不到覆盖" if not found else "剧情单元只覆盖了一部分,缺覆盖"
        raise SystemExit(f"ERROR: 卷纲里{where}第{compress(missing)}章的剧情单元{hint},先补卷纲"
                         "(`outline_view.py --check --strict` 列出全部问题)")
    return found


def compress(numbers: list[int]) -> str:
    """[4, 5, 6, 9] → 4-6、9"""
    spans, start = [], numbers[0]
    for prev, cur in zip(numbers, numbers[1:] + [None]):
        if cur != prev + 1:
            spans.append(f"{start}-{prev}" if start != prev else f"{start}")
            start = cur
    return "、".join(spans)


def weight(text: str) -> int:
    return len(re.sub(r"\s", "", text))


def build(task: str, volume: int | None, chapters: tuple[int, int] | None,
          project: Path | None = None, rules_only: bool = False) -> tuple[str, list[str]]:
    outside = "写作技法只读本包,外加包末「按条件可读」里条件满足的那几节。"
    if task == "world":
        head = ("# 任务包:出核心设定提案\n\n"
                "按下面 Phase 2 的流程,把核心设定写成文件:`设定/题材定位.md`(在定方向时已写的部分上补全,不删作者已定的内容)、"
                "`设定/关系.md`、主角与关键角色的 `设定/角色/{名}.md`、影响全书的 `设定/世界观/{主题}.md`。"
                "作者在定方向时说过的话都在 `设定/题材定位.md`,先读它;拿不准的写成二选一的候选留给作者定,不替作者拍板,"
                "物价、收入、力量档位这类全书刻度按下附「新增物三级」属先问作者,只给候选。"
                f"不出卷纲、不写正文。{outside}交付后只回:写了哪些文件、主角与核心冲突各一句、"
                "要作者定的事(没有写「无」)。")
        setup = read_reference("workflow-setup.md")
        parts = [("workflow-setup.md(Phase 2 与设定模板)",
                  section(setup, "Phase 2:核心设定", "Agent 调用:story-architect + character-designer") + "\n\n"
                  + section(setup, "定设定时建的文件模板")),
                 ("character-basics.md", read_reference("character-basics.md")),
                 ("long-genre-mechanics.md(核心梗三层递进设计)",
                  section(read_reference("long-genre-mechanics.md"), "核心梗三层递进设计", "微创新与差异化设计")),
                 ("character-relations.md(人物关系类型)",
                  section(read_reference("character-relations.md"), "人物关系类型", "感情流人设核心法")),
                 ("reader-contract-and-progression.md", read_reference("reader-contract-and-progression.md"))]
    elif task == "volume":
        label = f"第{volume}卷" if volume else "本卷"
        head = (f"# 任务包:出{label}卷纲\n\n"
                f"只交付全书体量与阶段总览(`大纲/大纲.md`,已有就只补本卷相关部分)和 `大纲/卷纲_第{volume or 'X'}卷.md`,"
                "不出细纲、不写正文、不建 `追踪/`。本书方向、设定、对标登记与作者已定的事读 `设定/`(先读 "
                f"`设定/题材定位.md`)。{outside}交付后只回:写了哪些文件、排纲自查 1–4 "
                "的结论各一句、要作者定的事(没有写「无」)。")
        parts = [("workflow-volume.md", read_reference("workflow-volume.md")),
                 ("artifact-protocols.md", read_reference("artifact-protocols.md")),
                 ("emotional-methods.md(长篇单元情绪引擎)",
                  section(read_reference("emotional-methods.md"), "长篇单元情绪引擎", "决策路由")),
                 ("reader-contract-and-progression.md", read_reference("reader-contract-and-progression.md"))]
    else:
        first, last = chapters
        head = (f"# 任务包:出第{first}-{last}章细纲\n\n"
                f"只交付 `大纲/细纲_第{first:03d}章` 到第{last:03d}章,以及排纲底稿与必要的设定补全,不写正文、"
                "不建 `追踪/`。本批涉及的卷纲单元段附在包末(已按单元取好),卷纲本身不整读;设定从 `设定/` 定点读;"
                f"{outside}交付后只回:写了哪些文件、"
                "每章一句核心事件、要作者定的事(没有写「无」)。")
        basics = read_reference("character-basics.md")
        parts = [("workflow-outline.md", read_reference("workflow-outline.md")),
                 ("character-basics.md(主角卡、配角卡)", section(basics, "第1节:主角卡", "第3节"))]
        if first <= 3:
            parts.append(("opening-design.md", read_reference("opening-design.md")))
        if not rules_only:
            parts += [(f"卷纲取段:{name}", text) for name, text in unit_closures(project, first, last)]
    parts.append(("SKILL.md(新增物三级)", new_addition_tiers()))
    parts.append(("按条件可读(包外)", conditional_reads(task)))
    body = [head + ("\n\n包里流程写到的脚本命令(取段、`--check`、`check-outline-contract.js`)由主会话在你交付后跑,"
                    "你不执行命令;需要的取段结果已放进包里。")]
    for name, text in parts:
        body.append(f"\n---\n\n<!-- 资料:{name} -->\n\n{text.strip()}\n")
    return "\n".join(body), [name for name, _ in parts]


def parse_range(value: str) -> tuple[int, int]:
    match = re.fullmatch(r"\s*(\d+)\s*(?:-\s*(\d+))?\s*", value or "")
    if not match:
        raise SystemExit("ERROR: --chapters 写成 A-B,如 1-10")
    first = int(match.group(1))
    last = int(match.group(2) or first)
    if first < 1 or last < first:
        raise SystemExit("ERROR: --chapters 范围无效")
    return first, last


def main(argv=None) -> int:
    parser = argparse.ArgumentParser(description="拼出 story-architect 出卷纲/细纲的任务包")
    parser.add_argument("--project", required=True, type=Path, help="书目录")
    parser.add_argument("--task", required=True, choices=("world", "volume", "outline"))
    parser.add_argument("--volume", type=int, help="卷号(volume 任务)")
    parser.add_argument("--chapters", help="章节范围 A-B(outline 任务)")
    parser.add_argument("--rules-only", action="store_true", help="只拼规则部分、不取本书卷纲(预算守卫计量用)")
    args = parser.parse_args(argv)
    try:
        if not args.project.is_dir():
            raise SystemExit(f"ERROR: 书目录不存在:{args.project}")
        chapters = parse_range(args.chapters) if args.task == "outline" else None
        if args.task == "outline" and chapters[1] - chapters[0] >= 10:
            raise SystemExit("ERROR: 一批细纲最多 10 章,拆成两批")
        text, included = build(args.task, args.volume, chapters, args.project, args.rules_only)
    except SystemExit as exc:
        emit(str(exc), sys.stderr)
        return 2
    out_dir = args.project.joinpath(*WORK_DIR)
    out_dir.mkdir(parents=True, exist_ok=True)
    if args.task == "world":
        name = "核心设定.md"
    elif args.task == "volume":
        name = f"卷纲_第{args.volume}卷.md" if args.volume else "卷纲.md"
    else:
        name = f"细纲_第{chapters[0]:03d}-{chapters[1]:03d}章.md"
    out = out_dir / name
    out.write_text(text, encoding="utf-8")
    emit(json.dumps({"brief": str(out), "chars": weight(text), "includes": included}, ensure_ascii=False), sys.stdout)
    return 0


if __name__ == "__main__":
    sys.exit(main())
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall