jj-flow

用对话在多个相关项目里把「改功能、迁功能、一起派任务」做完，并且能核对、能接着做。

支持：Codex、Claude、Grok、Qoder，另提供 AGENTS 兼容入口（~/.agents）。

聊天里说"做完了"不算数。算数的是仓库里的记录、Git 提交和审查结果。

三步开始

安装对话入口（约一分钟）
看第一次使用，在业务仓库走完一个小需求
以后按下面的表选入口，用日常中文说要做什么

卡住了先看常见踩坑；拿不准入口时，直接说 $jj / /jj，由它帮你选择入口。

我该用哪个？

你想…	用这个	一句话说明
把当前仓接入全局地图、梳理项目、补知识库	init	先提案，确认后写入
只改当前这一个仓，从做到验收	ralph	五步任务闭环，完成后可继续改
把项目A 做好的能力搬到项目B / 项目C	same	按目标仓自己的写法适配
多个项目一起派、一起盯	dispatch	预览 → 你批准 → 派发
把审查结论写进任务	review	只读，不改业务代码
提交、推送、合进集成分支	end	只动 Git

快速判断： 一个仓用 ralph；要搬家用 same；多个仓统一批准用 dispatch；只收工用 end。

可选（不算验收通过）：team-coordinate 多角色、team-lifecycle 固定 SDLC、team-swarm 多方案搜索、evaluated 离线复盘。

对话入口

在业务项目的对话里使用前缀：Codex 用 $jj-…，其他工具通常用 /jj-…；平台差异见宿主说明。

它们怎么配合

text

一个仓库做完 ──ralph──► 可以说"交接到…"
                              │
                              ▼
                          same 迁到别的仓库
                              │
        多个仓库一起派 ──dispatch──► 批准后分别做
                              │
                          end 提交 / 合分支

文档导航

章节	适合谁	内容
开始（本组）	新用户	安装、第一次使用、常见踩坑
工作流	日常使用	六大入口 + 可选引擎，每个入口一页
概念	想懂「为什么」	术语、证据怎么算数、目录怎么放、宿主与 Mode S、知识与记忆
维护者	改本仓库的人	架构、CLI 参考、写作规范、部署
参考	深究者	设计文档（含 Agent Harness）、执行计划、ADR、历史验收：真实 Host、M7、H5

jj-flow ​

三步开始 ​

我该用哪个？ ​

对话入口 ​