用途
Section Briefs 用于研究写作流水线中的章级规划阶段。它在生成稳定的 H3 分解之前,从章节骨架与章节绑定构建章级 brief(规划卡片),作为后续分解的规划基底,而不是直接产出成稿文字。
触发与路由
触发词:section briefs、chapter planning cards、section-first briefs、章节 brief、章级 brief。
使用时机:当 section bindings 已存在,且本次运行需要在输出稳定 H3 id 之前获得章级理由与分解指导时使用。
加载顺序
始终读取:references/overview.md。
仅使用 scripts/run.py 进行确定性的 brief 组装:
- 读取 outline/chapter_skeleton.yml 获取章节 ID 与目标形态
- 读取 outline/section_bindings.jsonl 获取饱和度与缺口信号
- 存在时读取 GOAL.md 以确定运行级范围
- 写入 outline/section_briefs.jsonl 作为规划基底,而非成稿文字
输入
- outline/chapter_skeleton.yml
- outline/section_bindings.jsonl
- 可选:GOAL.md
输出
- outline/section_briefs.jsonl
资产契约
- assets/output_contract.json
脚本
快速开始:
uv run python .codex/skills/section-briefs/scripts/run.py --workspace <workspace>
全部选项:
- --workspace <dir>:包含章节骨架与章节绑定的工作区
- --unit-id <id>:可选的 harness 元数据
- --inputs <semicolon-separated>:可选的来自 UNITS.csv 的输入覆盖
- --outputs <semicolon-separated>:可选的输出覆盖;默认为 outline/section_briefs.jsonl
- --checkpoint <C*>:可选的 harness 元数据
示例
从 section-first 层构建章级 brief:
uv run python .codex/skills/section-briefs/scripts/run.py --workspace <workspace> --inputs 'outline/chapter_skeleton.yml;outline/section_bindings.jsonl;GOAL.md' --outputs 'outline/section_briefs.jsonl'
适用场景
适用于已存在 section bindings、需要在生成稳定 H3 id 之前获得章级理由与分解指导的研究写作流水线场景。
限制
资料未提供关于收费、价格、平台支持范围、效果保证等方面的信息。