AgentSkillsCN

monoco_workflow_i18n_scan

I18n扫描工作流（Flow Skill）。定义从扫描缺失翻译到生成翻译任务的标准操作流程，保障多语言文档的质量与一致性。

SKILL.md
--- frontmatter
name: monoco_workflow_i18n_scan
description: I18n 扫描工作流 (Flow Skill)。定义从扫描缺失翻译到生成翻译任务的标准操作流程，确保多语言文档质量。
type: workflow
domain: i18n
version: 1.0.0

I18n Scan Workflow

I18n 扫描的标准化工作流，确保 "Scan → Identify → Generate Tasks" 流程。

工作流状态机

mermaid
stateDiagram-v2
    [*] --> Scan: 触发扫描
    
    Scan --> Identify: 扫描完成
    Scan --> Scan: 配置错误<br/>(修复配置)
    
    Identify --> GenerateTasks: 发现缺失
    Identify --> [*]: 无缺失<br/>(完成)
    
    GenerateTasks --> [*]: 任务生成完成

执行步骤

1. Scan (扫描)

  • •目标: 扫描项目中所有文档，识别翻译覆盖情况
  • •输入: 项目文件、i18n 配置
  • •输出: 扫描报告
  • •检查点:
    • • 检查 .monoco/config.yaml 中的 i18n 配置
    • • 运行 monoco i18n scan
    • • 确认源语言和目标语言设置正确
    • • 验证排除规则（.gitignore、build 目录等）

2. Identify (识别缺失)

  • •目标: 分析扫描结果，识别具体缺失的翻译
  • •策略: 对比源文件和目标文件
  • •检查点:
    • • 列出所有缺失翻译的源文件
    • • 识别缺失的目标语言
    • • 评估缺失翻译的影响范围
    • • 按优先级排序（核心文档优先）

3. Generate Tasks (生成任务)

  • •目标: 为缺失的翻译创建追踪任务
  • •策略: 根据缺失情况创建 Issue 或备忘录
  • •检查点:
    • • 为核心文档缺失创建 Feature Issue
    • • 为次要文档缺失创建 Memo 提醒
    • • 在 Issue 中标注需要翻译的文件路径
    • • 设置合理的优先级和截止日期

决策分支

条件动作
配置错误修复 .monoco/config.yaml，重新扫描
无缺失翻译流程完成，无需进一步操作
大量缺失创建 Epic，拆分为多个 Feature
关键文档缺失高优先级，立即创建 Issue

合规要求

  • •必须: 扫描前验证 i18n 配置正确
  • •必须: 所有核心文档必须有对应翻译
  • •建议: 定期运行扫描（如每周）
  • •建议: 将翻译任务与功能开发绑定

相关命令

bash
# 扫描缺失翻译
monoco i18n scan

# 创建翻译任务
monoco issue create feature -t "翻译 {filename} 到 {lang}"

# 添加备忘录
monoco memo add "需要翻译: {filepath}"

输出示例

扫描完成后，应生成如下报告：

code
I18n Scan Report
================
Source Language: en
Target Languages: zh, ja

Missing Translations:
- docs/guide.md → zh/guide.md [MISSING]
- docs/api.md → ja/api.md [MISSING]

Coverage: 85%