RomanNum3ral
/
MicroFish
mirror of https://github.com/666ghj/MiroFish.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
MicroFish/.kiro/specs/i18n-backfill-zh-json/tasks.md

2.8 KiB
Raw Blame History

Implementation Plan

  • 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

  • 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

  • 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