62 lines
2.2 KiB
Markdown
62 lines
2.2 KiB
Markdown
|
---
|
||
|
|
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 抢改共享文件。）
|