git-parsec 是一个 Git worktree 生命周期管理器，核心目标是将工单（ticket）到 PR 的流程简化为一条命令，并为每个 AI 智能体或开发者提供隔离的工作区。它解决了普通 git worktree 不跟踪状态、不与工单系统交互、不自动创建 PR、不清理工作区的问题。
用途
- 为并行 AI 智能体工作流提供隔离工作区，每个工作区拥有独立的 .git/index，避免多个智能体同时执行 git add 时发生 index.lock 冲突。
- 将工单系统（Jira、GitHub Issues、GitLab Issues、Bitbucket）与 Git 工作流打通，实现从工单到 PR 的自动化。
- 管理堆叠 PR（stacked PRs），自动按拓扑顺序提交并添加导航评论。
- 跨工作区冲突检测，在推送前标记被多个工作区修改的文件。
主要能力
- 每个阶段一条命令：start（创建工作区 + 获取工单）、ship（推送 + 创建 PR + 清理）、merge（合并 + 清理分支）、clean（清扫已合并分支）。
- 堆叠 PR：parsec start FOO --on BAR 可链式创建工作区；parsec stack --submit 按拓扑顺序打开整个堆叠，并自动发布“← 上一个 / 下一个 →”导航评论。
- 跨工作区冲突检测：parsec conflicts 在推送前标记两个工作区中修改的文件；parsec conflicts --simulate 进行内存中的三方合并，暴露行级冲突（只读）。
- 多代码托管平台：GitHub、GitLab、Bitbucket Cloud，支持完整的 PR 生命周期。
- 多工单系统：Jira、GitHub Issues、GitLab Issues、Bitbucket。
- CI 状态：GitHub Actions、GitLab CI、Bitbucket Pipelines，parsec ci 和 pr-status 在各平台行为一致。
- 面向智能体设计：每个命令都有 --json；错误输出结构化代码（E001…E013）；parsec log --export 输出 JSONL，包含执行 ID 和每步耗时；--offline 和配置项 [behavior].offline 可跳过所有网络操作，适用于隔离环境或 CI。
- MCP 服务器（v1.0 新增）：通过 stdio 将 parsec 的工作区生命周期暴露给 Claude Desktop 或 Cursor。提供 worktree、health、smartlog、PR、review、CI 和 sync 工具。变更类调用会预览并需确认；委托令牌会进行范围检查，仓库路径会被沙箱化。
- 生命周期卫生：parsec clean 清扫已合并分支的工作区；parsec undo 撤销上一次操作（start、ship、clean）；parsec doctor 验证设置并提供可操作的修复说明。
- 工作区构建缓存共享：[worktree].shared_cache = ["target", "node_modules", ".venv"] 允许新工作区通过符号链接（默认）或复制复用主仓库的缓存，消除冷构建成本。
- 冲刺看板与工单创建：parsec board 在终端中将活跃冲刺转为看板；parsec create 和 parsec new-issue 无需离开 shell 即可在工单系统中创建工单。
- 可视化与高级工具（v0.5 新增）：parsec smartlog（别名 sl）显示每个活跃工作区的 ASCII 提交 DAG，并叠加 PR / CI 信息；parsec dashboard（别名 dash）实时 TUI 面板显示工作区、CI 和 PR；parsec health 检查锁 / 未提交 / 过期 / CI；parsec reviews 统一显示收到的和请求的 PR 审查；parsec test 跨工作区并行运行测试，带树哈希结果缓存（--all --jobs N --cache）；parsec sync 将过期工作区快进到 origin/<base>（rebase 或 merge，--all，--dry-run）。
- 总计 33+ 命令，完整命令参考包含每个标志和示例。
使用方式
- 安装后运行 parsec config init 进行交互式首次设置，然后运行 parsec doctor 验证。
- 支持动态 shell 补全脚本，输入时建议活跃工作区和分支（例如 parsec switch <Tab> 列出活跃工单）。也可通过 parsec config completions <shell> 使用纯静态回退。
- 认证令牌通过环境变量设置，均为可选。
- 完整配置模式和选项可通过 parsec config schema 查看（也发布在 schemastore.org）。
- 每个命令以结构化代码退出，JSON 输出（--json）包含相同代码。
适用场景
- 多个 AI 智能体或开发者并行操作同一仓库，需要避免 index.lock 冲突。
- 需要将工单系统与 Git 工作流自动化连接，减少 Web UI 往返。
- 管理堆叠 PR，需要自动导航评论和拓扑顺序提交。
- 在推送前检测跨工作区文件冲突。
- 在隔离环境或 CI 中离线运行。
- 通过 MCP 将工作区生命周期集成到 Claude Desktop 或 Cursor。
限制
- 资料中未提供具体的安装命令、系统要求、价格或收费信息。
- 其他目标平台（macOS arm64/x86_64、Windows x86_64）随每次发布提供，详见 Releases。
- v1.0 是计划中的最终功能版本。
- 许可证为 MIT，详见 LICENSE。
