SuperAPI AI 工具集

add-doc-page

写作与研究

查看项目

更新于 10-15 21:55

技能介绍

用途:为 GramIO 文档站新增一个文档页面,同时生成英文与俄文版本,并完成侧边栏注册。

主要能力与步骤:

  1. 先阅读 AGENTS.md 了解约定(frontmatter、双语同步、图片规则)。
  2. 创建英文页 docs/{section}/{page-name}.md:添加含 title、description、keywords 的 YAML frontmatter,添加与 title 一致的 H1,添加简短引言占位段落,并参考同 section 的相邻页面模式。
  3. 创建俄文翻译 docs/ru/{section}/{page-name}.md:翻译 frontmatter、H1 与正文,严格保留代码块、twoslash 注解与 Markdown 结构,遵循 /translate-page 技能的翻译约定。
  4. 在 docs/.vitepress/config/locales/en.locale.ts 的侧边栏对应 section 中按现有模式添加链接。
  5. 在 docs/.vitepress/config/locales/ru.locale.ts 的对应 section 中添加带 /ru/ 前缀的链接。
  6. 若页面被移动或重命名,更新 public/_redirects:添加从旧路径到新路径的 301! 重定向,俄文页同样移动时添加对应 /ru/ 重定向。注意 _redirects 为 Netlify 专用,GitHub Pages 不支持。

使用方式:用户提供 [section/page-name] 参数,例如 guides/webhooks 或 plugins/official/my-plugin。

限制:资料未提供该技能的具体安装命令、收费方式与运行环境要求;翻译质量依赖 /translate-page 技能约定;重定向仅适用于 Netlify。完成后需报告创建了哪些文件以及用户应在何处补充内容。