SuperAPI AI 工具集

docs

部署与运维

查看项目

更新于 10-16 00:21

技能介绍

用途:统一管理各类项目的文档流水线,按仓库类型自动选择模式。应用类(app-* 或存在 site/)走 Starlight(Astro)站点模式,库/服务类(private-lib-*)走内部 Markdown 模式,可用 --mode 覆盖。

主要能力:自动检测模式并报告文档状态;scaffold 初始化目录结构;create 按模板生成页面;audit 查找过期、缺失与断链;update 依据 git diff 与 CHANGELOG 更新;translate 做 EN→IT 翻译(仅应用模式);publish 部署到 VPS(仅应用模式);review-drafts 并行启动多个 agent 校验草稿与源码一致性;registry 查看注册表;features 从 CHANGELOG 与路由/API 提取功能清单;migrate 审计并建议迁移;full 串联完整流程。

使用方式:在仓库根目录执行 /docs 查看状态,/docs scaffold 初始化,/docs create getting-started 建页,/docs review-drafts 校验草稿,/docs publish 部署。应用模式使用 Starlight 0.32 + Astro 5 + pnpm,站点位于 site/,URL 为 {app-domain}/docs,默认语言意大利语、EN 配置在 en/ 子目录,需 content.config.ts,认证经 nginx auth_request 到 FastAPI /auth/verify,部署用 make deploy-site。内部模式输出到 docs/user-guide/,不使用 npm 或 Astro。

限制:翻译与发布仅应用模式可用;内部模式不部署;部分步骤需人工确认,如手动添加 /auth/verify 端点;文档未提供具体收费、价格与效果信息。