jj-flow

外观

jj-ralph 任务全流程自治闭环 ​

状态：Implemented

验收证据：tests/jj-ralph-contract.test.mjs、npm run ralph:check、npm run verify

边界：skill + ralph_ops / CLI；无 dispatch CAS；不自动 commit/push/merge

1. 目标 ​

当前单一业务仓库内可追溯闭环：

text
ANALYZE → PLAN → DELIVER → ACCEPT → ARCHIVE
  • 状态在 .workflow/ralph/（run ledger）
  • business-map.json 供下次发现
  • 事实源：run.json / Git / 验证产物，不是聊天

2. 非目标 ​

非目标入口
多仓迁移jj-same
多目标调度jj-dispatch
宿主 review 落盘jj-review
Git 收工jj-end

3. 阶段 ​

权威：skills/jj-ralph/SKILL.md（对话入口）；机械 CLI 与 gate 语义在 src/ralph/。

阶段含义
ANALYZE / PLAN需求与最小计划
DELIVER实施；deliver-attempt 停滞/预算
ACCEPT验收；strict 需 judgment 层
ARCHIVEfinalize = map-merge + 归档快照（可再归档）

status： IN_PROGRESS 等活跃态；COMPLETED = 最近一次归档后的展示态（可 resume）；ABANDONED = 废弃（禁 map，可 resume）。

intensity： tiny | standard | strict（init 时写入）。

4. 续作与回退 ​

权威：src/ralph.mjs（phase 回退 / resume / abandon）；对话续作写在 skills/jj-ralph/SKILL.md。

意图动作
phase 回退相邻边（含 ARCHIVE→ACCEPT）
归档后再做同 run resume
一半不做abandon
真新需求才新 run
Git$jj-end（与 run 是否还能改无关）

用户向：ralph 命令。

5. 产物 ​

text
.workflow/ralph/
  business-map.json
  RALPH-{slug}-{date}/     # 权威目录（归档后仍在此续作）
  archive/…                # 历史快照

6. 衔接 ​

handoffrun.handoff；same 读后迁仓
dispatchdispatch-snapshot 仅推荐，不替代 control-plane

7. 实现 ​

层路径
库src/ralph.mjs
可移植skill scripts/lib/ralph.mjs（ralph:sync）
CLIjj ralph …（含 resume / abandon；close deprecated）

8. 硬约束 ​

  • 短分析/计划；失败有限次换策略
  • 聊天不推进 checkpoint
  • 同需求不因「已归档」强制新 run