---
id: T-XXX
title: 一句话任务名
phase: 1
deps: []
status: TODO
created: 【日期】
issue: null
context_ref: null
claim_branch: null
work_branch: null
write_paths:
  - docs/tasks/T-XXX.md
  - 【允许修改的仓库相对路径】
---

## 问题 / 背景

（现象、根因、为什么要做）

## 方案

（怎么改，落到"改哪个文件、改成什么"）

## 验收要点

（可验证的完成标准；按「passing 需证据」写清跑哪个验证命令，不写"应该能用"）

## 边界（不改什么）

（明确不碰的模块/流程）

## 协作约束

- review_mode: 【none | test | dual】
- writer: 【唯一写入 agent-id；未领取时为 null】
- test_reviewer: 【只读测试评审 agent-id；不适用时为 null】
- risk_reviewer: 【只读安全/架构评审 agent-id；不适用时为 null】

（启用 Gitea 时填写对应 Issue、领取时的 `context_ref`、claim / 工作分支。只有 writer 可以修改和提交仓库；评审角色只读。任何新增写路径先检查与其他活跃任务是否重叠。候选 SHA 由 PR / 评审报告记录，避免任务文件自引用；分支产生任何新提交后重新评审。）

## 执行记录

（做完在此记录：改了哪些文件、跑的验证命令与结果、阻塞、关键决策。
执行记录只写进本任务文件，不逐任务追加共享的 `progress.md`，避免多 agent 抢改共享文件。）