docs: add harness coding documentation
This commit is contained in:
@@ -0,0 +1,18 @@
|
||||
# 一任务一文件规则
|
||||
|
||||
默认情况下,本项目使用 [`../06-tasks.md`](../06-tasks.md) 作为单文件任务看板。
|
||||
|
||||
当多人或多个 agent 并发工作时,为避免抢改同一个看板,改用本目录的一任务一文件方式:
|
||||
|
||||
1. 新任务复制 [`_template.md`](_template.md)。
|
||||
2. 文件命名为 `T-<编号>-<短名称>.md`。
|
||||
3. 状态写在文件 frontmatter。
|
||||
4. 执行记录写入该任务文件的 `## 执行记录`。
|
||||
5. 不再逐任务追加根目录 `progress.md`,只在里程碑或交接时同步摘要。
|
||||
|
||||
## 状态
|
||||
|
||||
- `TODO`:待开始。
|
||||
- `DOING`:进行中。
|
||||
- `DONE`:完成并通过验收。
|
||||
- `BLOCKED`:受阻,需要明确原因。
|
||||
@@ -0,0 +1,27 @@
|
||||
---
|
||||
id: T-000
|
||||
title: 任务标题
|
||||
status: TODO
|
||||
depends_on: []
|
||||
owner: ""
|
||||
---
|
||||
|
||||
# 任务标题
|
||||
|
||||
## 背景
|
||||
|
||||
说明为什么要做这个任务。
|
||||
|
||||
## 范围
|
||||
|
||||
- 做什么。
|
||||
- 不做什么。
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [ ] 可观察、可执行的验收点。
|
||||
- [ ] 相关测试或构建命令通过。
|
||||
|
||||
## 执行记录
|
||||
|
||||
尚未开始。
|
||||
Reference in New Issue
Block a user