附录 C：task.json Schema 参考

{
  "id": "string", // 任务 ID（= slug，如 02-27-user-login）
  "name": "string", // Slug 名（单仓库下和 id 相同；monorepo 可能不同）
  "title": "string", // 任务标题
  "description": "string", // 描述（不传 --description 时为 ""）
  "status": "string", // planning（默认）| in_progress | completed；task.py list --status 还接受 review
  "dev_type": "string", // backend | frontend | fullstack | test | docs（默认 null，由手工编辑或自定义 hook 填入）
  "scope": "string", // Commit scope，如 "auth"（set-scope 前为 null）
  "package": "string", // Monorepo 包名（单仓库为 null）
  "priority": "string", // P0 | P1 | P2 | P3（默认 P2）
  "creator": "string", // 创建者 id
  "assignee": "string", // 指派人 id
  "createdAt": "string", // YYYY-MM-DD 创建日期
  "completedAt": "string", // YYYY-MM-DD 完成日期（未完成为 null）
  "branch": "string", // Feature 分支名（set-branch 前为 null）
  "base_branch": "string", // PR 目标分支（创建时按当前分支记录）
  "worktree_path": "string", // Schema 占位——创建时写 null，没有脚本会填
  "commit": "string", // Schema 占位——创建时写 null，没有脚本会填
  "pr_url": "string", // Schema 占位——创建时写 null，没有脚本会填
  "subtasks": [], // 任务内部的 todo checklist（{name, status} 对），与 children 无关
  "children": [], // 子任务目录名数组（父→子链接）
  "parent": "string", // 父任务目录名（顶层任务为 null）
  "relatedFiles": [], // 相关文件列表
  "notes": "string", // 备注（默认 ""）
  "meta": {} // 项目级元数据（如 Linear issue id）
}