Skip to content

style(validate): finish the language sweep (closes #90) - #93

Merged
CarlLee1983 merged 1 commit into
agent/issue-84-message-languagefrom
agent/issue-90-response-contract-language
Aug 16, 2026
Merged

style(validate): finish the language sweep (closes #90)#93
CarlLee1983 merged 1 commit into
agent/issue-84-message-languagefrom
agent/issue-90-response-contract-language

Conversation

@CarlLee1983

Copy link
Copy Markdown
Owner

Closes #90堆在 #91 之上(base 是 agent/issue-84-message-language),這樣「validate/ 沒有英文訊息」才是可驗證的終點狀態——單獨基於 main 的話 coverage.py 那筆還在。#91 併入 main 之後這張的 base 會自動回到 main。

改了什麼

response_contract.py 的空殼 response 警告是 validate/ 最後一筆英文訊息:

  • evidence:successful response has no usable schema contract成功 response 沒有可用的 schema 契約
  • suggested_fix:Re-read the endpoint response envelope…重讀這個端點的回應封包並記下它的 schema;若來源確實未載明,就讓這個交付缺口留在報告裡。

掃過一次 loop_apidoc/validate/ 確認殘留為零。

判準搬到 AGENTS.md

原本只有 coverage.py 的 docstring 記著「validation 訊息用中文」,而這次的不一致正好發生在另一個模組——規則寫在模組裡,就只有讀那個模組的人看得到。改成寫進 AGENTS.md 的 Conventions:validation 的 issue 文字(evidencesuggested_fixfix_once)是產品輸出,與生成的 guide 同屬 zh-TW 那一側。

影響面

純措辭,無行為變更。字串在 repo 只有一處被斷言(tests/validate/test_validator.py),已更新;skills/ 的修正循環參考文件描述的是行為而非訊息字串,不需同步(它本身是英文文件,依政策正確)。benchmark 的 current_issue_classes 只數 code.severity,期望值未動。

Test plan

  • uv run pytest 2175 passed
  • uv run ruff check . / npm run docs:check PASS

空殼 response 那筆是 validate/ 最後一筆英文訊息,改成繁體中文後整個套件不再有
同一份報告用兩種語言對 operator 說話的情形(掃過一次確認為零)。

判準寫進 AGENTS.md 的 Conventions:validation 的 issue 文字是產品輸出,與生成的
guide 同屬 zh-TW 那一側。原本只有 coverage.py 的 docstring 記著這件事,而這次的
不一致正是發生在另一個模組——規則寫在模組裡就只有讀那個模組的人看得到。
@CarlLee1983
CarlLee1983 merged commit 7c5a7d7 into agent/issue-84-message-language Aug 16, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant