用途
sync-pt-parity 用于自动化英文（EN）到葡萄牙语（PT）的文件对齐工作流。给定一个英文规范仓库和一个葡萄牙语镜像仓库，它复制指定文件并注入一个“翻译待定”引用块。该技能适用于在英文规范仓库（ai-dev-toolkit）中发布新的 skills、patterns、agents 或 specs 之后，或当多个英文文件需要镜像到 PT 仓库（ai-dev-toolkit-pt-br）时。
主要能力
该技能会依次执行以下操作：
- 在英文规范仓库中定位每个文件。
- 复制到 PT 镜像仓库中的对应路径。
- 解析 frontmatter——提取闭合 --- 所在行号。
- 在 frontmatter 之后插入以下引用块：
Tradução pendente — conteúdo em inglês, aguardando tradução para pt-BR. Contribute to ai-dev-toolkit-pt-br.
- 在英文和 PT 两个仓库中创建功能分支（feature/skill-sync-pt-parity）。
- 在两个仓库中提交更改。
- 在两个仓库中打开 PR 并互相关联。
使用方式
调用时可直接请求：“Sync these files from EN to PT: skills/X.md, patterns/Y.md, agents/Z/AGENT.md”。在同步之前，需确保英文文件具有包含 name:、description:、triggers:（如适用）的 YAML frontmatter。
示例调用：
Sync EN → PT for wave 2 patterns:
- patterns/cost-aware-routing.md
- patterns/local-first-agents.md
- patterns/reasoning-model-prompting.md
Source: /Volumes/External\ HD/Desenvolvimento/ai-dev-toolkit Target: /Volumes/External\ HD/Desenvolvimento/ai-dev-toolkit-pt-br
此技能会创建：
- pt-br 仓库——3 个带有引用块 + frontmatter 结构的新文件，PR 就绪。
- EN 仓库——元数据提交（可选，若文件列表需要文档化）。
此外还提供可选的辅助脚本，用于自动化文件复制 + 引用块插入：
bash ~/.claude/skills/sync-pt-parity/sync.sh
--source /Volumes/External\ HD/Desenvolvimento/ai-dev-toolkit
--target /Volumes/External\ HD/Desenvolvimento/ai-dev-toolkit-pt-br
--files "patterns/cost-aware-routing.md,patterns/local-first-agents.md"
该脚本会依次：复制每个文件；找到 frontmatter 的闭合 ---；在其后插入引用块；暂存以提交。
关键约束：引用块位置
必须始终将“Tradução pendente”引用块放在 YAML frontmatter 的闭合 --- 之后。原因是 kit 校验器（kit/scripts/validate.sh）在渲染 markdown 之前解析 frontmatter，若引用块位于 frontmatter 之前会破坏 YAML 解析器并导致校验失败。规则如下：
- 位于 frontmatter 之前 → 无效（kit 校验器失败）
- 位于闭合 --- 之后 → 有效（校验器通过，内容可渲染）
错误示例（导致校验器失败——见提交 5c899ef）：
Tradução pendente — conteúdo em inglês...
name: example description: ...
正确示例（校验器通过）：
name: example description: ...
Tradução pendente — conteúdo em inglês...
适用场景
- 在英文规范仓库中发布新的 skills、patterns、agents 或 specs 之后。
- 当多个英文文件需要镜像到 PT 仓库时。
限制
资料中未提供关于收费、价格、平台或效果的具体信息。