docs: establish ShopHelm harness coding baseline
This commit is contained in:
@@ -0,0 +1,50 @@
|
||||
# 多 agent 一任务一文件
|
||||
|
||||
> 当前默认使用 [`../06-tasks.md`](../06-tasks.md) 单文件看板。只有多个 agent 或人/agent 并发开发时才切换本模式。
|
||||
|
||||
## 切换规则
|
||||
|
||||
1. 把 `docs/06-tasks.md` 冻结为已存在任务的索引,不再并发修改任务行。
|
||||
2. 新任务在本目录使用 `T-<编号>.md`。
|
||||
3. 每个 agent 只编辑自己领取的任务文件和该任务必要的代码。
|
||||
4. 执行记录写入任务文件,不逐任务抢改共享 `progress.md` 和 `current-state.md`。
|
||||
5. 阶段性汇总由单一协调者更新共享文件。
|
||||
|
||||
## 文件名和编号
|
||||
|
||||
- 文件名:`T-101.md`,细分任务可用 `T-101a.md`。
|
||||
- 新编号取 `06-tasks.md` 与本目录现有任务最大编号加一。
|
||||
- 目标文件存在时换下一个编号,不覆盖。
|
||||
- `_template.md` 不参与编号。
|
||||
|
||||
## Frontmatter
|
||||
|
||||
```yaml
|
||||
---
|
||||
id: T-XXX
|
||||
title: 一句话任务名
|
||||
phase: 1
|
||||
deps: []
|
||||
status: TODO
|
||||
created: YYYY-MM-DD
|
||||
owner:
|
||||
---
|
||||
```
|
||||
|
||||
状态只允许 `TODO`、`DOING`、`DONE`、`BLOCKED`。
|
||||
|
||||
## 领取
|
||||
|
||||
- 选择编号最小且依赖全 `DONE` 的 `TODO`。
|
||||
- 设置 `owner` 和 `DOING` 后再开始。
|
||||
- 同一 agent 一次只领取一个。
|
||||
- 发现已有 owner 或状态刚变化时不得覆盖,重新选择任务。
|
||||
|
||||
## 完成
|
||||
|
||||
- 在任务文件记录变更、真实命令、结果、手工 smoke、决策和残余风险。
|
||||
- 全部验收通过后改为 `DONE`。
|
||||
- 验证失败时保持 `DOING`;确有外部决策阻塞时标 `BLOCKED` 并写清恢复条件。
|
||||
- 不以“代码已写”代替证据。
|
||||
|
||||
流程和安全规则的唯一权威源仍是 [`../../AGENTS.md`](../../AGENTS.md)。用户使用 `grill me:` 时只做反方评审,不自动建立或实现任务。
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
id: T-XXX
|
||||
title: 一句话任务名
|
||||
phase: 1
|
||||
deps: []
|
||||
status: TODO
|
||||
created: YYYY-MM-DD
|
||||
owner:
|
||||
---
|
||||
|
||||
## 需求与背景
|
||||
|
||||
对应需求 ID、现象和为什么要做。
|
||||
|
||||
## 方案
|
||||
|
||||
明确修改的模块、数据/服务/页面变化和副作用边界。
|
||||
|
||||
## 验收要点
|
||||
|
||||
- 可执行的自动验证命令。
|
||||
- 可观察的手工 smoke。
|
||||
- 失败路径和安全边界。
|
||||
|
||||
## 边界
|
||||
|
||||
明确本任务不修改和不实现的内容。
|
||||
|
||||
## 执行记录
|
||||
|
||||
- 状态:
|
||||
- 变更:
|
||||
- 验证:
|
||||
- 阻塞:
|
||||
- 决策:
|
||||
- 残余风险:
|
||||
Reference in New Issue
Block a user