Back to Details

ratchet

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Ratchet Skill

Ratchet Skill

Track progress through the RPI workflow with permanent gates.
Note: 
/ratchet
tracks and locks progress. It does not “run the loop” by itself—pair it with 
/crank
(epic loop) or 
/swarm
(Ralph loop) to actually execute work.
通过永久性进度门跟踪RPI工作流的进度。
注意： 
/ratchet
用于跟踪并锁定进度。它本身不会“运行循环”——需要搭配 
/crank
（史诗循环）或 
/swarm
（Ralph循环）才能实际执行工作。

The Brownian Ratchet

布朗棘轮

Progress = Chaos × Filter → Ratchet
PhaseWhat Happens
ChaosMultiple attempts (exploration, implementation)
FilterValidation gates (tests, /vibe, review)
RatchetLock progress permanently (merged, closed, stored)
Key insight: Progress is permanent. You can't un-ratchet.
Progress = Chaos × Filter → Ratchet
阶段操作内容
混沌阶段多次尝试（探索、实现）
筛选阶段验证关卡（测试、/vibe、评审）
棘轮阶段永久锁定进度（合并、关闭、存储）
核心要点： 进度是永久性的，无法回退棘轮状态。

Execution Steps

执行步骤

Given 
/ratchet [command]
:
输入 
/ratchet [command]
后：

status - Check Current State

status - 查看当前状态

bash
ao ratchet status 2>/dev/null
Or check the chain manually:
bash
cat .agents/ao/chain.jsonl 2>/dev/null | tail -10
bash
ao ratchet status 2>/dev/null
或手动检查链文件：
bash
cat .agents/ao/chain.jsonl 2>/dev/null | tail -10

check [step] - Verify Gate

check [step] - 验证关卡

bash
ao ratchet check <step> 2>/dev/null
Steps: 
research
, 
plan
, 
implement
, 
vibe
, 
post-mortem
bash
ao ratchet check <step> 2>/dev/null
可选步骤：
research
、
plan
、
implement
、
vibe
、
post-mortem

record [step] - Record Completion

record [step] - 记录完成状态

bash
ao ratchet record <step> --output "<artifact-path>" 2>/dev/null
Or record manually by writing to chain:
bash
echo '{"step":"<step>","status":"completed","output":"<path>","time":"<ISO-timestamp>"}' >> .agents/ao/chain.jsonl
bash
ao ratchet record <step> --output "<artifact-path>" 2>/dev/null
或手动写入链文件完成记录：
bash
echo '{"step":"<step>","status":"completed","output":"<path>","time":"<ISO-timestamp>"}' >> .agents/ao/chain.jsonl

skip [step] - Skip Intentionally

skip [step] - 主动跳过步骤

bash
ao ratchet skip <step> --reason "<why>" 2>/dev/null
bash
ao ratchet skip <step> --reason "<why>" 2>/dev/null

Workflow Steps

工作流步骤

StepGateOutput
research
Research artifact exists
.agents/research/*.md
plan
Plan artifact exists
.agents/plans/*.md
implement
Code + tests passSource files
vibe
/vibe passes
.agents/vibe/*.md
post-mortem
Learnings extracted
.agents/retros/*.md
步骤验证关卡输出产物
research
存在研究产物
.agents/research/*.md
plan
存在计划产物
.agents/plans/*.md
implement
代码+测试通过源文件
vibe
/vibe验证通过
.agents/vibe/*.md
post-mortem
提取经验总结
.agents/retros/*.md

Chain Storage

链存储

Progress stored in 
.agents/ao/chain.jsonl
:
json
{"step":"research","status":"completed","output":".agents/research/auth.md","time":"2026-01-25T10:00:00Z"}
{"step":"plan","status":"completed","output":".agents/plans/auth-plan.md","time":"2026-01-25T11:00:00Z"}
{"step":"implement","status":"in_progress","time":"2026-01-25T12:00:00Z"}
进度信息存储在 
.agents/ao/chain.jsonl
文件中：
json
{"step":"research","status":"completed","output":".agents/research/auth.md","time":"2026-01-25T10:00:00Z"}
{"step":"plan","status":"completed","output":".agents/plans/auth-plan.md","time":"2026-01-25T11:00:00Z"}
{"step":"implement","status":"in_progress","time":"2026-01-25T12:00:00Z"}

Key Rules

核心规则

  • Progress is permanent - can't un-ratchet
  • Gates must pass - validate before proceeding
  • Record everything - maintain the chain
  • Skip explicitly - document why if skipping a step
  • 进度永久有效 - 无法回退棘轮状态
  • 必须通过关卡 - 推进前需完成验证
  • 记录所有操作 - 维护链文件
  • 主动跳过需说明 - 若跳过步骤需记录原因