SuperAPI AI 工具集

moonbit-docs-maintainer

写作与研究

查看项目

更新于 10-16 01:19

技能介绍

用途:该技能面向对 moonbitlang/moonbit-docs 仓库的改动,属于仓库维护路由器,而非 MoonBit 语言教程。先分类用户请求所触及的区域,检查相关本地文件,优先沿用现有布局与措辞模式,只加载任务区域对应的参考文件,做最小且可审查的改动,并运行能证明改动的最小验证命令。

路由:next/ 下的 Sphinx 文档、Markdown 页面、图片、Sphinx 配置或本地文档构建,读 references/sphinx.md;next/sources/ 下(不含 error_codes/)的 MoonBit 示例,读 references/examples.md;next/language/error_codes/ 或 next/sources/error_codes/ 的错误码文档,读 references/error-docs.md;next/locales/ 的翻译目录或 gettext 模板更新,读 references/translation.md;moonbit-tour/ 下的交互式导览改动,读 references/tour.md;涉及 typos 或 autocorrect 的拼写与散文 lint,读 references/typo.md。跨区域任务先读最具体的参考,再按验证需要读次要参考。

主要能力与命令:优先使用 just 配方与 uv 管理的 Python 依赖,除非任务明确要求且 uv 不可用,否则不建临时虚拟环境。just i18n 执行 gettext 提取与 zh_CN 目录同步,just i18n ja 处理其他语言;just docs-html、just docs-html-zh、just docs-html-ja 分别构建默认、中文、日文 Sphinx 文档;just check-docs 检查 next/sources/ 下非错误码 MoonBit 示例;just check-errors 检查 next/sources/error_codes/ 全部错误码示例;just check-error 0001 检查单个四位错误码。若无 just,使用对应参考中的回退方案。

限制与规则:不要编辑 next/_build/、moonbit-tour/dist/ 或依赖目录等生成输出;保持示例可运行,文档引用 next/sources/ 中代码时同步更新文档与示例;避免在 next/sources/ 大范围运行 moon fmt,仅在需要时格式化被触碰文件;保留已有双语结构;新 MoonBit 代码优先函数式风格并保持小改动;如需提交使用约定式提交信息。验证选择最小有效检查,包括 just docs-html 系列、python3 scripts/check-document.py、python3 next/check_error_docs.py all、python3 next/check_error_docs.py 0001、cd moonbit-tour && pnpm build、autocorrect . --lint --no-diff-bg-color;依赖缺失或完整检查代价过高时,运行最接近的定向命令并报告剩余风险。