用途:该技能按阶段引导用户从零搭建 chunk sidecar。sidecar 是 CircleCI 上按需提供的远程 Linux 容器,镜像本地工作树,在干净隔离环境中运行构建、测试与校验命令,避免本地端口冲突、依赖漂移和“在我机器上能跑”的问题。完成后应具备:认证与凭据已验证、sidecar 运行且依赖已安装、可复用快照、chunk validate 通过。
主要能力与流程:Stage 1 检查前置条件,运行 chunk --version、chunk auth status、cat .chunk/config.json;CircleCI 凭据必需,GitHub 与 Anthropic 按需。OAuth 登录用 chunk auth login,回退为 chunk auth set circleci。Stage 2 确认 OrgID,缺失时用 chunk config set orgID <id>。Stage 3 可选命名。Stage 4 用 chunk sidecar create [--name <name>] 创建,再 chunk sidecar sync 同步本地工作树。Stage 5 安装依赖,可用 chunk sidecar setup --dir . 自动检测,或自定义命令,或跳过;如项目使用 Smarter Testing 可安装 circleci-testsuite。Stage 6 用 chunk validate --list 与 chunk validate --mark-remote 标记远程命令,autofix 命令默认跳过。Stage 7 运行 chunk validate。Stage 8 用 chunk sidecar snapshot create --name <snapshot-name> 创建快照,并 chunk config set validation.sidecarImage <snapshot-id>。Stage 9 用 chunk sidecar create --image <snapshot-id> 从快照启动并再次校验。
限制与注意:交互式组织选择在智能体会话中不可用,OrgID 必须预先配置;不要运行 echo $CIRCLE_TOKEN、env、printenv 等暴露凭据的命令;设置 validation.sidecarImage 后所有命令都会发往 sidecar,包括 autofix,格式化需直接本地运行;快照 ID 按组织隔离;同步或执行出现 publickey 错误可用 chunk sidecar add-ssh-key --public-key-file ~/.ssh/chunk_ai.pub。资料未提供收费、价格与平台支持范围等信息。