mcpField
C
chapter-briefs

chapter-briefs

github.com/willoscar生产力51745 次安装3 周前更新
代码仓库

关于 chapter-briefs

chapter-briefs 是一项写作技能，可根据大纲和小节简报生成章节级规划卡片。它帮助作者用共同的比较维度和术语串联 H3 小节，避免各节彼此割裂。

主要功能

  1. 01生成章节级写作卡片
  2. 02设定章节主线与对比
  3. 03规划引导段落
  4. 04选择综合方式
  5. 05统一小节间术语

适用场景

  1. 01规划相互衔接的 H3 小节
  2. 02为章节引导段落做准备但不写正文

安装

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

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill chapter-briefs

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

附带文件scripts/run.py

详细介绍

章节简报（H2 写作卡片）[无正文]

触发条件与路由

  • 触发词：chapter briefs、H2 briefs、chapter lead plan、section intent、章节意图、章节导读、H2 卡片。
  • 适用场景：outline/outline.yml 和 outline/subsection_briefs.jsonl 已存在，且你希望章节内容更充实（标题更少、逻辑更强）。

目的：将每个包含 H3 子章节的 H2 章节转化为章节级写作卡片，以便作者：

  • 添加章节导语段落块（增强连贯性）
  • 在整章中保持一致的比较维度
  • 避免出现“8 个小孤岛”，即每个 H3 都从头开始

此产物表达的是内部意图，不是面向读者的正文。

这对写作质量很重要的原因：

  • 章节简报可避免“段落孤岛”这一失败模式：如果缺少贯穿全文的主线，每个 H3 都会重新起笔并重复开场内容。
  • 将 throughline 和 lead_paragraph_plan 视为决策约束，而非可直接照搬的句子。

输入

  • outline/outline.yml
  • outline/subsection_briefs.jsonl
  • 可选：GOAL.md

输出

  • outline/chapter_briefs.jsonl

输出格式（outline/chapter_briefs.jsonl）

JSONL（每个包含 H3 子章节的 H2 章节对应一个对象）。

必填字段：

  • section_id、section_title
  • subsections（列表，包含按大纲顺序排列的 {sub_id,title}）
  • synthesis_mode（取值之一：clusters、timeline、tradeoff_matrix、case_study、tension_resolution）
  • synthesis_preview（1–2 个要点；说明本章将如何综合各 H3 内容，避免使用模板化的“综上所述……”）
  • throughline（3–6 个要点）
  • key_contrasts（2–6 个要点；尽可能从各 H3 的 contrast_hook 提取）
  • lead_paragraph_plan（2–3 个要点；仅写计划，不写正文）
    • 每个要点应针对具体章节，并提及具体抓手（维度／对比点／评估视角）。
    • 避免使用“第 1 段：介绍本章”这类泛泛的衔接语，而不说明比较什么。
  • bridge_terms（5–12 个词项；汇总各 H3 的衔接词）

C5 的使用方式（章节导语约定）

作者使用 outline/chapter_briefs.jsonl 起草 sections/S<sec_id>_lead.md（仅正文；无标题）。

约定（仿论文写法，不引入新事实）：

  • 预览本章的比较维度（2–3 个）以及各 H3 之间的联系；不要复述目录。
  • 将 key_contrasts／bridge_terms 用作抓手（而非模板），让章节保持连贯，避免到处重复“综上所述”。
  • 内容应有依据（后续 C5 中至少引用 2 篇文献；此处不要虚构新论文）。

工作流

  1. （可选）阅读 GOAL.md，明确范围／受众，并将该约束融入章节主线。
  2. 阅读 outline/outline.yml，列出包含 H3 子章节的 H2 章节。
  3. 阅读 outline/subsection_briefs.jsonl，按 section_id 对简报分组。
  4. 对每个章节，生成：
    • 贯穿主线：说明整章要比较／解释什么
    • 关键对比：2–6 个横跨多个 H3 的对比点
    • 综合模式：确保各章节的综合方式多样（避免反复使用相同的结尾段落结构）
    • 导语段落计划：2–3 个段落目标（说明章节导语必须完成什么）
    • 衔接词：一组 bridge_terms，让各 H3 的术语保持一致
  5. 写入 outline/chapter_briefs.jsonl。

质量检查清单

  • 每个包含 H3 子章节的 H2 章节对应一条记录。
  • 不含占位符（TODO／…／(placeholder)／模板说明）。
  • throughline 和 key_contrasts 均针对具体章节（不能使用通用内容复制粘贴）。
  • lead_paragraph_plan 中的要点明确预览 2–3 个比较维度，以及各 H3 子章节如何划分这些维度（不得使用泛泛的章节介绍套话）。

脚本

快速开始
  • uv run python .codex/skills/chapter-briefs/scripts/run.py --help
  • uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace>
所有选项
  • --workspace <dir>
  • --unit-id <U###>
  • --inputs <semicolon-separated>
  • --outputs <semicolon-separated>
  • --checkpoint <C#>
示例
  • 默认 IO：
    • uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace>
  • 显式指定 IO：
    • uv run python .codex/skills/chapter-briefs/scripts/run.py --workspace <workspace> --inputs "outline/outline.yml;outline/subsection_briefs.jsonl;GOAL.md" --outputs "outline/chapter_briefs.jsonl"
优化标记（推荐；可避免反复改动）

满意章节简介后，请创建：

  • outline/chapter_briefs.refined.ok

这是一个明确的“我已审阅并优化”信号：

  • 防止脚本重新生成并撤销你的修改
  • （在严格运行中）可用作完成信号，避免在不知情的情况下接受初始框架
说明
  • 此辅助工具仅用于搭建初始框架；如有需要，请手动优化。

评论

支持 Markdown