用途:把本地命令模板转成可复用的 Git 交付流程,供不同智能体/编辑器一致执行。适用请求包括提交工作流(conventional-changelog 风格)、安全分支下推送并开 PR、由 git 历史与 GitHub 上下文生成发布说明、从 main 发布版本(含小版本时双语 README 的 Recent updates)、分析最近失败的 GitHub Actions 并在隔离 worktree 中尝试修复后提 PR、在当前工作区混有他人改动时把本人改动移到干净分支、检查文档组件与源文件的 IDE 图标配置一致性。
用法与约束:详细步骤与限制位于 references/source-commands.md,须按模板作为工作流步骤执行;默认保持安全,除非明确要求避免破坏性 git 操作、避免提交密钥、改动尽量小而局部;涉及 push/PR/release 等外部副作用前需再次确认。命令映射见 references/command-catalog.md。
仓库特有注意点:在 main 构建前先同步依赖,node_modules 过期会表现为正确代码的类型错误(如 @cloudbase/manager-node 5.8.6 与锁定 5.8.8 导致 CreateEnvParams 无 ExternalStorage);沙箱内 pnpm install 报 ERR_PNPM_CODEBUDDY_BROKER_DENY(符号链接 ENOENT)并删除原包目录,需禁用沙箱重跑;npm run build 末步被安全删除钩子拦截时以 webpack 是否打印 ERROR 判断;发布说明范围为 git log <previous-tag>..HEAD(含合并提交);CHANGELOG.md 的 Unreleased 不随发布轮换;版本号涉及 mcp/package.json、config/source/** 技能版本、config/.claude/skills 镜像与可选 README 条目。
已推送 PR 的内部引用清理:PR 标题、正文、各提交标题与消息同 diff 一样公开。修改消息后 git commit --amend -F -,用 git diff --stat <old-sha> HEAD 验证为空,再以 --force-with-lease 强推,并用 gh pr edit <n> --body-file - 重写正文。
被 squash 合并的堆叠 PR:先 git merge-tree --write-tree 预检冲突集,再 git rebase --onto origin/main <A's-original-commit> 丢弃已合并提交;按文件类型解决冲突;用 --fixup 与 autosquash 折叠基线重算;gh pr edit <n> --base main 改基并重写描述;在重基后内容上验证,路径过滤工作流可能未触发,需用 API 检查并 close/reopen PR。
从共享脏工作区隔离本人改动:先按归属拆分(git status --porcelain、git diff --stat),用 git diff > /tmp/<name>.patch 快照,基于 origin/main 用 git worktree add -b 创建分支,链接 node_modules,git apply 后检查暂存,仅用 git restore <your paths> 清理原工作区,并在新 worktree 跑仓库门禁。