gsd:workflow gsd:meta tw-generator tw-generator、生成代码、generate Read, Write, Edit, Bash, Glob, Grep PLAN.md 加载完成 逐任务执行完成 manifest.json 生成 必须从 plan/PLAN.md 读取任务,不自行发明任务 每个任务执行后记录结果到 manifest.json 遇到计划外问题记录到 deviations.md,不停止执行
gsd:goal按 PLAN.md 执行所有任务,产出 manifest.json 供 tw-benchmark 评估
<gsd:phase name="load-plan" order="1"> gsd:step读取 .harness/tasks/{slug}/plan/PLAN.md gsd:step解析任务列表和依赖关系 gsd:step更新 workflow.json: generator.status = "in_progress" gsd:checkpointPLAN.md 加载完成
<gsd:phase name="execute" order="2"> gsd:step按依赖顺序逐任务执行 gsd:step每个任务:Read 相关文件 → Edit/Write 代码 → 运行 verify 命令 gsd:step记录每个任务的执行结果(success/fail/skip) gsd:step计划外问题写入 execute/deviations.md gsd:checkpoint逐任务执行完成
<gsd:phase name="manifest" order="3"> gsd:step生成 execute/manifest.json(所有变更的清单) gsd:step更新 workflow.json: generator.status = "completed" gsd:checkpointmanifest.json 生成
tw-generator
执行流程
Phase 1: 加载计划
- 读取
plan/PLAN.md,解析出所有<task>节点 - 按
depends属性构建执行拓扑序 - 更新
workflow.json
Phase 2: 逐任务执行
对每个任务按拓扑序执行:
- Read:读取任务
<files>中列出的文件 - Execute:按
<action>描述执行 Edit/Write 操作 - Verify:运行
<verify>命令验证(如果有) - Record:将结果记录到内存中
偏差处理:
- 如果发现计划描述与实际代码不符,记录到
execute/deviations.md - 继续执行后续任务,不停止
- 偏差格式:
[T{id}] {描述}
Phase 3: 生成 manifest
manifest.json 模板:
{
"taskId": "{slug}",
"executedAt": "{ISO-8601}",
"tasks": [
{
"id": "T1",
"status": "success|fail|skip",
"files": ["path/to/file.ts"],
"verifyOutput": "测试通过摘要",
"duration": "2s"
}
],
"summary": {
"total": 5,
"success": 4,
"fail": 1,
"skip": 0
},
"hasDeviations": false
}
产出文件
| 文件 | 说明 | 消费者 |
|---|---|---|
execute/manifest.json |
变更清单 | tw-benchmark |
execute/deviations.md |
偏差记录 | tw-planner(重试时) |
workflow.json |
更新 generator 状态 | 编排器 |