30 lines
2.8 KiB
Markdown
30 lines
2.8 KiB
Markdown
# Implementation Plan
|
|
|
|
- [x] 1. Backfill English-only values in `locales/zh.json` with the natural Chinese translations from the design's Translation Contract
|
|
- Edit `step3.waitingForActions` → `等待智能体执行动作...`
|
|
- Edit `step4.waitingForReportAgent` → `等待报告智能体...`
|
|
- Edit `step5.interactiveTools` → `交互工具`
|
|
- Edit `step5.agentsAvailable` → `{count} 个智能体可用` (placeholder `{count}` preserved exactly once)
|
|
- Edit `step5.reportAgentChat` → `报告智能体 - 对话`
|
|
- Edit `graph.panelTitle` → `图谱关系可视化`
|
|
- Edit `graph.nodeDetails` → `节点详情`
|
|
- Edit `graph.relationship` → `关系`
|
|
- Edit `log.prepareTaskId` → ` └─ 任务 ID: {taskId}` (preserves the two-space indent, the `└─` glyph, and the `{taskId}` placeholder verbatim)
|
|
- Leave `home.heroDescBrand` as the literal string `MiroFish` (brand)
|
|
- Use the `Edit` tool only (do not run any `jq` write-back); do not add, remove, or reorder any keys
|
|
- Observable completion: `git diff --stat` shows exactly one file changed (`locales/zh.json`); `git diff locales/zh.json` shows only value changes for the listed keys (no key adds/removes/reorders)
|
|
- _Requirements: 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.2, 3.2, 3.3, 4.1, 4.2, 4.3_
|
|
|
|
- [x] 2. Validate JSON parseability, key alignment, and placeholder preservation after the backfill
|
|
- Run `jq empty locales/zh.json` and confirm exit code 0 (file is valid JSON)
|
|
- Run `diff <(jq -r 'paths(scalars) | join(".")' locales/en.json | sort) <(jq -r 'paths(scalars) | join(".")' locales/zh.json | sort)` and confirm output is empty (key sets identical)
|
|
- Run `jq -r '<key>'` for each of the ten keys and confirm the value matches the design's Translation Contract row (or `MiroFish` for `home.heroDescBrand`)
|
|
- Confirm `{count}` appears exactly once inside the new value of `step5.agentsAvailable`, and `{taskId}` appears exactly once inside the new value of `log.prepareTaskId`
|
|
- Observable completion: all five checks above pass; if any fails, return to task 1 and revise the offending edit before re-running validation
|
|
- _Requirements: 3.1, 3.3, 3.4, 3.5_
|
|
|
|
- [x] 3. Capture the `log.prepareTaskId` decision and any English-by-design exceptions for the PR description
|
|
- Record in a short note (in `.kiro/specs/i18n-backfill-zh-json/HANDOFF.md` if needed, or directly in the PR body at /done time) that: (a) `home.heroDescBrand` is intentionally kept as `MiroFish` because it is a brand; (b) `log.prepareTaskId` was translated to ` └─ 任务 ID: {taskId}` because it is rendered into the user-visible log panel by `Step2EnvSetup.vue:801` and surrounding `log.*` keys are translated.
|
|
- Observable completion: the rationale text is ready for inclusion in the PR description so reviewers can see the decisions at a glance
|
|
- _Requirements: 2.1, 2.3_
|