Skip to content

核心术语对照表 ​

本页将 jj-flow 文档、日志与状态文件中可能出现的术语,按**“工作流入口 → 任务与跨仓调度 → 工作模式与角色 → 目录与记忆”**四个维度整理成通俗解释,方便随时查阅。

一、核心工作流术语 ​

术语 / 命令名日常怎么理解详细说明与关联入口
项目族(Project Family)同一个产品拆出来的多个关联仓库例如 PC 前台(项目A)、H5 端(项目B)、管理后台(项目C)。它们共享同一套业务概念,但各自有独立的代码树与组件库。
init(项目地图接入)让 jj-flow 认识本地仓库将当前仓库或指定目录下的子仓库登记到 ~/.jj-flow/map.md,并按需导入历史经验(须经你确认后写入)。详见 init。
ralph(任务闭环)在当前单个仓库做需求的五步流程固定经历 分析 → 计划 → 实施 → 验收 → 归档 五步,记录保存在仓库 .workflow/ralph/ 下。详见 ralph。
same(跨仓同源迁移)把项目A 做好的功能适配到项目B不生搬硬套原文件,而是读取源仓库改动后,按目标仓库自己的组件风格与架构实现并验证。详见 same。
dispatch(多仓统筹调度)多个仓库先看预览表、统一批准再分派在本机 ~/.jj-flow 维护多项目调度账本,支持中断续跑与逐仓验收跟踪。详见 dispatch。
review(只读代码审查)派只读审查员挑毛病并落盘结论输出 [OK]、[WARN] 或 [BLOCK],绝不直接改业务代码。详见 review。
end(Git 收工)一键提交、推送并合并到 dev自动拉取最新 → 提交本任务文件 → 推工作分支 → 合入 dev 并推送 → 切回工作分支。详见 end。
会话执行引擎(team-*)可选的多角色分析或方案搜索工具包含 team-coordinate(动态多角色)、team-lifecycle(固定 SDLC)、team-swarm(多方案对抗搜索)。它们只辅助本轮执行,不代替 ralph 或 dispatch 的正式验收。
evaluated(离线复盘)用真实交付导出记录做耗时与返工诊断实验性离线评估工具,生成复盘报告供人工改进技能协议。详见 evaluated。

二、任务状态与跨仓调度术语 ​

术语 / 状态词日常怎么理解关键边界说明
证据(Evidence)仓库里可核对的真实记录包含 Git 提交、task_plan.md、progress.md、只读审查文件 REV-*.json 与调度回执。聊天框里口头说“改完了”不算证据。
交接包(handoff)从源仓库提炼出的跨仓迁移说明记录在源任务 .state/run.json(及 .state/handoff.json)中,写明改了什么、哪些该迁、哪些禁止照搬,供 same 读取。
VERIFIED(调度验收通过)目标仓库在调度账本里已集齐全部本地凭据需同时具备:Git 提交 + 审查通过 + 真实会话绑定 + 沙箱证明。注意:VERIFIED 不等于代码已 git push 到远端。
PENDING / BLOCKED证据还不齐 / 遇到阻塞停下等你确认只要缺少凭据或存在未确认项,系统就会保持 PENDING 或 BLOCKED,绝不伪装成已通过。
DEL-*(Delivery 编号)一次“多项目统筹交付”的账本编号例如 DEL-20261013-pnpm,由 dispatch 自动生成维护,不需要你手动输入。
task_key / run_id单个任务的稳定标识单仓任务形如 task-login-reminder;多仓调度子任务形如 DEL-001/A/development/1。用于中断后精准续接,日常对话无需背诵。
completed/已完成归档或已废弃的任务目录位于 .workflow/ralph/completed/。即使进了 completed/,只要是同一需求想微调,直接说就能接着改。

三、宿主工作模式与子代理角色 ​

术语 / 标识日常怎么理解详细说明
团队负责人(team-lead)你当前正在对话的主窗口 Agent负责和你对齐需求、维护 task_plan.md、编写派单并调度子代理;主对话自己不直接动手改业务代码。
派单(ASSIGNMENT-*)写给子代理的精确任务单文件保存在任务目录 assignments/ 下(分 TASK、REVIEW、FIX、RESEARCH、HANDOFF 五类)。子代理只读派单里点名的精确文件,不翻看主对话聊天记录。
执行人(Subagents)被主对话派出去干活的命名子代理包括 jj-implementer(写代码)、jj-reviewer(只读审查)、jj-researcher(只读调研)。派遣宣告、占位与 resume_from 续接规则见 skills/jj/references/assignment-spawn.md。
Mode S(单会话模式)Claude / Grok 默认工作方式在同一个对话窗口内完成所有调度;不同仓库可同时派发执行人并行修改,同一仓库内部保持串行。
Mode W(隔离工作区模式)使用独立 Git worktree + 命名功能分支仅在主工作区存在无法清理的无关脏文件、或你明确要求物理隔离时使用。
Mode P(独立子会话模式)每个写任务绑定一个独立子会话仅在你显式点名要求 1:1 独立子会话时启用(不同仓库并行修改并不需要先开 Mode P)。
沙箱证明(Sandbox Attestation)宿主运行时留下的真实执行凭据用于在 dispatch 中证明代码确实在受控工作区与指定权限下执行,而非模型口头虚构。

四、目录与知识记忆术语 ​

术语 / 路径日常怎么理解详细说明
项目地图(~/.jj-flow/map.md)本机所有业务仓库的通讯录记录每个仓库的中文名、别名、绝对路径与所属项目族,供 same 和 dispatch 按名字精准定位仓库。
记忆热层(~/.jj-flow/memory/<project_key>.md)每个项目专属的“高频踩坑与经验便签”ralph 任务归档时自动从 findings.md 提炼可复用结论存入此处;下次在该项目开新任务时自动按需注入。
全局知识库(~/.jj-flow/knowledge/)跨项目共享的沉淀规范库只有当你在 init 或 ralph 中主动提出并确认后,才会写入全局知识库。
events.jsonl机器可读的事件流水账位于 .workflow/ralph/<task>/.state/events.jsonl,供状态机校验门禁使用;日常人类查看进度请读 progress.md。

相关阅读 ​

基于 MIT 协议发布 · 以持久文件与 Git 证据驱动的多项目研发工作流