SuperAPI AI 工具集

section-briefs

写作与研究

查看项目

更新于 10-16 04:44

技能介绍

用途

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 之前获得章级理由与分解指导的研究写作流水线场景。

限制

资料未提供关于收费、价格、平台支持范围、效果保证等方面的信息。