命令总览
日常只在业务项目的对话里说这些入口，不需要先学命令行。
第一次用先看哪里
新用户请依次阅读安装与第一次使用，走完一个 ralph 示例。已知目标时，直接打开对应命令页。
主路径（交付）
| 入口 | 解决什么问题 | 可用平台 |
|---|---|---|
| init | 把项目接入全局地图、梳理项目、补知识库 | 全平台 |
| ralph | 在当前仓库从分析做到验收、归档 | 全平台 |
| same | 把一个同源仓做好的能力迁到别的仓 | 全平台 |
| dispatch | 多个项目先预览、批准，再一起派发 | 全平台 |
| review | 只读审查；有活跃任务时结论写进任务，无任务时只回结论 | 全平台 |
| end | 提交、推送并按规则合进集成分支 | 全平台 |
| jj | 说不清时帮你选上面哪个入口 | 全平台 |
可选协作（不推进验收）
这些入口只帮你安排这一轮怎么分析、写规格或搜索方案，单独跑完不等于交付通过。验收仍看 ralph / dispatch 的记录和证据。
| 入口 | 适用场景 |
|---|---|
| team-coordinate | 按当前问题动态拆多角色 |
| team-lifecycle | 固定角色走规格→计划→实现→测审流水线 |
| team-swarm | 多假设、对抗评分、方案收敛 |
| evaluated | 用真实交付记录做离线复盘（实验性） |
常用说法
日常口语即可：
text
$jj-init 当前仓加入全局地图
$jj-ralph 票面预览的关闭按钮点了没反应
$jj-same 交接到 项目B 项目C
$jj-dispatch 先预览，再把这个改动派到项目A和项目C
$jj-review 审一下刚才的改动
$jj-end 收工，合到 dev需要更清楚时，再补四件事：目标、资料、范围、验收标准。
text
$jj-ralph
目标：登录成功后密码过期要提示
资料：登录模块和现有测试
范围：只改登录成功路径
验收：出现提示且可跳转改密不同工具的前缀
| 工具 | 前缀 | 例子 |
|---|---|---|
| Codex | $ | $jj-ralph |
| Claude | / | /jj-dispatch |
| Grok / Qoder | / | /jj-dispatch |
前缀和可用范围以宿主说明为准；维护用的命令行在侧栏“维护者 → CLI 参考”，不建议拿来代替日常对话入口。