docs: add batch SDK migration workshop

[anchenqlw]

Cookbook contribution

Summary

• Content type: Workshop
• Locale: zh-CN
• Demo source included: yes
• Target audience: QCA customers and workshop participants who need to migrate heterogeneous codebases with Batch Agent while retaining deterministic acceptance checks and human-review boundaries.
• User problem and expected outcome: Teach readers to prepare a Forward Environment, submit isolated SDK-migration tasks as JSONL, track task-level results and Credits, retry only failed rows, and verify patches and reports before adoption.

Sources and assets

• Public sources used:
  • https://docs.qoder.com/cloud-agents/api/forward/environments/create
  • https://docs.qoder.com/cloud-agents/api/forward/templates/create
  • https://docs.qoder.com/cloud-agents/api/forward/identities/create
  • https://docs.qoder.com/cloud-agents/api/forward/batches/create
  • https://docs.qoder.com/cloud-agents/api/forward/batches/list-tasks
  • https://docs.qoder.com/cloud-agents/api/forward/batches/get-output
• Asset owner and license: No content images or third-party assets are included. The Demo uses only original source, synthetic fixtures, and the Python standard library.
• All submitted text and assets are original.

Specialist review

• Requested: QCA product/API review and manual review of the Demo client, permissions, cleanup, billable operations, and live-validation claims.

Validation performed

• npm run check: passed (65 Node tests; content, Demo, link, catalog, build, and preview checks all passed).
• Demo tests: 8/8 passed using the local mock server.
• Baseline fixture check: all four projects reported the expected pre-migration state.
• Generated preview reviewed locally: Workshop structure, tables, code blocks, task list, table of contents, and Demo link rendered correctly with no horizontal overflow or browser warnings.
• Real QCA API validation was performed on 2026-08-20 under a temporary immediate-execution allowance. The initial run exposed a working-directory prompt defect and transient model failures; the prompt was corrected. A recovery Batch then completed all three automatic migrations (3/3), and a targeted retry completed the intentionally invalid Billing row (1/1) while producing only the required manual-review artifact. Every downloaded patch was applied to a clean copy and rerun against its deterministic acceptance command.
• Total live-validation usage was 144.27 Credits, including failed attempts. Temporary Template and Environment resources were archived, the Identity was deleted, and the temporary PAT file was removed after verification.

Author checklist

• I used exactly one author and no more than five approved tags.
• The article has at least three ## sections and no hand-written table of contents.
• I did not use GitHub Alerts, video, raw HTML, JavaScript, MDX, iframe, remote images, SVG, or interactive content.
• Images are local PNG, JPEG, or WebP files with meaningful alternative text and documented rights. (No images included.)
• The contribution contains no credentials, customer data, personal information, internal links, or unreleased capabilities.
• If a Demo is included, demos/<slug>/ matches the owner article, and the article contains the exact GitHub Demo link.
• If a Demo is included, its README documents prerequisites, setup, run, verification, cleanup, and cost/safety considerations.
• Demo configuration uses placeholders; no dependency cache, build output, binary, archive, nested Git metadata, or symbolic link is included.
• I disclosed the origin and license of Demo source, dependencies, fixtures, and third-party assets.
• I reviewed the generated preview locally or from the required GitHub Actions checks.
• Every commit contains a Signed-off-by trailer.
• I understand that maintainer Merge to main is the publication event.

Maintainer Demo review

• Not applicable, or a Maintainer reviewed the Demo README and source manually.
• Not applicable, or the claimed result, cleanup, billable operations, permissions, and destructive side effects were reviewed.