ratchet技能：RPI工作流进度追踪与永久锁定工具，提升开发效率

ratchet by boshu2/agentops

244 周安装量

220 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/boshu2/agentops --skill ratchet

开发项目管理自动化

🇨🇳中文介绍

Ratchet Skill

通过永久关卡追踪 RPI 工作流进度。

注意： /ratchet 用于追踪和锁定进度。它本身并不“运行循环”——需要与 /crank（史诗循环）或 /swarm（Ralph 循环）搭配使用来实际执行工作。

The Brownian Ratchet

Progress = Chaos × Filter → Ratchet

阶段	发生的情况
Chaos	多次尝试（探索、实现）
Filter	验证关卡（测试、/vibe、评审）
Ratchet	永久锁定进度（合并、关闭、存储）

关键洞察： 进度是永久性的。你无法撤销 Ratchet。

执行步骤

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

status - 检查当前状态

ao ratchet status 2>/dev/null

或手动检查链：

cat .agents/ao/chain.jsonl 2>/dev/null | tail -10

check [step] - 验证关卡

ao ratchet check <step> 2>/dev/null

步骤：research, plan, implement, vibe, post-mortem

record [step] - 记录完成情况

ao ratchet record <step> --output "<artifact-path>" 2>/dev/null

或通过写入链来手动记录：

echo '{"step":"<step>","status":"completed","output":"<path>","time":"<ISO-timestamp>"}' >> .agents/ao/chain.jsonl

skip [step] - 有意跳过

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

步骤	关卡	输出
`research`	研究产物存在	`.agents/research/*.md`
`plan`	计划产物存在	`.agents/plans/*.md`
`implement`	代码 + 测试通过	源文件
`vibe`	/vibe 通过	`.agents/vibe/*.md`
`post-mortem`	经验总结已提取	`.agents/learnings/*.md`

进度存储在 .agents/ao/chain.jsonl 中：

{"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"}

进度是永久性的 - 无法撤销 ratchet
关卡必须通过 - 在继续之前进行验证
记录一切 - 维护链
明确跳过 - 如果跳过某一步，需记录原因

用户说： /ratchet status

发生的情况：

代理调用 ao ratchet status 2>/dev/null 来检查当前状态
CLI 读取 .agents/ao/chain.jsonl 并解析进度
代理报告哪些步骤已完成、进行中或待处理
代理显示已完成步骤的输出产物路径
代理标识下一个需要通过的关卡

结果： RPI 工作流进度的单屏视图，显示哪些关卡已通过以及下一步是什么。

技能说： 在 /research 完成后

发生的情况：

代理调用 ao ratchet record research --output ".agents/research/auth.md"
CLI 将完成条目追加到 .agents/ao/chain.jsonl
代理将研究步骤锁定为永久完成
代理进入计划阶段，知道研究关卡已通过

结果： 进度被永久记录，关卡被锁定，工作流向前推进而不会倒退。

问题	原因	解决方案
ao ratchet status 失败	ao CLI 不可用或 chain.jsonl 缺失	手动检查 `.agents/ao/chain.jsonl` 或创建空文件
步骤已完成错误	尝试重新 ratchet 已锁定的步骤	使用 `ao ratchet status` 检查状态；如果已完成则跳过
chain.jsonl 损坏	JSON 条目格式错误	手动编辑以修复 JSON；使用 `jq -c '.' <file>` 验证每一行
步骤顺序错误	在计划之前进行实现	严格遵循 RPI 顺序；仅在明确原因下使用 `--skip`

🇺🇸English

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.

The Brownian Ratchet

Progress = Chaos × Filter → Ratchet

Phase	What Happens
Chaos	Multiple attempts (exploration, implementation)
Filter	Validation gates (tests, /vibe, review)
Ratchet	Lock progress permanently (merged, closed, stored)

Key insight: Progress is permanent. You can't un-ratchet.

Execution Steps

Given /ratchet [command]:

status - Check Current State

ao ratchet status 2>/dev/null

Or check the chain manually:

cat .agents/ao/chain.jsonl 2>/dev/null | tail -10

check [step] - Verify Gate

ao ratchet check <step> 2>/dev/null

Steps: research, plan, implement, vibe, post-mortem

record [step] - Record Completion

ao ratchet record <step> --output "<artifact-path>" 2>/dev/null

Or record manually by writing to chain:

echo '{"step":"<step>","status":"completed","output":"<path>","time":"<ISO-timestamp>"}' >> .agents/ao/chain.jsonl

skip [step] - Skip Intentionally

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

Workflow Steps

Step	Gate	Output
`research`	Research artifact exists	`.agents/research/*.md`
`plan`	Plan artifact exists	`.agents/plans/*.md`
`implement`	Code + tests pass	Source files
`vibe`	/vibe passes

Chain Storage

Progress stored in .agents/ao/chain.jsonl:

{"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

Examples

Check RPI Progress

User says: /ratchet status

What happens:

Agent calls ao ratchet status 2>/dev/null to check current state
CLI reads .agents/ao/chain.jsonl and parses progress
Agent reports which steps are completed, in-progress, or pending
Agent shows output artifact paths for completed steps
Agent identifies next gate to pass

Result: Single-screen view of RPI workflow progress, showing which gates passed and what's next.

Record Step Completion

Skill says: After /research completes

What happens:

Agent calls ao ratchet record research --output ".agents/research/auth.md"
CLI appends completion entry to .agents/ao/chain.jsonl
Agent locks research step as permanently completed
Agent proceeds to plan phase knowing research gate passed

Result: Progress permanently recorded, gate locked, workflow advances without backsliding.

Troubleshooting

Problem	Cause	Solution
ao ratchet status fails	ao CLI not available or chain.jsonl missing	Manually check `.agents/ao/chain.jsonl` or create empty file
Step already completed error	Attempting to re-ratchet locked step	Use `ao ratchet status` to check state; skip if already done
chain.jsonl corrupted	Malformed JSON entries	Manually edit to fix JSON; validate each line with `jq -c '.' <file>`
Out-of-order steps	Implementing before planning	Follow RPI order strictly; use `--skip` only with explicit reason

Weekly Installs

193

Repository

boshu2/agentops

GitHub Stars

197

First Seen

Feb 2, 2026

Security Audits

Gen Agent Trust HubPass SocketFail SnykPass

Installed on

claude-code191

codex191

opencode190

github-copilot190

kimi-cli190

gemini-cli190

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

140,500 周安装

ratchet技能：RPI工作流进度追踪与永久锁定工具，提升开发效率

🇨🇳中文介绍

Ratchet Skill

The Brownian Ratchet

执行步骤

相关 Skills

status - 检查当前状态

check [step] - 验证关卡

record [step] - 记录完成情况

skip [step] - 有意跳过

工作流步骤

链存储

关键规则

示例

检查 RPI 进度

记录步骤完成

故障排除

🇺🇸English

Ratchet Skill

The Brownian Ratchet

Execution Steps

status - Check Current State

check [step] - Verify Gate

record [step] - Record Completion

skip [step] - Skip Intentionally

Workflow Steps

Chain Storage

Key Rules

Examples

Check RPI Progress

Record Step Completion

Troubleshooting

最新 Skills