Skip to content

zenstory-ai/oh-story-claudecode / skills/story-long-write

story-long-write

Verified

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

FileKindSize
SKILL.mdskill md13.0 KB
references/agent-calls.mdmarkdown5.3 KB
references/artifact-protocols.mdmarkdown9.8 KB
references/author-memory.mdmarkdown6.6 KB
references/banned-words.mdmarkdown10.9 KB
references/benchmark-recall.mdmarkdown5.2 KB
references/character-basics.mdmarkdown12.3 KB
references/character-relations.mdmarkdown10.2 KB
references/cross-book-recall.mdmarkdown3.9 KB
references/dialogue-mastery.mdmarkdown11.0 KB
references/emotional-methods.mdmarkdown7.9 KB
references/female-audience-writing.mdmarkdown7.5 KB
references/genre-prose-cards.mdmarkdown7.0 KB
references/genre-prose-cards/东方仙侠.mdmarkdown2.3 KB
references/genre-prose-cards/传统玄幻.mdmarkdown1.9 KB
references/genre-prose-cards/历史古代.mdmarkdown1.7 KB
references/genre-prose-cards/历史脑洞.mdmarkdown2.0 KB
references/genre-prose-cards/双男主.mdmarkdown2.3 KB
references/genre-prose-cards/古言脑洞.mdmarkdown1.8 KB
references/genre-prose-cards/古风世情.mdmarkdown2.3 KB
references/genre-prose-cards/女频悬疑.mdmarkdown1.8 KB
references/genre-prose-cards/女频种田.mdmarkdown1.8 KB
references/genre-prose-cards/宫斗宅斗.mdmarkdown1.6 KB
references/genre-prose-cards/年代.mdmarkdown2.1 KB
references/genre-prose-cards/快穿.mdmarkdown1.9 KB
references/genre-prose-cards/悬疑灵异.mdmarkdown1.7 KB
references/genre-prose-cards/悬疑脑洞.mdmarkdown1.9 KB
references/genre-prose-cards/战神赘婿.mdmarkdown1.9 KB
references/genre-prose-cards/抗战谍战.mdmarkdown1.8 KB
references/genre-prose-cards/星光璀璨.mdmarkdown1.8 KB
references/genre-prose-cards/民国言情.mdmarkdown1.9 KB
references/genre-prose-cards/流派兜底.mdmarkdown8.4 KB
references/genre-prose-cards/游戏体育.mdmarkdown1.9 KB
references/genre-prose-cards/玄幻脑洞.mdmarkdown2.0 KB
references/genre-prose-cards/玄幻言情.mdmarkdown1.7 KB
references/genre-prose-cards/现言脑洞.mdmarkdown1.8 KB
references/genre-prose-cards/科幻末世.mdmarkdown1.7 KB
references/genre-prose-cards/职场婚恋.mdmarkdown1.7 KB
references/genre-prose-cards/西方奇幻.mdmarkdown1.9 KB
references/genre-prose-cards/豪门总裁.mdmarkdown2.3 KB
references/genre-prose-cards/都市修真.mdmarkdown1.7 KB
references/genre-prose-cards/都市日常.mdmarkdown2.8 KB
references/genre-prose-cards/都市种田.mdmarkdown1.7 KB
references/genre-prose-cards/都市脑洞.mdmarkdown2.4 KB
references/genre-prose-cards/都市高武.mdmarkdown2.0 KB
references/genre-prose-cards/青春甜宠.mdmarkdown1.8 KB
references/genre-readers.mdmarkdown6.9 KB
references/long-chapter-hooks.mdmarkdown6.5 KB
references/long-chapter-quality.mdmarkdown3.3 KB
references/long-format.mdmarkdown2.1 KB
references/long-genre-catalog.mdmarkdown11.9 KB
references/long-genre-mechanics.mdmarkdown8.3 KB
references/long-reversal.mdmarkdown12.3 KB
references/long-suspense.mdmarkdown9.2 KB
references/opening-design.mdmarkdown4.5 KB
references/outline-methods.mdmarkdown12.5 KB
references/outline-template.mdmarkdown8.0 KB
references/plot-core-methods.mdmarkdown5.3 KB
references/project-files.mdmarkdown4.7 KB
references/reader-contract-and-progression.mdmarkdown6.9 KB
references/revision-diagnosis.mdmarkdown3.6 KB
references/style-combat-face.mdmarkdown9.1 KB
references/tracking-initialization.mdmarkdown1.6 KB
references/tracking-transaction.mdmarkdown9.0 KB
references/workflow-chapter.mdmarkdown12.5 KB
references/workflow-daily.mdmarkdown6.3 KB
references/workflow-outline.mdmarkdown11.5 KB
references/workflow-revision.mdmarkdown6.5 KB
references/workflow-setup.mdmarkdown10.9 KB
references/workflow-volume.mdmarkdown6.4 KB
references/writing-craft.mdmarkdown23.6 KB
scripts/author_memory_commit.pyscript75.0 KB
scripts/build_architect_brief.pyscript21.8 KB
scripts/build_writer_prompt.pyscript41.7 KB
scripts/check-ai-patterns.jsexecutablescript79.8 KB
scripts/check-degeneration.jsscript15.4 KB
scripts/check-outline-contract.jsscript28.3 KB
scripts/check-outline-copy.jsscript13.4 KB
scripts/convert_outline_format.pyscript20.0 KB
scripts/normalize-punctuation.jsexecutablescript19.0 KB
scripts/outline_view.pyscript18.2 KB
scripts/storyctl.pyexecutablescript37.0 KB
scripts/style-whitelist.jsscript1.1 KB
scripts/template_fence.pyscript2.6 KB
scripts/tracking_commit.pyscript89.6 KB
scripts/wordcount_core.pyexecutablescript18.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(大纲与卷纲模板)、
  outline-methods.md 的「卷纲排法」(含排纲刻度、关键点、每章松还是紧)、reader-contract-and-progression.md(四个排纲问题)。
- outline:workflow-outline.md 的「排纲方法」(批次步骤、设定补全、按剧情批出细纲)、outline-template.md 整份
  (细纲与排纲笔记模板、字段说明)、long-chapter-hooks.md 的「章尾钩子 13 式」与「章首钩子 7 式」
  (细纲模板要从中选;只带名称与公式,示例列不进包)、character-basics.md 的主角卡与配角卡模板、
  plot-core-methods.md(含前 3 章时整份;之后不带开篇噱头一节);首章在范围内时加 opening-design.md 的「开篇规划」。
方法按小节名取:只取点名的那一节(到下一个同级或更高级标题为止),要两节就点两个名字,
不按「从 A 切到 B」的区间取——小节挪了位置或文末加了内容,不会悄悄混进包里;点名的小节不在了直接报错。
模板按围栏标签取(```markdown template=题材定位,见 template_fence.py):只取那一块,标签不在或重复直接报错。
流程文件的主会话一节(读取清单、分工、作者汇报)不进包。流程里点名、但只在某些书才用得上的参考
(多对标时的跨书召回、女频手册、常见的八步结构、情绪模块公式、换地图、感情线阶段、反转速查)
不进包,列在包末「按条件可读」,给出 story-architect 副本路径与小节,条件满足才读。
本书的方向、设定与作者口头定下的事都在 `设定/`,不进包,由执行者按包里的流程定点读。
`--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
from template_fence import TemplateNotFound, template_block  # 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 本及以上对标书")
ROMANCE = ("character-relations.md", "感情线阶段", "本书有感情线")
CONDITIONAL = {
    "world": [("female-audience-writing.md", None, "本书是女频"), ROMANCE, CROSS_BOOK],
    "volume": [CROSS_BOOK, ("outline-methods.md", "常见的八步结构", "没有主对标"),
               ("outline-methods.md", "情绪模块公式", "卷纲里有自创的剧情段"),
               ("outline-methods.md", "换地图", "本卷换大地图或开新地图"),
               ("long-reversal.md", "反转类型", "本卷规划了反转"), ROMANCE],
    "outline": [ROMANCE, CROSS_BOOK],
}
# 按围栏标签取的模板 → 落盘到哪个文件(标签名的唯一清单在仓库 scripts/current-contract.json)
TEMPLATE_TARGETS = {
    "题材定位": "设定/题材定位.md", "全书梗概": "设定/全书梗概.md", "关系": "设定/关系.md",
    "主角卡": "设定/角色/{名}.md(主角)", "配角卡": "设定/角色/{名}.md(配角)",
}
# SKILL.md 里「缺东西时怎么处理」那一块的标题,新旧都认(M 路改名前后都能取到)
TIERS_TITLES = ("新增物三级", "缺东西时三种处理")
# 前 3 章不在范围时 plot-core-methods 带的小节(不带「噱头分类与开篇流程」)
PLOT_CORE_AFTER_OPENING = ("目标情绪与主角选择", "爽点:六类与倒推", "高潮构建公式",
                           "情节细化:情节点怎么排", "留悬念与章尾", "过渡章与衔接")


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 headings(text: str) -> list[tuple[int, int, str]]:
    """(行号, 级别, 标题);代码围栏里的 # 不算标题。"""
    found, fence = [], None
    for index, line in enumerate(text.split("\n")):
        marker = re.match(r"^\s{0,3}(`{3,}|~{3,})", line)
        if marker:
            value = marker.group(1)
            if fence is None:
                fence = value
            elif value[0] == fence[0] and len(value) >= len(fence):
                fence = None
            continue
        if fence:
            continue
        match = re.match(r"^(#{1,6})\s+(.*\S)\s*$", line)
        if match:
            found.append((index, len(match.group(1)), match.group(2)))
    return found


def section(text: str, *names: str) -> str:
    """按名取小节:每个名字只取那一节,到下一个同级或更高级标题为止;点几个名字取几节,按点名顺序拼。

    标题以名字开头即算命中(「排纲方法」命中「排纲方法:交付、自查与对标迁移」)。找不到就报错,不静默给空。"""
    lines = text.split("\n")
    marks = headings(text)
    parts = []
    for name in names:
        hit = next((i for i, (_, _, title) in enumerate(marks) if title.startswith(name)), None)
        if hit is None:
            raise SystemExit(f"ERROR: reference 里找不到小节「{name}」")
        start, level, _ = marks[hit]
        end = next((row for row, lv, _ in marks[hit + 1:] if lv <= level), len(lines))
        parts.append("\n".join(lines[start:end]).rstrip())
    return "\n\n".join(parts)


def templates(name: str, *tags: str) -> str:
    """按围栏标签取模板,每块前写明落盘到哪个文件;标签不在或重复直接报错。"""
    text = read_reference(name)
    blocks = ["模板里的小节名、字段名照抄,不改名:写正文的脚本和别的 skill 按名读取。"]
    for tag in tags:
        try:
            body = template_block(text, tag, source=name)
        except TemplateNotFound as exc:
            raise SystemExit(f"ERROR: {exc}") from None
        blocks.append(f"### {TEMPLATE_TARGETS.get(tag, tag)}\n\n```markdown\n{body.strip()}\n```")
    return "\n\n".join(blocks)


def drop_last_column(text: str) -> str:
    """表格去掉末列:钩子表的示例列不进包,免得细纲照抄示例的句子形状。"""
    return "\n".join("|".join(line.split("|")[:-2]) + "|" if line.startswith("|") else line
                     for line in text.splitlines())


def new_addition_tiers() -> str:
    """SKILL.md 的「新增物三级」判据:排纲、定设定都要按它分级,而任务包外的 SKILL.md 读不到。

    只取这一块引用:从标题那行起,到引用结束或下一块以加粗标题开头的引用为止。"""
    lines = (SKILL_ROOT / "SKILL.md").read_text(encoding="utf-8").splitlines()
    pattern = re.compile(r"^>\s*\*\*(?:%s)\*\*" % "|".join(map(re.escape, TIERS_TITLES)))
    start = next((i for i, line in enumerate(lines) if pattern.match(line)), None)
    if start is None:
        raise SystemExit("ERROR: SKILL.md 里找不到「新增物三级」")
    block = [lines[start]]
    for line in lines[start + 1:]:
        if not line.startswith(">") or re.match(r"^>\s*\*\*", line):
            break
        block.append(line)
    return "\n".join(line[2:] if line.startswith("> ") else line.lstrip(">") for line in block)


def conditional_reads(task: str) -> str:
    lines = ["下面几份在包外,只在条件满足时读,只读点名的那一节(没点名读整份);条件不满足不读。"
             "路径按你的参考文件路径规则解析;流程提到而这里没列的参考文件不用找,对标资料缺了就停下,说清缺哪份:"]
    for name, part, when in CONDITIONAL[task]:
        # 自检:包外点名的文件和小节必须真在,挪了小节或删了文件就报错,不让执行者扑空。
        text = read_reference(name)
        if part:
            section(text, part)
        where = f"「{part}」一节" if part else "整份"
        lines.append(f"- {when}:读 `agent-references/{name}` {where}")
    if CROSS_BOOK in CONDITIONAL[task]:
        lines.append(f"读了 {CROSS_BOOK[0]} 时:`gaps.*` 写进「要作者定的事」,「副对标召回摘要」不单独回。")
    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 or "段剧情" 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]}章;排纲笔记写 .story/排纲笔记/{unit}.md)", text))
    missing = [n for n in range(first, last + 1) if n not in covered]
    if missing:
        hint = (f";这些剧情段的标题末尾缺单元编号注释(如 <!-- L1-01 -->):{'、'.join(undeclared)}"
                if undeclared else "(每段剧情的标题末尾写单元编号注释,如「### 第一段剧情:退婚风波 <!-- L1-01 -->」,卡里写「章节范围:第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`。"
                "作者在定方向时说过的话都在 `设定/题材定位.md`,先读它;拿不准的写成二选一的候选留给作者定,不替作者拍板,"
                "物价、收入、力量档位这类全书刻度按下附「新增物三级」属问作者,只给候选。"
                f"不出卷纲、不写正文。{outside}交付后只回:写了哪些文件、主角与核心冲突各一句、"
                "要作者定的事(没有写「无」)。")
        setup = read_reference("workflow-setup.md")
        parts = [("workflow-setup.md(Phase 2)", section(setup, "Phase 2:核心设定")),
                 ("workflow-setup.md(题材定位、全书梗概、关系模板)",
                  templates("workflow-setup.md", "题材定位", "全书梗概", "关系")),
                 ("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`,"
                "并补齐 `设定/题材定位.md`「题材框架」的「关键转折节点」(标题写 `## 题材框架`,去掉「(出卷纲时补)」,其余小节不动);"
                "不出细纲、不写正文、不建 `追踪/`。本书方向、设定、对标登记与作者已定的事读 `设定/`(先读 "
                f"`设定/题材定位.md`)。{outside}交付后只回:写了哪些文件、排纲自查四项"
                "的结论各一句、要作者定的事(没有写「无」)。")
        parts = [("workflow-volume.md(排纲方法)", section(read_reference("workflow-volume.md"), "排纲方法")),
                 ("artifact-protocols.md", read_reference("artifact-protocols.md")),
                 ("outline-methods.md(卷纲排法)", section(read_reference("outline-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}章,以及排纲笔记(`.story/排纲笔记/{{剧情段编号}}.md`)与必要的设定补全,不写正文、"
                "不建 `追踪/`。本批涉及的卷纲剧情段附在包末(已按段取好),卷纲本身不整读;设定从 `设定/` 定点读;"
                f"{outside}交付后只回:写了哪些文件、"
                "每章一句核心事件、要作者定的事(没有写「无」)。")
        plot = read_reference("plot-core-methods.md")
        parts = [("workflow-outline.md(排纲方法)", section(read_reference("workflow-outline.md"), "排纲方法")),
                 ("outline-template.md", read_reference("outline-template.md")),
                 ("long-chapter-hooks.md(章尾钩子 13 式、章首钩子 7 式)",
                  drop_last_column(section(read_reference("long-chapter-hooks.md"), "章尾钩子 13 式", "章首钩子 7 式"))),
                 ("character-basics.md(主角卡、配角卡模板)", templates("character-basics.md", "主角卡", "配角卡"))]
        if first <= 3:
            parts += [("plot-core-methods.md", plot),
                      ("opening-design.md(开篇规划)",
                       section(read_reference("opening-design.md"), "开篇规划"))]
        else:
            parts.append(("plot-core-methods.md(不含开篇噱头)",
                          section(plot, *PLOT_CORE_AFTER_OPENING)))
        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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall