发布

  • chore(repo): fold beta.5-run learnings into nx-multi-repo-migrate skill (#36206)

    frostbyte_neo 发布于 2026-07-02 17:07:46 +00:00

    What

    Updates the nx-multi-repo-migrate skill
    (.claude/skills/nx-multi-repo-migrate/SKILL.md) with lessons from a
    live 5-repo migration to nx 23.1.0-beta.5. Documentation/tooling only
    — no runtime code changes.

    Why

    Two repos (nx-console, nx-examples) came out of the automated run with
    red CI because migrations were silently left unapplied. The skill's
    per-child instruction treated nx's deferred AI migrations as "skip
    inside an agent — leave for a human," when nx actually defers them to
    the driving agent
    (it prints "Next steps for the AI agent driving
    this run: apply the deferred prompts"
    ). The child never applied them,
    and the deterministic remove-removed-typescript-eslint-extension-rules
    codemod got skipped too — leaving a typescript-eslint v8-removed rule
    (@typescript-eslint/no-extra-semi) in the flat configs, which crashes
    ESLint's config loader and fails the whole project graph.

    Changes

    • Apply the AI migrations in the child — it is the agent nx hands
      them to; read each tools/ai-migrations/*.md and make the changes,
      honoring the migration's "passing baseline."
    • Run the full migration set without --create-commits — nx shells
      its scoped --commit-prefix="chore(repo): [nx migration] " through
      /bin/sh unescaped and the ( crashes it; commit each migration by
      hand instead.
    • Verify nx run-many -t lint resolves the project graph before
      declaring a repo done (the removed-rule crash only surfaces at
      graph-processing time).
    • Self-format under Prettier 2.x — nx's formatFiles silently
      no-ops on CommonJS Prettier 2.x (ESM-interop bug).
    • New gotchas: release-age-gate silent downgrade to latest, the
      --from=nx@<version> resume path for already-at-target repos,
      worktree ENOSPC avoidance, and push / create_pr auth quirks.
    • Updated the verification checklist to match.

    Related

    Came out of the coordinated nx 23.1.0-beta.5 migration (nx#36178 and the
    sibling repo PRs).


    View session information


    Co-authored-by: nx-cloud[bot] <71083854+nx-cloud[bot]@users.noreply.github.com>
    Co-authored-by: FrozenPandaz FrozenPandaz@users.noreply.github.com

    下载附件