---
id: EPIC-0004
uid: 6f4a65
type: epic
status: closed
stage: done
title: 动态文档国际化体系 (Dynamic Documentation I18n)
created_at: '2026-01-12T00:00:00'
updated_at: '2026-01-15T20:25:38'
closed_at: '2026-01-15T20:25:38'
solution: implemented
dependencies: []
related: []
domains: []
tags:
- '#EPIC-0004'
- agent-native
- documentation
- i18n
progress: 2/2
files_count: 5
---

## EPIC-0004: 动态文档国际化体系 (Dynamic Documentation I18n)

## 目标 (Objective)

确保 Monoco 的文档在快速迭代中保持**中英双语同步**。通过 Agent 自动化流程，降低维护多语言文档的成本，防止文档腐烂。

## 核心理念 (Core Concepts)

1. **同构映射 (Isomorphic Mapping)**: 中文文档与英文文档必须保持 1:1 的文件结构映射。
   - `docs/en/guide.md` <-> `docs/zh/guide.md`
2. **自动化校验 (Automation Validation)**: 任何对源语言（通常是中文）的修改，都应触发一致性校验检查是否存在“孤儿文档”。
3. **KISS**: 优先实现质量控制（Scan），暂缓实现复杂的序列化对齐和自动翻译，保持系统简洁。

## 关键交付 (Key Deliverables)

1. **I18n CLI (`monoco i18n`)**:
   - `scan`: 扫描文档目录，报告缺失的翻译。支持 Suffix 和 Subdir 两种模式。
2. **质量门禁**: `scan` 命令支持标准退出码，可直接集成于 CI/CD 或 pre-commit。
3. **技能分发**: 已通过 `monoco sync` 将 I18n 维护技能分发至 Agent 工作区。
4. **[CUT] 自动补全 (`monoco i18n sync`)**: 需求暂缓，避免过度工程。
5. **[CUT] 锚点对齐 (Anchor Alignment)**: 需求暂缓。

## Technical Tasks (Child Features)

- [x] [[FEAT-0005]]: I18n 扫描器与状态报告 (Scanner) - Implemented
- [x] [[FEAT-0011]]: 增强 i18n 报告功能 (Reporting Enhancement) - Implemented

## 结论 (Solution)

核心能力（扫描与一致性检查）已随 `FEAT-0005` 和 `FEAT-0011` 交付。通过 `monoco i18n scan` 建立了文档质量门禁。高级自动化功能（如 `sync` 占位符生成和段落对齐）因当前阶段并非 WAU 瓶颈而被裁剪，以符合 Monoco 的 KISS 原则。

## Review Comments

- [x] Self-Review
