feat(ship): add stage audit trail and sortable ids
This commit is contained in:
@@ -17,6 +17,15 @@
|
||||
spec.md # 短需求说明(short 和 long 都有)
|
||||
tasks.yaml # 本 ship 的任务 DAG
|
||||
status.md # 给人看的一页摘要
|
||||
1-spec/ # 规格、评审、根因和 handoff
|
||||
2-develop/ # 开发任务和变更
|
||||
3-test/ # 任务验证与集成回归
|
||||
4-review/ # PR、审核与合并
|
||||
5-build/ # 合并后的构建/obtain
|
||||
6-publish/ # 发布产物
|
||||
7-deploy/ # 部署与健康检查
|
||||
stage.yaml # 阶段状态和包含的步骤
|
||||
activity.md # 该阶段的调度、结果和证据摘要
|
||||
spec/ # 仅 long:PRD 版本、评审、handoff
|
||||
brief.md
|
||||
prd-v001.html
|
||||
@@ -27,6 +36,11 @@
|
||||
```
|
||||
|
||||
`status.md` 给人看;Agent 以 `current.yaml` 为准。两份不一致时改 `status.md`。
|
||||
阶段目录由 `create_ship.py` 初始化,由 `next_step.py` 在派发和收到结果时追加活动记录;
|
||||
大日志留在原测试、构建或部署位置,阶段目录只保存摘要和路径。
|
||||
|
||||
新建 ship 使用可排序的 `YYYYMMDD-短语`,例如 `20261014-dynamic-editor`。旧的无日期
|
||||
记录仍可读取和校验,不要为了改名移动既有 ship 目录。
|
||||
|
||||
## current.yaml
|
||||
|
||||
@@ -57,6 +71,10 @@ tasks:
|
||||
delivery:
|
||||
stopAt: review_ready
|
||||
state: change_ready
|
||||
manager:
|
||||
lastStep: null
|
||||
lastResult: null
|
||||
inFlight: null
|
||||
evidence:
|
||||
testRuns: []
|
||||
artifacts: []
|
||||
@@ -75,6 +93,10 @@ evidence:
|
||||
`source.kind`:`user` | `hunt` | `ack` | `pr` | `feishu`。修 ACK 缺陷时
|
||||
`source.kind: ack` 且 `ref` 为缺陷任务 id。
|
||||
|
||||
`manager` 由入口主会话维护,可选。`lastStep` / `lastResult` / `lastSummary` 记录刚结束的那一步;
|
||||
`inFlight` 在 worker 未返回时写成步骤名,返回后清掉。worker 不要写这些字段。
|
||||
`lastResult`:`pass` | `fail` | `blocked` | `ask`。
|
||||
|
||||
## short 与 long
|
||||
|
||||
同一套字段,厚度不同。
|
||||
|
||||
Reference in New Issue
Block a user