yovision/docs/tasks/_template.md

id, title, phase, deps, status, created, issue, context_ref, claim_branch, work_branch, write_paths

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

问题 / 背景

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

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

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

方案

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

不可变约束

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

验收要点

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

边界（不改什么）

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

协作约束

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

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

执行记录

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