DoorDash 如何用多智能体清理 6 万个 Feature Flag

#!/usr/bin/env bash
set -euo pipefail

: "${REPO:?Set REPO to the local Git repository}"
: "${FLAG_NAME:?Set FLAG_NAME}"
: "${REMOVE_VALUE:?Set REMOVE_VALUE, for example true or false}"
: "${APPROVED:?Set APPROVED=yes after engineer approval}"
: "${AGENT_CMD:?Set AGENT_CMD to your trusted agent command}"
: "${VALIDATE_CMD:?Set VALIDATE_CMD, for example 'pytest -q'}"

if [[ "$APPROVED" != "yes" ]]; then
  echo "Cleanup rejected: explicit engineer approval is required." >&2
  exit 1
fi

REPO="$(cd "$REPO" && pwd)"
SAFE_FLAG="$(printf '%s' "$FLAG_NAME" | tr -cs 'A-Za-z0-9._-' '-')"
WORKTREE_ROOT="$(dirname "$REPO")/.flag-worktrees"
WORKTREE="$WORKTREE_ROOT/$(basename "$REPO")-$SAFE_FLAG-$$"
BRANCH="cleanup/$SAFE_FLAG-$(date +%s)"
PROMPT_FILE="$(mktemp)"

trap 'rm -f "$PROMPT_FILE"' EXIT
mkdir -p "$WORKTREE_ROOT"

if ! git -C "$REPO" diff --quiet || ! git -C "$REPO" diff --cached --quiet; then
  echo "Base repository has uncommitted changes; refusing to continue." >&2
  exit 1
fi

git -C "$REPO" worktree add -b "$BRANCH" "$WORKTREE" "${BASE_REF:-HEAD}"

cat >"$PROMPT_FILE" <<EOF
You are cleaning up an approved stale feature flag.

Flag: $FLAG_NAME
Replacement value: $REMOVE_VALUE
Repository: $WORKTREE

Requirements:
- Find direct and indirect references to the flag.
- Preserve only the behavior selected by the replacement value.
- Remove unreachable branches, obsolete tests, and stale configuration.
- Do not change unrelated behavior or public APIs.
- Do not commit, push, or open a pull request.
- Summarize uncertain references instead of guessing.
EOF

export FLAG_NAME REMOVE_VALUE WORKTREE
export FLAG_PROMPT="$PROMPT_FILE"

(
  cd "$WORKTREE"
  bash -lc "$AGENT_CMD"
  bash -lc "$VALIDATE_CMD"
)

echo
echo "Validation passed. Review the resulting diff:"
git -C "$WORKTREE" status --short
git -C "$WORKTREE" diff --stat
echo
echo "Worktree: $WORKTREE"
echo "Branch:   $BRANCH"
echo "Remove after review with:"
echo "git -C '$REPO' worktree remove '$WORKTREE'"

export REPO="$HOME/src/checkout-service"
export FLAG_NAME="checkout_v2"
export REMOVE_VALUE="true"
export APPROVED="yes"
export AGENT_CMD='your-agent-cli run --prompt-file "$FLAG_PROMPT"'
export VALIDATE_CMD='python -m compileall -q . && pytest -q'

./cleanup-flag.sh