mcpField
T
tutorial

tutorial

github.com/q00エージェントワークフロー6.3k60 回インストール1 日前に更新
リポジトリ

tutorial について

ユーザー自身のプロジェクト案について質問しながら Ouroboros を紹介する対話型チュートリアルです。ミニ仕様からインタビュー、Seed、実行、評価までの流れを学べます。

主な機能

  1. 01実践型の対話チュートリアル
  2. 02ソクラテス式のプロジェクト質問
  3. 03ミニ Seed の作成
  4. 04ワークフローとコマンドの紹介

活用シーン

  1. 01Ouroboros の基本を学ぶ
  2. 02初期プロジェクト案を整理する
  3. 03次のプロジェクト行動を決める

MCP 対応

`run`、`evaluate`、`evolve`、`status` の利用には、`ooo setup` で構成する Ouroboros MCP サーバーが必要だと説明しています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/q00/ouroboros --skill tutorial

インストール後、Claude Code で/tutorialを入力して読み込まれたか確認します。

詳細

/ouroboros:tutorial

実践を通じて Ouroboros を学ぶインタラクティブチュートリアルです。

使い方

ooo tutorial
/ouroboros:tutorial

原則

  1. 最初の30秒で役立つものを見せます。
  2. 実践を通じて学びます。ユーザー自身のアイデアについて質問に答えてもらいます。
  3. 機能は段階的に紹介します。
  4. 各フェーズの最後には、具体的な次のアクションを必ず提示します。
  5. 対象者に合わせます。技術者には実行、評価、進化の詳細を、非技術者にはインタビューと平易な言葉で説明します。

流れ（約5分）

  1. 興味を引く。 5分で漠然としたアイデアが明確な仕様になると伝え、何を作りたいか尋ねます。アイデアがない場合は、タスク管理 CLI を例にします。

  2. インタビュー。 アイデアについて、解決する問題、主なユーザー、今それを役立つものにする機能などを、ソクラテス式の質問で3～4問尋ねます。それぞれの回答から、明示されていなかった前提が明らかになったことを指摘します。

  3. ミニ Seed。 回答を Seed の用語で要約します。

    Goal: <their goal, refined>
Constraints: <2-3 constraints they named>
Acceptance criteria: <2-3 checkable outcomes>

    曖昧さスコアをでっち上げてはいけません。ooo interview が曖昧さを測定し、実際の Seed を確定できるほど低くなるまで続けることを説明します。

  4. ワークフロー。 Interview → Seed → Execute → Evaluate。評価結果は次の Seed の生成に反映されます。

    ooo interview "your idea"   # expose assumptions
ooo seed                    # freeze the Seed
ooo run                     # execute it
ooo evaluate                # verify against the acceptance criteria
ooo status                  # check drift

    行き詰まったときは ooo unstuck が役立ちます。run、evaluate、evolve、status には Ouroboros MCP サーバーが必要です（ooo setup）。

  5. 次のステップ。 次の選択肢を提示します。実際のプロジェクトを始める（ooo interview "your actual project idea"）、完全なリファレンスを確認する（ooo help）、またはセットアップする（ooo setup）。

ユーザーから、AI アシスタントに直接プロンプトを入力する場合との違いを尋ねられたら、仕様がないとアシスタントは推測し、合うまでプロンプトを書き直すことになる一方、Ouroboros ではインタビューで隠れた前提を先に明らかにするため、合意済みの Seed に基づいて構築を始められると説明します。複雑そうに感じる場合は、ほとんどの用途は ooo interview、ooo seed、ooo run の3つのコマンドで対応できると伝えます。

ユーザーがインタビューを体験し、Seed とは何かを理解して、次のステップを選んだらチュートリアルは完了です。

RFC #1392 状態表示フッター

最終回答の末尾に、◆ <current state> → next: <recommended action> という形式の行を1行だけ付けます。利用可能な場合は ouroboros_session_status でライブセッションの状態を取得し、それ以外の場合はこのスキルの実際の結果から状態を判断します。Step N of M のような直線的なフッターは使いません。次のステップを実際に選べる場合は、2～3個の選択肢を示します。

コメント

Markdown 対応