git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v2 5/5] docs(l10n): add AI agent instructions to review translations

From
Jiang Xin <worldhello.net@gmail.com>
Date
Mar 12, 2026, 02:34 UTC
Message-ID
<CANYiYbG3CtSnis4NfhsH3SLyTPEurW2acqtj3snt4FO-2X809A@mail.gmail.com>
In-Reply-To
<d7a7a07acdcf15520019fc58be5e6a1a1e24791a.1772551123.git.worldhello.net@gmail.com>
On Tue, Mar 3, 2026 at 11:34 PM Jiang Xin <worldhello.net@gmail.com> wrote:
Show 27 quoted lines
> +### Task 4: Review translation quality
> +
> +Review may target the full `po/XX.po`, a specific commit, or changes since a
> +commit. When asked to review, follow the steps below. **Note**: This task uses
> +`git-po-helper compare`; if `git-po-helper` is not available, the task
> +cannot be performed.
> +
> +1. **Check for existing review**: Evaluate the following in order:
> +
> +   - If `po/review-input.po` does **not** exist, proceed to step 2 regardless
> +     of any other files (e.g., batch or JSON files).
> +   - If both `po/review-input.po` and `po/review-result.json` exist, go
> +     directly to step 5 (Merge and summary) and display the report.
> +     Do **not** check for batch or other temporary files; no further review
> +     steps are needed.
> +   - If `po/review-input.po` exists but `po/review-result.json` does not,
> +     go to step 4 (Process one batch) to continue the previous review.
> +
> +2. **Extract entries**: Run `git-po-helper compare` with the desired range and
> +   redirect the output to `po/review-input.po`. Do not use `git show` or
> +   `git diff`—they can fragment or lose PO context (see "Comparing PO files
> +   for translation and review" under git-po-helper).
> +
> +3. **Prepare review batches**: Run the script below to clean up any leftover
> +   files from previous reviews and split `po/review-input.po` into one or
> +   more `po/review-input-<N>.json` files (dynamic batch sizing). Run as a
> +   single script (define the function, then call it):

In the v3 reroll, we will adopt a solution that is easier for the model to understand: using a single pending file to record data awaiting review, rather than splitting review tasks across multiple files and requiring the model to select among them.

> +                   git-po-helper msg-select --json --range "-$NUM" \
> +                       -o "po/review-input-$i.json" po/review-input.po

There are trailing spaces in this file that are breaking CI. This will be fixed in the v3 reroll.

Previous: Jiang XinNext: Jiang Xin
Message 25 of 45 in “[RFC] Introducing AI Agents to Git Localization”
  1. Jiang XinFeb 4, 2026
  2. Peter KreftingFeb 4, 2026
  3. Michal SuchánekFeb 4, 2026
  4. 依云Feb 4, 2026
  5. Jiang XinFeb 5, 2026
  6. brian m. carlsonFeb 5, 2026
  7. Jiang XinFeb 5, 2026
  8. Michal SuchánekFeb 5, 2026
  9. Jiang XinFeb 5, 2026
  10. Jiang XinFeb 5, 2026
  11. 1/2 l10n: add .gitattributes to simplify location filteringJiang Xin, Feb 5, 2026
  12. 2/2 l10n: README: document AI assistant guidelinesJiang Xin, Feb 5, 2026
  13. Michal SuchánekFeb 5, 2026
  14. Junio C HamanoFeb 5, 2026
  15. Junio C HamanoFeb 5, 2026
  16. Jiang XinFeb 6, 2026
  17. 0/5 docs(l10n): AI agent instructions and workflow improvementsJiang Xin, Mar 3, 2026
  18. 1/5 l10n: add .gitattributes to simplify location filteringJiang Xin, Mar 3, 2026
  19. 2/5 docs(l10n): add AGENTS.md with optimized update-pot instructionsJiang Xin, Mar 3, 2026
  20. 3/5 docs(l10n): add AI agent instructions for updating po/XX.po filesJiang Xin, Mar 3, 2026
  21. 4/5 docs(l10n): add AI agent instructions for translating PO filesJiang Xin, Mar 3, 2026
  22. 5/5 docs(l10n): add AI agent instructions to review translationsJiang Xin, Mar 3, 2026
  23. Jiang XinMar 12, 2026
  24. Jiang XinMar 12, 2026
  25. Jiang XinMar 12, 2026
  26. 0/5 docs(l10n): AI agent instructions and workflow improvementsJiang Xin, Mar 14, 2026
  27. 1/5 l10n: add .gitattributes to simplify location filteringJiang Xin, Mar 14, 2026
  28. 2/5 docs(l10n): add AGENTS.md with optimized update-pot instructionsJiang Xin, Mar 14, 2026
  29. 3/5 docs(l10n): add AI agent instructions for updating po/XX.po filesJiang Xin, Mar 14, 2026
  30. 4/5 docs(l10n): add AI agent instructions for translating PO filesJiang Xin, Mar 14, 2026
  31. 5/5 docs(l10n): add AI agent instructions to review translationsJiang Xin, Mar 14, 2026
  32. Johannes SixtMar 15, 2026
  33. Junio C HamanoMar 15, 2026
  34. Jiang XinMar 16, 2026
  35. Jiang XinMar 16, 2026
  36. Johannes SixtMar 16, 2026
  37. 0/5 docs(l10n): AI agent instructions and workflow improvementsJiang Xin, Mar 16, 2026
  38. 1/5 l10n: add .gitattributes to simplify location filteringJiang Xin, Mar 16, 2026
  39. 2/5 docs(l10n): add AGENTS.md with optimized update-pot instructionsJiang Xin, Mar 16, 2026
  40. 3/5 docs(l10n): add AI agent instructions for updating po/XX.po filesJiang Xin, Mar 16, 2026
  41. 4/5 docs(l10n): add AI agent instructions for translating PO filesJiang Xin, Mar 16, 2026
  42. 5/5 docs(l10n): add AI agent instructions to review translationsJiang Xin, Mar 16, 2026
  43. Jiang XinMar 31, 2026
  44. Junio C HamanoMar 31, 2026
  45. Jiang XinMar 31, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.