git

Git

清晰、可重复且以安全为先的 Git 工作流。

路由器

选择与用户意图匹配的最小工作流。

用户说	加载参考	执行
status / what changed（无 “worktree” 前缀）	references/read-only.md	只读检查
help / usage / man	references/cli-help.md	安全地显示 CLI 帮助
commit / stage	references/commit-workflow.md	安全地暂存并提交
branch / switch	references/branch-workflow.md	分支操作
worktree create/remove/list	references/worktree-workflow.md	worktree 操作
worktree cleanup / normalize / consolidate	references/worktree-maintenance.md	自动清理并整合 worktree
worktree summary / worktree status / show worktrees	references/worktree-summary.md	主动分析：PR 状态、变更分类、是否可安全删除的判定
tag / version	references/tag-workflow.md	创建 / 列出 / 检查标签
pr / pull request	references/pr-workflow.md	通过 gh 创建 / 更新 PR
pr review / fix pr comments / threads	references/pr-review-workflow.md	审查、回复并修复
merge / rebase / reset / revert	references/advanced-workflows.md	高级操作 / 恢复（先确认）

配置（在此编辑）

Worktree 工作目录（你要 cd 进入的文件夹）位于 .git/ 之外。

设置一次，之后到处使用：

WORKTREES_DIR=./.worktrees
WORKTREE_PATH=$WORKTREES_DIR/<topic>

如果你想使用其他位置（例如 ../.worktrees 或 ~/worktrees/<repo>），请更新上方的 WORKTREES_DIR，并在 references/worktree-workflow.md 中遵循相同的目录结构。

弹性规则（Worktree）

• 如果检测到多个 worktree 根目录（例如，同时存在 ./.worktrees/ 和 ../repo-feature-x/），默认情况下不要删除任何内容。
• 优先使用 git worktree move（可行时）或先移除再重新添加的方案，将其整合到 WORKTREES_DIR。
• 如果存在过时的元数据，请提出清理方案：git worktree prune + 移除 / 隔离孤立目录（需确认）。

全局安全规则（绝不违反）

• 绝不强制推送到 main/master。
• 绝不提交机密信息（环境文件、密钥、凭据）。
• 除非用户明确要求，否则绝不改写已推送的历史。
• 执行不可逆操作前，始终展示将要发生的变更。

确认策略

只读命令始终可以执行。

任何会更改状态 / 历史 / 远程端的操作都需要用户明确确认：

• git add、git commit、git push
• git merge、git rebase、git reset、git revert
• git worktree add、git worktree remove
• git tag（创建 / 删除）
• git branch -d/-D

快速开始

# Read-only
git status
git diff

# Commit
git diff --cached
git commit -m "feat(scope): why"

# Worktrees
git worktree list