[PATCH v3 3/5] docs(l10n): add AI agent instructions for updating po/XX.po files

From: Jiang Xin <worldhello.net@gmail.com>
Date: Mar 14, 2026, 14:38 UTC
Message-ID: <bc00ca2d3069ca63800c70c40fea1be98a01c64c.1773497547.git.worldhello.net@gmail.com>
In-Reply-To: <cover.1773497547.git.worldhello.net@gmail.com>

Add a new section to po/AGENTS.md to provide clear instructions for updating language-specific PO files. The improved documentation significantly reduces both conversation turns and execution time.

Performance evaluation with the Qwen model:

    # Before: instructions in po/README.md; the custom prompt
    # references po/README.md during execution
    git-po-helper agent-test --runs=5 --agent=qwen update-po \
        --prompt="Update po/zh_CN.po according to po/README.md"

    # After: instructions in po/AGENTS.md; the built-in prompt
    # references po/AGENTS.md during execution
    git-po-helper agent-test --runs=5 --agent=qwen update-po

Benchmark results (5-run average):

    | Metric      | Before  | After  | Improvement |
    |-------------|---------|--------|-------------|
    | Turns       | 22      | 4      | -82%        |
    | Exec. time  | 38s     | 9s     | -76%        |
    | Turn range  | 17-39   | 3-9    |             |
    | Time range  | 25s-68s | 7s-14s |             |

Signed-off-by: Jiang Xin <worldhello.net@gmail.com>
---
 po/AGENTS.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/po/AGENTS.md b/po/AGENTS.md
index 94b7aa7f28..f2b8fc5100 100644
--- a/po/AGENTS.md
+++ b/po/AGENTS.md
@@ -59,6 +59,17 @@ When asked to generate or update `po/git.pot` (or the like):
    command and consider the task complete.
 
 
+### Task 2: Updating po/XX.po
+
+When asked to update `po/XX.po` (or the like):
+
+1. **Directly execute** the command `make po-update PO_FILE=po/XX.po`
+   without reading or checking the file content beforehand.
+
+2. **Do not verify, translate, or review** the updated file after execution.
+   Simply run the command and consider the task complete.
+
+
 ## Human translators remain in control
 
 Git translation is human-driven; language team leaders and contributors are

-- 
2.53.0.rc2.20.g532543fa46