mcpField
C
comet-bilingual-docs

comet-bilingual-docs

github.com/rpamis文档处理3.2k120 次安装今天更新
代码仓库

关于 comet-bilingual-docs

comet-bilingual-docs 是用于维护 Comet 中英文文档的技能,面向文档维护者。它强调先确认中文语义,再谨慎同步英文,并通过格式和仓库检查验证变更。

主要功能

  1. 01先阅读维护者契约
  2. 02确认中文源语义
  3. 03同步中英文文档
  4. 04运行格式与差异检查
  5. 05按需验证网站文档

适用场景

  1. 01更新 Comet 用户文档
  2. 02同步中英文 Changelog 和网站
  3. 03处理需要用户确认的技能内容

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/rpamis/comet --skill comet-bilingual-docs

安装后在 Claude Code 中输入/comet-bilingual-docs确认已加载。

附带文件agents/openai.yaml

详细介绍

来自项目 README

Comet 双语文档

先读取 ../comet-github/references/maintainer-contract.md,并将文档变更限制在用户要求的范围内。

确定源语义

  1. 确认权威的行为、发布范围或已接受的中文措辞。
  2. 先更新并审阅中文语义。翻译时不要静默改变已经确认的用户可见术语。
  3. Skill 内容需要用户确认时,在中文版本完成后暂停;确认后再同步英文版本。
  4. 明确要求发布同步时,保持主 Changelog 和中英文网站页面的用户可见语义及信息架构一致。

谨慎同步

  • 除非变更确实需要,准确保留示例、命令名、配置键、链接、锚点和代码围栏。
  • 中文术语要自然,不要把 workflow 的 “gate” 翻译为“门”。
  • 不增加用户不需要的实现细节。
  • 将 D:\Project\comet-website-docs 视为独立仓库。用户授权交付时,先提交网站仓库,再更新父仓库 gitlink。

验证与报告

运行受影响文件的 Prettier 和 git diff --check。网站变更从网站仓库运行 mint validate --disable-openapi,或报告准确的 fallback/超时。README 或仓库契约变更时,运行可用的聚焦仓库契约测试。

报告源语言、同步的文件范围、验证结果和有意延后的翻译。除非用户明确要求,不提交或推送;交付时使用 comet-safe-delivery。

评论

支持 Markdown