# 复制为 docs/ack/tasks.yaml，替换占位符。结构见 templates/tasks.schema.json。
version: 1
updatedAt: "<YYYY-MM-DDTHH:mm:ss+TZ>"
source: "Coordinator (PM) Agent"
ackVersion: "<接入时的 ack skill 版本>"
project:
  name: "<project_name>"
  baseUrl: "<base_url>"
  overlayFile: "docs/ack/project.md"
  knowledgeFile: "docs/ack/knowledge.yaml"
  deliveryFile: "docs/ack/delivery.yaml"
  regressionFile: "docs/ack/regression.yaml"
  # 可选：飞书 Base Bug 收件箱。只保存 profile 名和资源 ID，绝不保存 App Secret。
  # bugIntake:
  #   provider: "feishu-base"
  #   workflow: "clarified-writeback-v1"
  #   profile: "project-feishu"
  #   baseToken: "<base_token>"
  #   tableId: "<table_id>"
  #   viewId: "<ack_ready_view_id>"
  #   fields:
  #     title: "<field_id>"
  #     details: "<field_id>"
  #     problemStatement: "<field_id>"
  #     expectedOutcome: "<field_id>"
  #     acceptance: "<field_id>"
  #     intakeStatus: "<field_id>"
  #     ackTaskId: "<field_id>"
  #     attachments: "<field_id>"
  #     updatedAt: "<field_id>"
  orchestration:
    # worker 默认在 --project-root（权威状态目录）工作；不再配置 allowedWorktrees 白名单
    # （v0.19 起废弃）。需要隔离 worktree 时由 Coordinator 在派发时显式指定。
    profileVersion: 1
    mode: "orca"
    modelAllowlist:
      codex:
        developer:
          standard: ["gpt-5.6-terra"]
          strong: ["gpt-5.6-sol"]
        test:
          standard: ["gpt-5.6-luna"]
      cursor-agent:
        developer:
          standard: ["auto"]
        test:
          standard: ["auto"]
      grok:
        developer:
          standard: ["grok-4.5"]
          strong: ["grok-4.6"]
        test:
          standard: ["grok-4.5"]
    profiles:
      codex-dev-standard:
        role: "developer"
        cli: "codex"
        tier: "standard"
        model: "gpt-5.6-terra"
        reasoningEffort: "medium"
        permissionMode: "workspace-write"
      codex-test-standard:
        role: "test"
        cli: "codex"
        tier: "standard"
        model: "gpt-5.6-luna"
        reasoningEffort: "low"
        permissionMode: "workspace-write"
      codex-dev-strong:
        role: "developer"
        cli: "codex"
        tier: "strong"
        model: "gpt-5.6-sol"
        reasoningEffort: "high"
        permissionMode: "workspace-write"
      cursor-dev-standard:
        role: "developer"
        cli: "cursor-agent"
        tier: "standard"
        model: "auto"
        reasoningEffort: null
        permissionMode: "workspace-write"
      cursor-test-standard:
        role: "test"
        cli: "cursor-agent"
        tier: "standard"
        model: "auto"
        reasoningEffort: null
        permissionMode: "workspace-write"
      grok-dev-standard:
        role: "developer"
        cli: "grok"
        tier: "standard"
        model: "grok-4.5"
        reasoningEffort: "medium"
        permissionMode: "workspace-write"
      grok-test-standard:
        role: "test"
        cli: "grok"
        tier: "standard"
        model: "grok-4.5"
        reasoningEffort: "low"
        permissionMode: "workspace-write"
      grok-dev-strong:
        role: "developer"
        cli: "grok"
        tier: "strong"
        model: "grok-4.6"
        reasoningEffort: "high"
        permissionMode: "workspace-write"
    defaults:
      developer: "codex-dev-standard"
      test: "codex-test-standard"
      developerUpgraded: "codex-dev-strong"

workerReceipts: []
deliveryRuns: []
regressionRuns: []

summary:
  verified: []
  open: []
  failedRetest: []
  leftovers: []

tasks:
  - id: "BUG-001"
    type: "bug"
    title: "<short title>"
    priority: "P0"
    status: "open"
    assignee: "developer"
    component: "<source file or module>"
    specRefs:
      - "<docs/spec.md#section>"
    testRefs:
      - "<tests/browser/cases/01-case.md>"
    knowledgeRefs: []
    knowledgeApplied: []
    knowledgeCandidates: []
    knowledgeChecks: []
    regressionRefs: []
    regressionCandidates: []

    # 从飞书导入时由 Coordinator 写入；source.ref 是幂等键。
    # source:
    #   kind: "feishu-base"
    #   workflow: "reviewed-writeback-v1"
    #   ref: "feishu-base:sha256:<64-lowercase-hex>"
    #   recordId: "<record-id>"
    #   updatedAt: "<source-updated-at>"
    #   approvedRevision: "sha256:<approved-draft-digest>"
    #   approvedPayloadHash: "sha256:<canonical-task-payload-digest>"

    description: >
      <What is wrong, in user-visible terms.>

    # 飞书审核通过后写入批准版本；审核前不创建这条 ACK 任务。
    fixLogic: >
      <Approved repair logic, affected behavior, invariants, and regression risks.>

    acceptanceCriteria:
      - "<observable acceptance signal 1>"
      - "<observable acceptance signal 2>"

    stepsToReproduce:
      - "<step 1>"
      - "<step 2>"

    expected: >
      <Expected behavior.>

    actual: >
      <Actual behavior observed by Test.>

    evidence:
      browser: "<snapshot text, screenshot path, or UI finding>"
      api: "<curl result or API mismatch>"
      logs: "<relevant log line if any>"

    verification:
      commands:
        - "<unit/build command>"
        - "<browser/API smoke command>"
      browser:
        page: "<page path>"
        checks:
          - "<visible text or interaction expected>"

    dispatch:
      developer:
        profileId: "codex-dev-standard"
        receiptId: null
        attemptId: null
        taskId: null
        dispatchId: null
      test:
        profileId: "codex-test-standard"
        receiptId: null
        attemptId: null
        taskId: null
        dispatchId: null
      rounds: []
      # 环境失败不占产品复验轮次；按 BUG-001-ENV-1... 连续编号，并写清 userAction。
      environmentIncidents: []

    resolution:
      fixedBy: null
      verifiedBy: null
      verifiedAt: null
      leftoverReason: null