SuperAPI AI 工具集

migrate-feature-page

通用与其它

查看项目

更新于 10-16 07:28

技能介绍

用途:在 Infrahub 文档改版中,将 Features 子分类下的单个功能页(或整个文档章节)从旧的 topic+guide 配对迁移为更清晰的结构,每次迁移使用独立分支和 PR 以便范围化评审。

主要能力:提供从预检、内容审计、规范评审、模式决策、创建新文件、更新侧边栏、构建验证到生成 redirects-pending 文件的完整工作流;支持单页合并、hub+spokes、教程抽取、拆分等模式;包含对教程形态、共享命名根、hub 可点击链接、遗留侧边栏标签、失效交叉链接的检查规则。

使用方式:用户提供功能或章节名称、Confluence 推荐文档链接(章节级迁移)及可选备注;技能推导 topic 与 guide 文件路径、侧边栏位置和入站链接。预检需确认当前分支为 demo/groups-diataxis-example,运行 git status -s,创建 docs/migrate-<feature-slug> 或 docs/migrate-<section-slug> 分支,确认本地 serve 与 build 基线。构建验证使用 cd docs && npm run build,并运行 npm run serve 目视检查。

适用场景:Infrahub 文档改版中的功能页或章节结构迁移,参考 Groups、Profiles、Computed Attributes 等先例。

限制:每个 ★ 门禁需停下与用户确认;不得静默推荐或应用变更,偏离推荐文档需显式批准;教程若为功能导向而非场景导向应标记并建议移除;写作需遵循既定语气规则,避免禁用短语与空洞限定词。具体收费、平台支持等信息暂未提供。