SuperAPI AI 工具集

chapter-skeleton

写作与研究

查看项目

更新于 10-16 04:42

技能介绍

用途

Chapter Skeleton 用于在研究单元流水线(research units pipeline)中构建受检索信息影响的章节骨架。它的定位是在分类法/核心范围之后、稳定的 H3 级分解之前,先让综述结构在章级意图(chapter-level intent)上稳定下来,再进入子章节映射和写作卡环节。输出文件为 outline/chapter_skeleton.yml。

触发与路由

触发词包括:chapter skeleton、chapter-level outline、H2 skeleton、section-first survey、章节骨架、章级骨架。

适用时机:当综述结构需要在子章节映射与写作卡之前先稳定章级意图时使用。

主要能力与使用方式

该技能始终读取 references/overview.md,并使用 scripts/run.py 进行确定性物化。运行逻辑为:读取 outline/taxonomy.yml 以获得受检索信息影响的主题结构;当 GOAL.md 存在时读取它以获取范围提示;然后产出 outline/chapter_skeleton.yml。经复核的用户工作成果仅通过当前显式的 refinement 标记予以保留。

快速开始命令:

uv run python .codex/skills/chapter-skeleton/scripts/run.py --workspace <workspace>

全部选项:

  • --workspace <dir>:包含 outline/taxonomy.yml 的工作区
  • --unit-id <id>:可选的 harness 元数据
  • --inputs <semicolon-separated>:来自 UNITS.csv 的可选覆盖
  • --outputs <semicolon-separated>:可选输出覆盖;默认为 outline/chapter_skeleton.yml
  • --checkpoint <C*>:可选的 harness 元数据

示例(在 taxonomy 之后生成章节骨架):

uv run python .codex/skills/chapter-skeleton/scripts/run.py --workspace <workspace> --inputs 'outline/taxonomy.yml;GOAL.md' --outputs 'outline/chapter_skeleton.yml'

输入与输出

输入:outline/taxonomy.yml;可选:GOAL.md。 输出:outline/chapter_skeleton.yml。 资产契约:assets/output_contract.json。

显式 refinement 标记

只有在复核了人工细化的骨架之后,才创建 outline/chapter_skeleton.refined.ok。当分类法、目标或生成器发生变化时,该标记将失效;此时重新运行会先备份,再重建骨架。

限制

关于收费、价格、平台支持范围等信息,资料未提供。