用途
Authoring Analysis 用于在页面导入或迁移流程中,为每一个内容序列(content sequence)确定创作方式:是作为默认内容(default content),还是使用某个特定区块(block)。它由 page-import 技能在 Step 3 调用,依赖 identify-page-structure 技能提供的章节边界、样式说明、内容序列描述以及区块清单(本地 + Block Collection)。
主要能力
-
默认内容检查(Step 3a):对每个内容序列,首先判断作者能否在 Word/Google Docs 中通过普通输入完成。标题、段落、列表、内联图片、简单引用等属于默认内容;重复的结构化模式(卡片网格、功能列表)、交互组件(手风琴、标签页、轮播)、复杂布局(并排栏、分栏内容)等则不属于默认内容,需要进入区块选择流程。
-
区块选择(Step 3b):对于非默认内容,根据区块清单判断应使用哪个区块。若内容描述与区块用途完全匹配(如网格项对应 cards、可展开问答对应 accordion、标签面板对应 tabs、并排内容对应 columns、轮播图片对应 carousel),则直接使用;若存在歧义、清单中缺少匹配区块或需要验证作者心智模型,则调用 content-modeling 技能。
-
验证区块存在(Step 3c):若区块不在 Block Collection 常见集合中,调用 block-collection-and-party 技能确认区块存在、获取在线示例 URL 并审查内容模型。
-
获取区块 HTML 结构(Step 3d):在生成 HTML 之前,使用 get-block-structure.js 脚本获取所有将使用区块的装饰前 HTML 结构,例如:
node .claude/skills/block-collection-and-party/scripts/get-block-structure.js cards
node .claude/skills/block-collection-and-party/scripts/get-block-structure.js tabs
node .claude/skills/block-collection-and-party/scripts/get-block-structure.js accordion
node .claude/skills/block-collection-and-party/scripts/get-block-structure.js columns
该步骤用于了解每行应包含多少列、图片与内容的位置、匹配正确的变体,并避免 HTML 结构错误。
- 章节样式验证(Step 3e):仅当某章节恰好包含一个内容序列且该序列成为区块,并且该章节具有来自 identify-page-structure 的独特背景样式时执行。通过查看 screenshot.png 并回答三个问题(背景是否为图片/渐变、内容是否全出血、区块类型是否通常自带背景样式),决定是跳过还是保留 section-metadata。若不确定,默认保留 section-metadata 并记录说明。
使用方式
该技能由 page-import 技能在 Step 3 调用。执行前需要具备:来自 identify-page-structure 的章节边界与样式说明、每个章节的内容序列(中性描述)、区块清单(本地 + Block Collection 及用途)、以及用于视觉参考的 screenshot.png。完成分析后,将输出传递给 generate-import-html 技能。
适用场景
适用于将现有页面导入或迁移到 Adobe Helix 网站体系时,需要为每个内容序列决定创作方式、选择区块并验证章节样式的场景。
限制
该技能依赖上游技能提供的章节结构、内容序列和区块清单;若区块选择不明确,需要调用 content-modeling;若区块不在常见集合中,需要调用 block-collection-and-party 验证。章节样式验证仅针对单区块章节,多序列章节始终保留 section-metadata。