ralph

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ralph (Ouroboros) — Specification-First AI Development

ralph (Ouroboros) — 规约优先的AI开发

Stop prompting. Start specifying.
"The beginning is the end, and the end is the beginning." The serpent doesn't repeat — it evolves.
Most AI coding fails at the input, not the output. Ouroboros fixes the human, not the machine.

停止写提示词。开始制定规约。
"起点即是终点,终点亦是起点。" 衔尾蛇不会重复——它会进化。
大多数AI编码的失败根源在于输入而非输出。Ouroboros解决的是人的问题,而非机器的问题。

When to use this skill

何时使用该技能

  • Before writing any code — expose hidden assumptions with Socratic interviewing (Ambiguity ≤ 0.2 required)
  • Vague requirements — crystallize into an immutable YAML seed spec before touching the keyboard
  • Long-running tasks needing autonomous iteration until verified completion
  • Guaranteed completion tasks — Ralph loop persists across session boundaries until verification passes
  • When stuck — Nine Minds lateral thinking personas break through stagnation
  • Drift detection — measure deviation from original seed and course-correct before it's too late
  • Ontology convergence — evolutionary loop runs until consecutive generations are ≥ 0.95 similar

  • 编写任何代码之前 — 通过苏格拉底式访谈暴露隐藏的假设(要求歧义度≤0.2)
  • 需求模糊 — 动手敲代码前先具象化为不可变的YAML种子规约
  • 需要自主迭代直到验证完成的长期运行任务
  • 要求保证完成的任务 — Ralph循环可跨会话持久运行直到验证通过
  • 遇到阻塞时 — 九心智横向思考角色可打破停滞状态
  • 漂移检测 — 衡量与原始种子规约的偏差,在问题失控前修正路线
  • 本体收敛 — 进化循环持续运行直到连续代际相似度≥0.95

Core Architecture: The Ouroboros Loop

核心架构:Ouroboros循环

    Interview → Seed → Execute → Evaluate
        ↑                           ↓
        └──── Evolutionary Loop ────┘
Each cycle evolves, not repeats. Evaluation output feeds back as input for the next generation until the system converges.
    Interview → Seed → Execute → Evaluate
        ↑                           ↓
        └──── Evolutionary Loop ────┘
每个周期是进化而非重复。评估输出会作为下一代的输入反馈,直到系统收敛。

Double Diamond

Double Diamond

    ◇ Wonder          ◇ Design
   ╱  (diverge)      ╱  (diverge)
  ╱    explore      ╱    create
 ╱                 ╱
◆ ──────────── ◆ ──────────── ◆
 ╲                 ╲
  ╲    define       ╲    deliver
   ╲  (converge)     ╲  (converge)
    ◇ Ontology        ◇ Evaluation
First diamond (Socratic): diverge into questions → converge into ontological clarity. Second diamond (Pragmatic): diverge into design options → converge into verified delivery.
You cannot design what you haven't understood. The first diamond is a prerequisite for the second.

    ◇ Wonder          ◇ Design
   ╱  (diverge)      ╱  (diverge)
  ╱    explore      ╱    create
 ╱                 ╱
◆ ──────────── ◆ ──────────── ◆
 ╲                 ╲
  ╲    define       ╲    deliver
   ╲  (converge)     ╲  (converge)
    ◇ Ontology        ◇ Evaluation
第一个钻石(苏格拉底阶段): 发散提问 → 收敛到本体清晰度。 第二个钻石(务实阶段): 发散设计选项 → 收敛到验证过的交付产物。
你无法设计你还没理解的东西。第一个钻石是第二个的前置条件。

Commands

命令

CommandTriggersWhat It Does
ooo interview
ooo interview
,
interview me
,
clarify requirements
,
socratic questioning
Socratic questioning until Ambiguity ≤ 0.2
ooo seed
ooo seed
,
crystallize
,
generate seed
,
freeze requirements
Crystallize into immutable YAML spec
ooo run
ooo run
,
execute seed
,
ouroboros run
Execute via Double Diamond
ooo evaluate
ooo evaluate
,
3-stage check
,
evaluate this
3-stage gate: Mechanical → Semantic → Consensus
ooo evolve
ooo evolve
,
evolutionary loop
,
iterate until converged
Evolutionary loop until Similarity ≥ 0.95
ooo unstuck
ooo unstuck
,
I'm stuck
,
think sideways
,
lateral thinking
Nine Minds lateral thinking personas
ooo status
ooo status
,
am I drifting?
,
drift check
Drift detection + session tracking
ooo ralph
ooo ralph
,
ralph-ooo
,
don't stop
,
must complete
,
keep going
Persistent loop until verified
ooo setup
ooo setup
Register MCP server (one-time)
ooo cancel
/ouroboros:cancel
,
/ralph-ooo:cancel
Save checkpoint and exit

命令触发词功能
ooo interview
ooo interview
,
interview me
,
clarify requirements
,
socratic questioning
苏格拉底式提问直到歧义度≤0.2
ooo seed
ooo seed
,
crystallize
,
generate seed
,
freeze requirements
具象化为不可变的YAML规约
ooo run
ooo run
,
execute seed
,
ouroboros run
通过Double Diamond流程执行
ooo evaluate
ooo evaluate
,
3-stage check
,
evaluate this
三阶段门控:机械检查 → 语义检查 → 共识检查
ooo evolve
ooo evolve
,
evolutionary loop
,
iterate until converged
进化循环直到相似度≥0.95
ooo unstuck
ooo unstuck
,
I'm stuck
,
think sideways
,
lateral thinking
九心智横向思考角色介入
ooo status
ooo status
,
am I drifting?
,
drift check
漂移检测 + 会话追踪
ooo ralph
ooo ralph
,
ralph-ooo
,
don't stop
,
must complete
,
keep going
持久循环直到验证通过
ooo setup
ooo setup
注册MCP服务器(仅需一次)
ooo cancel
/ouroboros:cancel
,
/ralph-ooo:cancel
保存检查点并退出

Phase 1: Interview — From Wonder to Ontology

阶段1:访谈 — 从好奇到本体清晰

Wonder → "How should I live?" → "What IS 'live'?" → Ontology — Socrates
The Socratic Interviewer asks questions until Ambiguity ≤ 0.2. This is the gate between vague desire and executable spec.
ooo interview "I want to build a task management CLI"
好奇 → "我该如何生活?" → "什么才是'生活'?" → 本体 — 苏格拉底
苏格拉底访谈者会持续提问直到歧义度≤0.2。这是模糊需求和可执行规约之间的关卡。
ooo interview "I want to build a task management CLI"

Ambiguity Formula

歧义度计算公式

Ambiguity = 1 − Σ(clarityᵢ × weightᵢ)

Greenfield: Goal(40%) + Constraint(30%) + Success(30%)
Brownfield: Goal(35%) + Constraint(25%) + Success(25%) + Context(15%)

Threshold: Ambiguity ≤ 0.2 → ready for Seed
Example scoring:
Goal:       0.9 × 0.4 = 0.36   # "Build a CLI task manager" — clear
Constraint: 0.8 × 0.3 = 0.24   # "Python 3.14+, SQLite only" — defined
Success:    0.7 × 0.3 = 0.21   # "Tasks create/list/complete" — measurable
                      ──────
Clarity             = 0.81
Ambiguity = 1 − 0.81 = 0.19 ≤ 0.2 → ✓ Ready for Seed
Why 0.2? At 80% weighted clarity, remaining unknowns are small enough for code-level decisions to resolve. Above that threshold, you're still guessing at architecture.

Ambiguity = 1 − Σ(clarityᵢ × weightᵢ)

Greenfield: Goal(40%) + Constraint(30%) + Success(30%)
Brownfield: Goal(35%) + Constraint(25%) + Success(25%) + Context(15%)

阈值: 歧义度 ≤ 0.2 → 可进入种子阶段
评分示例:
目标:       0.9 × 0.4 = 0.36   # "构建CLI任务管理器" — 清晰
约束:       0.8 × 0.3 = 0.24   # "仅支持Python 3.14+、SQLite" — 已定义
成功标准:    0.7 × 0.3 = 0.21   # "支持任务创建/列表/完成" — 可衡量
                      ──────
总清晰度             = 0.81
歧义度 = 1 − 0.81 = 0.19 ≤ 0.2 → ✓ 可进入种子阶段
为什么是0.2?当加权清晰度达到80%时,剩余的未知项足够小,可以在代码层面决策解决。高于这个阈值的话,你依然是在猜测架构。

Phase 2: Seed — Immutable Specification

阶段2:种子 — 不可变规约

ooo seed
Generates YAML spec locked from interview answers:
yaml
goal: Build a CLI task management tool
constraints:
  - Python 3.14+
  - No external database
  - SQLite for persistence
acceptance_criteria:
  - Tasks can be created with title and priority
  - Tasks can be listed with status filter
  - Tasks can be marked complete
ontology_schema:
  name: TaskManager
  fields:
    - name: tasks
      type: array
    - name: title
      type: string
    - name: priority
      type: enum[low, medium, high]
    - name: status
      type: enum[open, done]
The seed is immutable. Once generated, it is the ground truth. Drift is measured against it.

ooo seed
根据访谈答案生成锁定的YAML规约:
yaml
goal: Build a CLI task management tool
constraints:
  - Python 3.14+
  - No external database
  - SQLite for persistence
acceptance_criteria:
  - Tasks can be created with title and priority
  - Tasks can be listed with status filter
  - Tasks can be marked complete
ontology_schema:
  name: TaskManager
  fields:
    - name: tasks
      type: array
    - name: title
      type: string
    - name: priority
      type: enum[low, medium, high]
    - name: status
      type: enum[open, done]
种子规约是不可变的。 一旦生成,它就是事实基准。所有漂移都会以它为参照衡量。

Phase 3: Execute — Double Diamond Run

阶段3:执行 — Double Diamond运行

ooo run seed.yaml
ooo run   # uses seed from conversation context
Executes the four phases:
  1. Discover — research existing patterns, constraints, precedents
  2. Define — ontological clarity, edge cases, decision boundaries
  3. Design — architecture, component breakdown, interface contracts
  4. Deliver — implementation, tests, documentation

ooo run seed.yaml
ooo run   # 使用会话上下文里的种子规约
执行四个阶段:
  1. 探索 — 调研现有模式、约束、先例
  2. 定义 — 本体清晰度、边界情况、决策边界
  3. 设计 — 架构、组件拆分、接口契约
  4. 交付 — 实现、测试、文档

Phase 4: Evaluate — 3-Stage Verification Gate

阶段4:评估 — 三阶段验证门控

ooo evaluate <session_id>
StageCostWhat It Checks
MechanicalFreeLint, build, tests, coverage, type checks
SemanticStandardAC compliance, goal alignment, drift score
ConsensusFrontier (optional)Multi-model vote, majority ratio
ooo evaluate <session_id>
阶段成本检查内容
机械检查免费Lint、构建、测试、覆盖率、类型检查
语义检查标准验收标准合规性、目标对齐度、漂移得分
共识检查前沿(可选)多模型投票,多数决

Drift Thresholds

漂移阈值

ScoreStatusAction
0.0 – 0.15
ExcellentOn track
0.15 – 0.30
AcceptableMonitor closely
0.30+
ExceededCourse correction required
Drift = weighted deviation from seed across three axes: Goal(50%) + Constraint(30%) + Ontology(20%).

得分状态操作
0.0 – 0.15
优秀正常推进
0.15 – 0.30
可接受密切监控
0.30+
超出阈值需要修正路线
漂移 = 三个维度相对于种子规约的加权偏差:目标(50%) + 约束(30%) + 本体(20%)。

Phase 5: Evolve — Ontological Convergence

阶段5:进化 — 本体收敛

ooo evolve "build a task management CLI"
ooo evolve "topic" --no-execute   # ontology-only fast mode
ooo evolve "build a task management CLI"
ooo evolve "topic" --no-execute   # 仅本体快速模式

Flow

流程

Gen 1: Interview → Seed(O₁) → Execute → Evaluate
Gen 2: Wonder → Reflect → Seed(O₂) → Execute → Evaluate
Gen 3: Wonder → Reflect → Seed(O₃) → Execute → Evaluate
...until Similarity ≥ 0.95 or 30 generations
第1代: 访谈 → 种子(O₁) → 执行 → 评估
第2代: 好奇 → 反思 → 种子(O₂) → 执行 → 评估
第3代: 好奇 → 反思 → 种子(O₃) → 执行 → 评估
...直到相似度≥0.95或达到30代

Convergence Formula

收敛公式

Similarity = 0.5 × name_overlap + 0.3 × type_match + 0.2 × exact_match
Threshold: Similarity ≥ 0.95 → CONVERGED

Gen 1: {Task, Priority, Status}                     → baseline
Gen 2: {Task, Priority, Status, DueDate}            → similarity 0.78 → CONTINUE
Gen 3: {Task, Priority, Status, DueDate}            → similarity 1.00 → CONVERGED ✓
相似度 = 0.5 × 名称重叠度 + 0.3 × 类型匹配度 + 0.2 × 完全匹配度
阈值: 相似度 ≥ 0.95 → 已收敛

第1代: {Task, Priority, Status}                     → 基准
第2代: {Task, Priority, Status, DueDate}            → 相似度 0.78 → 继续
第3代: {Task, Priority, Status, DueDate}            → 相似度 1.00 → 已收敛 ✓

Stagnation Detection

停滞检测

SignalConditionResponse
StagnationSimilarity ≥ 0.95 for 3 consecutive gensStop — converged
OscillationGen N ≈ Gen N-2 (period-2 cycle)Invoke
contrarian
persona
Repetitive feedback≥ 70% question overlap across 3 gensInvoke
researcher
persona
Hard cap30 generations reachedStop — safety valve

信号条件响应
停滞连续3代相似度≥0.95停止 — 已收敛
振荡第N代 ≈ 第N-2代(周期为2的循环)调用
contrarian
角色
重复反馈3代之间问题重叠度≥70%调用
researcher
角色
硬上限达到30代停止 — 安全阀门

Ralph — Persistent Loop Until Verified

Ralph — 持久循环直到验证通过

ooo ralph "fix all failing tests"
ooo ralph "implement the payment module"
"The boulder never stops." Each failure is data for the next attempt. Only verified success or max iterations stops it.
ooo ralph "fix all failing tests"
ooo ralph "implement the payment module"
"巨石永不停歇。" 每一次失败都是下一次尝试的数据。只有验证通过的成功或者达到最大迭代次数才会停止。

Loop Architecture

循环架构

┌─────────────────────────────────────┐
│  1. EXECUTE (parallel agents)       │
│     Fire independent sub-tasks      │
│     concurrently via Agent tool     │
├─────────────────────────────────────┤
│  2. VERIFY                          │
│     Check acceptance criteria       │
│     Run tests, lint, typecheck      │
│     Measure drift vs seed           │
├─────────────────────────────────────┤
│  3. LOOP (if failed)                │
│     Analyze failure evidence        │
│     Fix identified issues           │
│     Increment iteration counter     │
│     Repeat from step 1              │
├─────────────────────────────────────┤
│  4. PERSIST (each iteration)        │
│     .omc/state/ralph-ooo-state.json │
│     Resume after interruption       │
└─────────────────────────────────────┘
┌─────────────────────────────────────┐
│  1. 执行(并行Agents)               │
│     通过Agent工具并发触发独立子任务      │
├─────────────────────────────────────┤
│  2. 验证                          │
│     检查验收标准                     │
│     运行测试、Lint、类型检查            │
│     衡量相对于种子规约的漂移             │
├─────────────────────────────────────┤
│  3. 循环(如果失败)                  │
│     分析失败证据                     │
│     修复识别到的问题                   │
│     递增迭代计数器                    │
│     回到步骤1重复                     │
├─────────────────────────────────────┤
│  4. 持久化(每次迭代)                 │
│     .omc/state/ralph-ooo-state.json │
│     中断后可恢复                     │
└─────────────────────────────────────┘

State File Schema

状态文件Schema

Create
.omc/state/ralph-ooo-state.json
on start:
json
{
  "mode": "ralph-ooo",
  "session_id": "<uuid>",
  "request": "<user request>",
  "status": "running",
  "iteration": 0,
  "max_iterations": 10,
  "last_checkpoint": null,
  "seed_path": null,
  "verification_history": []
}
启动时创建
.omc/state/ralph-ooo-state.json
json
{
  "mode": "ralph-ooo",
  "session_id": "<uuid>",
  "request": "<user request>",
  "status": "running",
  "iteration": 0,
  "max_iterations": 10,
  "last_checkpoint": null,
  "seed_path": null,
  "verification_history": []
}

Loop Logic (Pseudocode)

循环逻辑(伪代码)

python
while iteration < max_iterations:
    result = execute_parallel(request, context)
    verification = verify_result(result, acceptance_criteria)
    state.verification_history.append({
        "iteration": iteration,
        "passed": verification.passed,
        "score": verification.score,
        "timestamp": now()
    })
    save_checkpoint(f"iteration_{iteration}")
    if verification.passed:
        save_checkpoint("complete")
        break
    iteration += 1
python
while iteration < max_iterations:
    result = execute_parallel(request, context)
    verification = verify_result(result, acceptance_criteria)
    state.verification_history.append({
        "iteration": iteration,
        "passed": verification.passed,
        "score": verification.score,
        "timestamp": now()
    })
    save_checkpoint(f"iteration_{iteration}")
    if verification.passed:
        save_checkpoint("complete")
        break
    iteration += 1

Progress Report Format

进度报告格式

[Ralph-OOO Iteration 1/10]
Executing in parallel...

Verification: FAILED
Score: 0.65
Issues:
  - 3 tests still failing
  - Type error in src/api.py:42

The boulder never stops. Continuing...

[Ralph-OOO Iteration 3/10]
Verification: PASSED ✓
Score: 1.0

Ralph-OOO COMPLETE
==================
Request: Fix all failing tests
Duration: 8m 32s
Iterations: 3
Verification History:
  - Iteration 1: FAILED (0.65)
  - Iteration 2: FAILED (0.85)
  - Iteration 3: PASSED (1.0)
[Ralph-OOO 迭代 1/10]
并行执行中...

验证: 失败
得分: 0.65
问题:
  - 3个测试仍失败
  - src/api.py:42存在类型错误

巨石永不停歇。继续运行...

[Ralph-OOO 迭代 3/10]
验证: 通过 ✓
得分: 1.0

Ralph-OOO 执行完成
==================
请求: 修复所有失败的测试
耗时: 8分32秒
迭代次数: 3
验证历史:
  - 迭代1: 失败 (0.65)
  - 迭代2: 失败 (0.85)
  - 迭代3: 通过 (1.0)

Completion Promise (Codex / Gemini)

完成承诺(Codex / Gemini)

xml
<promise>DONE</promise>
Default promise:
DONE
| Default max iterations:
10
xml
<promise>DONE</promise>
默认承诺:
DONE
| 默认最大迭代次数:
10

Cancellation

取消

ActionCommand
Save checkpoint & exit
/ouroboros:cancel
or
/ralph-ooo:cancel
Force clear all state
/ouroboros:cancel --force
Resume after interruption
ooo ralph continue

操作命令
保存检查点并退出
/ouroboros:cancel
/ralph-ooo:cancel
强制清空所有状态
/ouroboros:cancel --force
中断后恢复
ooo ralph continue

The Nine Minds

九心智

Loaded on-demand — never preloaded. Each mind has a single core question it cannot stop asking.
AgentRoleCore Question
Socratic InterviewerQuestions-only. Never builds."What are you assuming?"
OntologistFinds essence, not symptoms"What IS this, really?"
Seed ArchitectCrystallizes specs from dialogue"Is this complete and unambiguous?"
Evaluator3-stage verification"Did we build the right thing?"
ContrarianChallenges every assumption"What if the opposite were true?"
HackerFinds unconventional paths"What constraints are actually real?"
SimplifierRemoves complexity"What's the simplest thing that could work?"
ResearcherStops coding, starts investigating"What evidence do we actually have?"
ArchitectIdentifies structural causes"If we started over, would we build it this way?"
See references/nine-minds.md for full agent profiles.

按需加载 — 从不预加载。每个心智都有一个它无法停止追问的核心问题。
Agent角色核心问题
苏格拉底访谈者只提问,从不构建。"你在假设什么?"
本体论专家找到本质,而非症状"这到底是什么?"
种子架构师从对话中具象化规约"这是完整且无歧义的吗?"
评估者三阶段验证"我们构建的是正确的东西吗?"
唱反调者挑战所有假设"如果反过来才是对的呢?"
黑客找到非常规路径"哪些约束是真的存在的?"
简化者移除复杂度"能运行的最简单方案是什么?"
研究者停止编码,开始调研"我们实际掌握的证据是什么?"
架构师识别结构性原因"如果我们从头开始,还会这么构建吗?"
查看references/nine-minds.md获取完整Agent档案。

Unstuck — Lateral Thinking

解困 — 横向思考

When blocked after repeated failures:
ooo unstuck                  # auto-select based on context
ooo unstuck simplifier       # cut scope to MVP
ooo unstuck hacker           # make it work first, elegance later
ooo unstuck contrarian       # challenge all assumptions
ooo unstuck researcher       # stop coding, find missing information
ooo unstuck architect        # restructure the approach entirely
Decision guide:
  • Repeated similar failures →
    contrarian
    (challenge assumptions)
  • Too many options / paralysis →
    simplifier
    (reduce scope)
  • Missing information / unclear root cause →
    researcher
    (seek evidence)
  • Analysis paralysis / need momentum →
    hacker
    (just make it work)
  • Structural issues / wrong foundation →
    architect
    (redesign)

反复失败后遇到阻塞时:
ooo unstuck                  # 根据上下文自动选择
ooo unstuck simplifier       # 缩减范围到MVP
ooo unstuck hacker           # 先跑通,再考虑优雅性
ooo unstuck contrarian       # 挑战所有假设
ooo unstuck researcher       # 停止编码,查找缺失信息
ooo unstuck architect        # 彻底重构方案
决策指南:
  • 反复出现相似失败 →
    contrarian
    (挑战假设)
  • 选项太多/ paralysis →
    simplifier
    (缩减范围)
  • 信息缺失/根本原因不明确 →
    researcher
    (寻找证据)
  • 分析瘫痪/需要推进动力 →
    hacker
    (先跑通再说)
  • 结构性问题/基础错误 →
    architect
    (重新设计)

Quick Reference

快速参考

ActionCommand
Socratic interview
ooo interview "topic"
Generate spec
ooo seed
Execute spec
ooo run [seed.yaml]
3-stage evaluate
ooo evaluate <session_id>
Evolve until converged
ooo evolve "topic"
Persistent loop
ooo ralph "task"
Break stagnation
ooo unstuck [persona]
Check drift
ooo status [session_id]
First-time setup
ooo setup
Cancel
/ouroboros:cancel
Force cancel
/ouroboros:cancel --force
Resume
ooo ralph continue

操作命令
苏格拉底式访谈
ooo interview "topic"
生成规约
ooo seed
执行规约
ooo run [seed.yaml]
三阶段评估
ooo evaluate <session_id>
进化直到收敛
ooo evolve "topic"
持久循环
ooo ralph "task"
打破停滞
ooo unstuck [persona]
检查漂移
ooo status [session_id]
首次设置
ooo setup
取消
/ouroboros:cancel
强制取消
/ouroboros:cancel --force
恢复
ooo ralph continue

Available Scripts

可用脚本

Run from the skill directory:
ScriptPurpose
scripts/setup-codex-hook.sh
Configure Codex CLI for ralph-ooo (developer_instructions + prompts)
scripts/setup-gemini-hook.sh
Configure Gemini CLI AfterAgent hook for loop continuation
scripts/ooo-state.sh
Manage
.omc/state/ralph-ooo-state.json
(init/status/checkpoint/reset/resume)

在技能目录下运行:
脚本用途
scripts/setup-codex-hook.sh
为ralph-ooo配置Codex CLI(开发者说明 + 提示词)
scripts/setup-gemini-hook.sh
配置Gemini CLI AfterAgent钩子以支持循环继续
scripts/ooo-state.sh
管理
.omc/state/ralph-ooo-state.json
(初始化/状态/检查点/重置/恢复)

Platform Support Matrix

平台支持矩阵

PlatformSupportMechanismooo CommandsAuto Loop
Claude CodeFullSkills system + hooksAll
ooo
commands
Via hooks
Codex CLIAdaptedbash loop +
/prompts:ralph-ooo
Via conversationManual state file
Gemini CLINativeAfterAgent hookAll
ooo
commands
Via hook
OpenCodeNativeSkills systemAll
ooo
commands
Via loop

平台支持程度实现机制ooo命令支持自动循环
Claude Code完全支持技能系统 + 钩子所有
ooo
命令
通过钩子
Codex CLI适配支持bash循环 +
/prompts:ralph-ooo
通过会话手动状态文件
Gemini CLI原生支持AfterAgent钩子所有
ooo
命令
通过钩子
OpenCode原生支持技能系统所有
ooo
命令
通过循环

Installation

安装

bash
undefined
bash
undefined

Claude Code (via oh-my-skills)

Claude Code (通过oh-my-skills)

npx skills add https://github.com/akillness/oh-my-skills --skill ralph-ooo
npx skills add https://github.com/akillness/oh-my-skills --skill ralph-ooo

Codex CLI setup

Codex CLI设置

bash .agent-skills/ralph-ooo/scripts/setup-codex-hook.sh
bash .agent-skills/ralph-ooo/scripts/setup-codex-hook.sh

Gemini CLI setup

Gemini CLI设置

bash .agent-skills/ralph-ooo/scripts/setup-gemini-hook.sh
bash .agent-skills/ralph-ooo/scripts/setup-gemini-hook.sh

Ouroboros native plugin

Ouroboros原生插件

claude plugin marketplace add Q00/ouroboros claude plugin install ouroboros@ouroboros ooo setup

---
claude plugin marketplace add Q00/ouroboros claude plugin install ouroboros@ouroboros ooo setup

---

References

参考资料

Detailed documentation in
references/
:
FileContents
references/ouroboros-commands.md
Full ooo command syntax, parameters, output formats, state schemas
references/nine-minds.md
All 9 agent profiles, core questions, when to invoke, unstuck guide
references/platform-setup.md
Per-platform setup, hooks.json, AfterAgent config, Gemini bug workarounds

Source: Q00/ouroboros — MIT License
references/
目录下的详细文档:
文件内容
references/ouroboros-commands.md
完整ooo命令语法、参数、输出格式、状态Schema
references/nine-minds.md
全部9个Agent档案、核心问题、调用时机、解困指南
references/platform-setup.md
各平台设置、hooks.json、AfterAgent配置、Gemini bug workaround

源码: Q00/ouroboros — MIT License