OPC/dev_harness
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

统一中英文输入与中文输出规范 #31

New Issue
Closed
opened 2026-09-02 15:08:17 +08:00 by ila · 2 comments
ila commented 2026-09-02 15:08:17 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：单元任务
  • 阶段：已完成
  • 原始需求来源：当前对话，2026-09-02
  • 关键需求摘要：用户可以使用中文或英文与 Agent 对话，Agent 默认使用中文回答，同时保留合理的英文术语和原文。
  • 前置工单：无
  • 是否允许并行：是；与待验收 #28、#30 无实施依赖，当前工作区干净。
  • 设计证据：无 UI；采用已确认的语言规范。

目标

  • 接受中文、英文或合理混合语言的用户输入。
  • Agent 默认以中文分析、回复、编写工单和内部项目文档。
  • 代码标识符、命令、路径、API 名称、错误原文和通用英文术语保持原样。
  • 必要时在英文术语首次出现时补充简短中文解释。
  • 用户明确要求其他输出语言时，仅对该次任务按要求执行。
  • Codex 与 Claude Code 使用相同规范。

非目标

  • 不翻译代码、命令、路径、日志或错误原文。
  • 不强制把所有行业术语替换为中文。
  • 不新增语言检测脚本、翻译服务或配置文件。
  • 不修改用户输入内容。
  • 不创建任务归档。

已确认方案

  1. 在共享 AGENTS.md 增加简短语言与术语规则。
  2. 在 Development-Workflow Wiki 记录完整长期规则，回读后同步本地镜像。
  3. CLAUDE.md 继续通过 @AGENTS.md 复用，不重复维护。
  4. 默认中文是项目协作约定，不覆盖用户对当前交付物的明确语言要求。
  5. 保留有助于准确搜索、执行和排错的英文原文。

影响范围

  • AGENTS.md
  • Gitea Wiki：Development-Workflow
  • docs/01-workflow.md
  • dev_scripts/harness.py 和相关测试

风险与回退

  • 风险：机械翻译英文术语降低搜索与排错效率；通过保留原文控制。
  • 风险：默认中文被误解为禁止英文交付；明确当前任务语言要求优先。
  • 回退：移除语言约定，恢复由每次对话自行决定；不涉及代码或数据迁移。

验证

  • python dev_scripts/harness.py check --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/harness.py sync --check
  • 场景核对：中文输入、英文输入、中英混合、英文错误日志、用户明确要求英文输出。

文档影响

  • 更新 Development-Workflow 并同步核心镜像。
  • 更新共享 Agent 规则。
  • 不修改 CLAUDE.md，不创建任务快照。

验收标准

  • 用户可使用中文、英文或混合语言输入。
  • Agent 默认使用中文回复和维护内部过程文档。
  • 命令、代码标识符、路径、API 和错误原文不被翻译。
  • 合理英文术语可保留，必要时补充中文解释。
  • 用户明确指定输出语言时按该次要求执行。
  • Codex 与 Claude Code 共享同一规则。
  • 严格检查、单元测试和 Wiki 镜像检查通过。
  • 提交推送并回写证据，工单保持待验收。
## 基本信息 - 类型：单元任务 - 阶段：已完成 - 原始需求来源：当前对话，2026-09-02 - 关键需求摘要：用户可以使用中文或英文与 Agent 对话，Agent 默认使用中文回答，同时保留合理的英文术语和原文。 - 前置工单：无 - 是否允许并行：是；与待验收 #28、#30 无实施依赖，当前工作区干净。 - 设计证据：无 UI；采用已确认的语言规范。 ## 目标 - 接受中文、英文或合理混合语言的用户输入。 - Agent 默认以中文分析、回复、编写工单和内部项目文档。 - 代码标识符、命令、路径、API 名称、错误原文和通用英文术语保持原样。 - 必要时在英文术语首次出现时补充简短中文解释。 - 用户明确要求其他输出语言时，仅对该次任务按要求执行。 - Codex 与 Claude Code 使用相同规范。 ## 非目标 - 不翻译代码、命令、路径、日志或错误原文。 - 不强制把所有行业术语替换为中文。 - 不新增语言检测脚本、翻译服务或配置文件。 - 不修改用户输入内容。 - 不创建任务归档。 ## 已确认方案 1. 在共享 `AGENTS.md` 增加简短语言与术语规则。 2. 在 Development-Workflow Wiki 记录完整长期规则，回读后同步本地镜像。 3. `CLAUDE.md` 继续通过 `@AGENTS.md` 复用，不重复维护。 4. 默认中文是项目协作约定，不覆盖用户对当前交付物的明确语言要求。 5. 保留有助于准确搜索、执行和排错的英文原文。 ## 影响范围 - `AGENTS.md` - Gitea Wiki：Development-Workflow - `docs/01-workflow.md` - `dev_scripts/harness.py` 和相关测试 ## 风险与回退 - 风险：机械翻译英文术语降低搜索与排错效率；通过保留原文控制。 - 风险：默认中文被误解为禁止英文交付；明确当前任务语言要求优先。 - 回退：移除语言约定，恢复由每次对话自行决定；不涉及代码或数据迁移。 ## 验证 - `python dev_scripts/harness.py check --strict` - `python -m unittest discover -s tests -v` - `python dev_scripts/harness.py sync --check` - 场景核对：中文输入、英文输入、中英混合、英文错误日志、用户明确要求英文输出。 ## 文档影响 - 更新 Development-Workflow 并同步核心镜像。 - 更新共享 Agent 规则。 - 不修改 CLAUDE.md，不创建任务快照。 ## 验收标准 - [ ] 用户可使用中文、英文或混合语言输入。 - [ ] Agent 默认使用中文回复和维护内部过程文档。 - [ ] 命令、代码标识符、路径、API 和错误原文不被翻译。 - [ ] 合理英文术语可保留，必要时补充中文解释。 - [ ] 用户明确指定输出语言时按该次要求执行。 - [ ] Codex 与 Claude Code 共享同一规则。 - [ ] 严格检查、单元测试和 Wiki 镜像检查通过。 - [ ] 提交推送并回写证据，工单保持待验收。
ila commented 2026-09-02 15:11:04 +08:00
Author
Owner
Copy Link
Copy Source

最终实施证据

  • 状态：待验收
  • 实现提交：90938be380a90a9263f9bad6d78d6b48f2d74a9f，已推送到 origin/main。
  • 最终规则：
    • 用户可用中文、英文或合理的中英混合语言输入；
    • Agent 默认使用中文分析、回复、编写工单和维护内部项目文档；
    • 代码标识符、命令、参数、路径、API、协议、日志和错误原文保持原样；
    • 合理英文术语保留，必要时首次出现补充简短中文解释；
    • 用户明确指定某次输出或交付物语言时按该次要求执行。
  • Claude Code：CLAUDE.md 继续通过 @AGENTS.md 复用共享规范，没有重复修改。
  • 单元测试：python -m unittest discover -s tests -v，54 项全部通过。
  • 结构检查：python dev_scripts/harness.py check --strict，通过。
  • Wiki 镜像：python dev_scripts/harness.py sync --check，15 个核心页面一致。
  • Development-Workflow revision：3f420edaa937aaef3dbfe31b756ab6459ca5ce81。
  • 工作区干净，HEAD、origin/main 和远端 main 均为 90938be。
  • 场景覆盖：中文输入、英文输入、中英混合、英文错误原文、用户明确要求其他输出语言。
  • 未验证内容：没有增加自动语言识别或翻译服务，按文本规则由 Agent 执行。
  • 任务归档：未创建、未导出。

请按工单验收标准验收；工单保持开启，等待人工验收。

## 最终实施证据 - 状态：待验收 - 实现提交：`90938be380a90a9263f9bad6d78d6b48f2d74a9f`，已推送到 `origin/main`。 - 最终规则： - 用户可用中文、英文或合理的中英混合语言输入； - Agent 默认使用中文分析、回复、编写工单和维护内部项目文档； - 代码标识符、命令、参数、路径、API、协议、日志和错误原文保持原样； - 合理英文术语保留，必要时首次出现补充简短中文解释； - 用户明确指定某次输出或交付物语言时按该次要求执行。 - Claude Code：`CLAUDE.md` 继续通过 `@AGENTS.md` 复用共享规范，没有重复修改。 - 单元测试：`python -m unittest discover -s tests -v`，54 项全部通过。 - 结构检查：`python dev_scripts/harness.py check --strict`，通过。 - Wiki 镜像：`python dev_scripts/harness.py sync --check`，15 个核心页面一致。 - Development-Workflow revision：`3f420edaa937aaef3dbfe31b756ab6459ca5ce81`。 - 工作区干净，HEAD、origin/main 和远端 main 均为 `90938be`。 - 场景覆盖：中文输入、英文输入、中英混合、英文错误原文、用户明确要求其他输出语言。 - 未验证内容：没有增加自动语言识别或翻译服务，按文本规则由 Agent 执行。 - 任务归档：未创建、未导出。 请按工单验收标准验收；工单保持开启，等待人工验收。
ila commented 2026-09-04 14:51:14 +08:00
Author
Owner
Copy Link
Copy Source

验收结论

  • 验收时间：2026-09-04（Asia/Shanghai）
  • 结论：用户明确表示所有已完成实施并处于待验收的工单通过验收，本工单包含在该范围内。
  • 最终实施、提交、测试和文档影响证据已记录在上一条最终证据评论中。
  • 本次验收没有新的长期事实变化，因此不重复更新或同步 Wiki。
  • 父工单：无。
  • 任务快照：未创建、未导出。

验收闭环完成，关闭工单。

## 验收结论 - 验收时间：2026-09-04（Asia/Shanghai） - 结论：用户明确表示所有已完成实施并处于待验收的工单通过验收，本工单包含在该范围内。 - 最终实施、提交、测试和文档影响证据已记录在上一条最终证据评论中。 - 本次验收没有新的长期事实变化，因此不重复更新或同步 Wiki。 - 父工单：无。 - 任务快照：未创建、未导出。 验收闭环完成，关闭工单。
ila closed this issue 2026-09-04 14:51:15 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/dev_harness#31