Skip to content

feat: 中英文双语重构 — 英文为规范主语言 + 中文副本同步维护 - #10

Merged
Minecraft269 merged 2 commits into
mainfrom
worktree-bilingual-refactor
Jul 11, 2026
Merged

feat: 中英文双语重构 — 英文为规范主语言 + 中文副本同步维护#10
Minecraft269 merged 2 commits into
mainfrom
worktree-bilingual-refactor

Conversation

@Minecraft269

@Minecraft269 Minecraft269 commented Jul 11, 2026

Copy link
Copy Markdown
Owner

概述

将全部 6 个技能、6 份文档、12 份参考文档、7 个脚本和所有项目文件从中文重构为英文作为规范语言,同时维护同步的中文副本。

变更内容

技能(6 个)

  • 英文 SKILL.md → 规范源文件,位于 skills/<name>/SKILL.md
  • 中文副本skills/<name>/locale/SKILL.cn.md(Claude Code 技能自动加载器不可见)
  • 所有中文副本 frontmatter 添加了 locale: zh-CN 标记

参考文档(12 个)

  • 英文参考文档skills/<name>/references/*.md
  • 中文副本skills/<name>/references/*.cn.md
  • 涵盖:错误处理、工作流、评论模板、审查清单、AI Agent 清单、语言指南、扫描器模式、验证场景等

脚本(7 个)

  • 中文注释和用户可见字符串翻译为英文
  • 全部通过 bash -n 语法检查

文档(6 个)

  • 英文文档docs/<name>.md
  • 中文副本docs/<name>.cn.md

项目文件

  • CLAUDE.md → 英文(语言策略更新)
  • CONTRIBUTING.md → 英文(能力标签注册表保留双语)
  • README.md → 英文
  • plugin.json / marketplace.json → 英文描述
  • skills/_shared/package-context.md → 英文正本,中文在 locale/

新增文件

  • skills/_shared/i18n-glossary.md — 权威中英术语映射表
  • skills/_shared/check-i18n-sync.sh — 结构同步验证脚本

验证结果

  • check-i18n-sync.sh:0 个问题(6 技能 + 6 文档结构同步)
  • bash -n:所有 .sh 文件语法检查通过
  • ✅ Glob 安全性:skills/*/SKILL.md 精确返回 6 个文件
  • ✅ 标签一致性:所有 capability 标签验证通过

统计

类别 EN 规范文件 CN 副本
技能 SKILL.md 6 6
参考文档 references/ 12* 12
脚注 scripts/ 7
文档 docs/ 6 6
共享协议 1 1
合计 32 25

*不含 mcp-templates.md(纯 JSON 模板)和 discovery-rules.example.json

翻译规则

  • YAML frontmatter:仅翻译 description 字段
  • 代码块和 shell 命令:绝不翻译
  • 技术标识符:两个版本均保留英文
  • 所有翻译为地道英文,非机器翻译

🤖 Generated with Claude Code

Minecraft269 and others added 2 commits July 11, 2026 19:14
- Translate all 6 SKILL.md files to idiomatic English as canonical source
- Move Chinese originals to locale/SKILL.cn.md (invisible to skill auto-loader)
- Translate 6 docs/*.md to EN, keep CN at docs/*.cn.md
- Translate CLAUDE.md, CONTRIBUTING.md, README.md to English
- Update plugin.json and marketplace.json descriptions to English
- Translate _shared/package-context.md to English
- Create _shared/i18n-glossary.md with authoritative EN↔CN term mappings
- Create _shared/check-i18n-sync.sh structural sync validator
- Add locale: zh-CN to all CN frontmatter copies
- Update language policy (CLAUDE.md): user-facing content now English

Verification:
- check-i18n-sync.sh: 0 issues (all 6 skills, 6 docs in sync)
- bash -n: all .sh files pass
- Glob safety: skills/*/SKILL.md returns exactly 6 files
- Tag consistency: all capability tags verified
- Translate 11 references/*.md to EN canonical, preserve CN at *.cn.md
- Translate Chinese comments and user-facing strings in 7 scripts/*.sh
- Skip mcp-templates.md (JSON templates) and discovery-rules.example.json
- All .sh scripts pass bash -n syntax check

Co-Authored-By: Claude <noreply@anthropic.com>
@Minecraft269
Minecraft269 marked this pull request as ready for review July 11, 2026 14:56
@Minecraft269
Minecraft269 merged commit 17fa219 into main Jul 11, 2026
2 checks passed
@Minecraft269
Minecraft269 deleted the worktree-bilingual-refactor branch July 11, 2026 14:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant