SuperAPI AI 工具集

docs-impact-architect

写作与研究

查看项目

更新于 10-16 00:31

技能介绍

用途:当 docs-impact-classifier 返回 structural 判定时,由 docs-sync 编排器调用本技能,为 PR 设计文档结构变更。它不负责撰写正文(正文归 doc-writer),只做 TOC 架构的第一版设计,最终由 CDO 裁定是否符合 3-promise 叙事。

主要能力:读取 .apm/docs-index.yml 语料地图(chapters、pages、promises),将 PR 的表面变更归类为六种结构形态之一:NEW CAPABILITY、EXPANDED CAPABILITY、DEPRECATED CAPABILITY、CONCEPT SPLIT、CONCEPT MERGE、RAMP REORG。据此产出精确的 TOC 增量:新增页面(slug、标题、persona、promise、父章节、H2 小节、桥接链接、ramp 影响)、移动页面(含重定向理由)、退役页面(含 redirect_to)、章节变更。

使用方式:输入为分类器的 structural_proposal、PR diff(gh pr diff $PR)、.apm/docs-index.yml 与 PR 描述。按五步执行:读语料地图而非全文语料;判定结构形态;设计 TOC 增量;按硬规则校验 3-promise 叙事;输出单一 JSON 架构报告,含 structural_shape、toc_delta、promise_validation、downstream_in_place_pages 与 rationale,JSON 之外不加散文。

适用场景:新增 CLI 动词或 schema 概念、既有概念范围扩大需拆子页、能力废弃需退役页面、概念拆分或合并、以及概念在 promise 之间迁移导致 ramp 重组。

限制与规则:每个页面只能归属一个 promise,跨切面页面须显式标为 cross;consumer 页不得预教 producer 概念,producer 页不得预教 enterprise 概念;新页面必须有父章节和至少一条入站桥接,不得孤立;退役页面必须有 redirect_to,否则造成 SEO 债务。反模式包括虚增新页面数量、跳过 promise 校验、在既有章节有余量时新建章节、遗漏重定向。具体安装命令与运行环境资料暂未提供。