feat: skills i18n 改造(schemaVersion 1.1,零向后兼容) (#1)

* feat: skills i18n 改造 — schemaVersion 1.1,零向后兼容

把 21 个 skills + 1 个 agent + manifest/categories 全量迁移到 schemaVersion 1.1
的 i18n 结构,配套 CI AI 翻译流水线(GitHub Models)与本地工具链。

## 关键变更

### 数据结构(破坏性,schemaVersion 1.0 → 1.1)
- SKILL.md: 顶层 name 改为 ASCII slug(== 目录名,符合 agentskills.io 规范);
  中文显示名/short_desc/description 全部迁入 metadata.i18n.<locale>
- agents/<id>/agent.json: shortDesc/fullDesc/tags/persona.{role,traits} 迁入
  i18n.<locale>;changelog[].changes 改为 { <locale>: string[] } 对象
- categories.json: 每个分类的 label/description 迁入 i18n.<locale>,顶层只剩
  color/icon
- manifest.json: 加 supportedLocales / defaultLocale;顶层 description 迁入
  i18n.<locale>

### Body 文件结构
- 根 SKILL.md = frontmatter + default_locale (en-US) body
- SKILL.<locale>.md = 各 locale 的 markdown body(首行 <!-- locale: xx --> 自校验)

### 工具链(scripts/i18n/)
- glossary.json: zh→en 术语表 + do_not_translate 白名单
- schema/skill-frontmatter.schema.json: i18n frontmatter JSON Schema
- validate-i18n.py: 8 条校验规则(name 合规 / locale 完整性 / hash 一致性等)
- translate.py: GitHub Models / Anthropic 双 backend,sha256 增量翻译
- migrate.py: 一次性迁移脚本(旧格式 → i18n 结构)

### CI(.github/workflows/)
- i18n-validate.yml: PR 触发跑 validate + translate --check
- i18n-translate.yml: PR 触发用 GitHub Models(默认 openai/gpt-5-mini)翻译缺失
  locale,自动追加 commit;可切到 ANTHROPIC_API_KEY 走 Claude

### 文档
- docs/I18N.md: 作者贡献指南(schema 说明 / 提交流程 / 常见问题)
- README.md: 加多语言段落

## 验证

- uv run scripts/i18n/validate-i18n.py: OK,49 文件 0 错误
- uv run scripts/i18n/translate.py --check: 0 stale locale
- 21 skills 标题数 zh-CN == en-US 严格对齐(最大 66=66)
- skills-ref 规范校验:全部通过(顶层 name ASCII slug + description 单字段)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix(i18n): 修复 PR #1 review 反馈的 6 项问题

- schema: translated_by 正则放宽为 ^(human|ai:[A-Za-z0-9._:/-]+)$,接受
  'ai:github:openai/gpt-5-mini' 这类 backend:model 形式(CI 翻译输出格式)
- README + docs/I18N.md: 修正"CI 用 Claude API"误导描述,正确说明默认是
  GitHub Models(openai/gpt-5-mini)+ GITHUB_TOKEN,可选切到 Anthropic
- skills/minimax-tts/SKILL.md & SKILL.zh-CN.md: 删除多余的 ``` 闭合,避免
  Markdown 后续渲染错乱
- skills/docx/SKILL.md: 翻译时丢失的 • Unicode escape 示例已恢复,
  与 zh-CN 版本对齐

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-05 00:26:33 +08:00
committed by GitHub
parent 1c107a9344
commit 1f7c8b9673
59 changed files with 10533 additions and 2014 deletions

View File

@@ -1,5 +1,5 @@
---
name: 前端设计
name: frontend-design
description: >-
Create distinctive, production-grade frontend interfaces with high design
quality. Use this skill when the user asks to build web components, pages,
@@ -25,6 +25,29 @@ tags:
metadata:
author: anthropic
updated_at: '2026-04-13'
i18n:
default_locale: en-US
source_locale: zh-CN
locales:
- zh-CN
- en-US
zh-CN:
name: 前端设计
short_desc: 创建有品味、避免 AI 烂大街审美的前端界面与组件
description: >-
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics. Use when 用户提到 前端设计、网页设计、UI 设计、 界面设计、组件、海报、Landing Page、落地页、React 组件、Vue 组件、 CSS 样式、美化界面、设计一个、做一个网页、官网、仪表盘、Dashboard。
body: ./SKILL.zh-CN.md
source_hash: sha256:136983c7c029579c
translated_by: human
en-US:
name: Frontend Design
short_desc: Create tasteful frontend interfaces and components that avoid generic AI aesthetics
description: >-
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics. Use when the user mentions frontend design, web design, UI design, interface design, components, posters, landing pages, React components, Vue components, CSS styling, polishing the UI, designing something, building a webpage, official site, or dashboard.
body: ./SKILL.md
source_hash: sha256:136983c7c029579c
translated_by: ai:claude-opus-4-7
translated_at: '2026-05-03'
market:
icon: >-
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0
@@ -40,7 +63,6 @@ market:
fill="url(#fd-a)" fill-opacity="0.2" stroke="url(#fd-a)"
stroke-width="1"/><path d="M14 11h5M14 13.5h3.5M14 16h4.5"
stroke="url(#fd-a)" stroke-width="1.2" stroke-linecap="round"/></svg>
short_desc: 创建有品味、避免 AI 烂大街审美的前端界面与组件
category: design
maintainer:
name: DesireCore Official
@@ -48,35 +70,35 @@ market:
channel: latest
---
# frontend-design 技能
# frontend-design Skill
## L0:一句话摘要
## L0: One-line Summary
创建有品味、避免 AI 烂大街审美的高质量前端界面与组件。
Create tasteful, production-grade frontend interfaces and components that avoid generic AI aesthetics.
## L1:概述与使用场景
## L1: Overview and Use Cases
### 能力描述
### Capability Description
frontend-design 是一个**流程型技能(Procedural Skill**,引导创建独特、生产级的前端界面,避免千篇一律的 AI 生成审美。输出真实可运行的代码,注重美学细节和创意选择。
frontend-design is a **Procedural Skill** that guides the creation of distinctive, production-grade frontend interfaces while avoiding cookie-cutter AI-generated aesthetics. It outputs real, runnable code with attention to aesthetic detail and creative choices.
### 使用场景
### Use Cases
- 用户需要创建网页组件、页面或应用Landing Page、仪表盘、React 组件等)
- 用户需要为现有 Web UI 进行样式美化
- 用户需要创建海报、视觉设计等前端产出物
- The user needs to create web components, pages, or applications (landing pages, Dashboards, React components, etc.)
- The user needs to polish the styling of an existing web UI
- The user needs to create posters, visual designs, or other frontend deliverables
### 核心价值
### Core Value
- **反 AI 审美**:拒绝 Inter 字体 + 紫色渐变的烂大街风格
- **设计思维驱动**:先确定美学方向,再编写代码
- **生产级质量**:输出可直接使用的完整代码
- **Anti-AI aesthetics**: rejects the cliched Inter font + purple gradient style
- **Design-thinking driven**: settle on an aesthetic direction first, then write code
- **Production-grade quality**: outputs complete, ready-to-use code
## L2:详细规范
## L2: Detailed Specification
## Output Rule
When you create or modify HTML/CSS/JS/React/Vue files, you **MUST** tell the user the absolute path of the output file in your response. Example: "文件已保存到:`/path/to/index.html`"
When you create or modify HTML/CSS/JS/React/Vue files, you **MUST** tell the user the absolute path of the output file in your response. Example: "File saved to: `/path/to/index.html`"
If you create multiple files (e.g. HTML + CSS + JS), list each path explicitly.