---
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
  - 【允许修改的仓库相对路径】
---

## 问题 / 背景

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

## 关联需求与交互（如适用）

- 用户故事：【US-编号；无用户故事时说明原因】
- 交互清单：【IX-编号；无 UI 时写不适用】
- 相关页面 / 路由：【路径或不适用】

## 方案

（怎么改，落到“改哪个文件、改成什么”。复杂任务把确认后的规划结论写在这里，不只保留在对话中。）

## 不可变约束

- 阈值 / 数值边界：【具体值；无则写“无”】
- 判定式 / 状态转换：【必须保持的规则；无则写“无”】
- 安全边界：【不可绕过、不可自动执行的动作；无则写“无”】
- 既有契约：【字段、接口、兼容性要求；无则写“无”】

## 验收要点

- 任务相关验证：【每次必跑的命令与预期证据】
- 完整门禁：【触发条件、命令与预期证据；不触发时写明理由】
- 人工 / 设备验收：【是否必需、执行角色、步骤与证据；不适用时明确写“不适用”】
- 构建产物：【需要交接 / 部署时填写路径、生成命令和指纹；不适用时明确说明】

## 边界（不改什么）

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

## 协作约束

- 责任 Agent：【Agent 标识】
- 唯一写入者：【默认同责任 Agent；项目显式启用委派时填写执行者】
- 委派：【默认不启用；启用时写清只读探索者 / 执行者，并声明其继承本任务全部不可变约束、`write_paths` 和验证要求】
- Gitea：【启用时填写对应 Issue、领取时的 `context_ref`、claim / 工作分支】

任何新增写路径先检查与其他活跃任务是否重叠；同一时刻只有一个 Agent 修改本任务的 `write_paths`。

## 执行记录

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