tutorial
Interactive tutorial teaching Ouroboros hands-on
- License 许可
- MIT
- 所属仓库
- agisota/old-one
- 最近更新
- 2026-07-04
- Stars
- ★ 3
- Forks
- 1
01 前言 Front Matter
- name
- tutorial
- description
- Interactive tutorial teaching Ouroboros hands-on
03 SKILL.md 正文
/ouroboros:tutorial
Interactive tutorial that teaches Ouroboros through hands-on experience.
Usage
ooo tutorial
/ouroboros:tutorial
Tutorial Flow
When this skill is invoked, guide the user through a learn-by-doing tutorial with progressive disclosure.
Phase 1: The Hook (30 seconds)
Start with enthusiasm and immediate value:
Welcome to the Ouroboros Tutorial!
In the next 5 minutes, you'll:
- Transform a vague idea into a precise specification
- See Ouroboros expose hidden assumptions you didn't know you had
- Generate a validated Seed ready for AI execution
Let's start with YOUR idea. What's something you've been wanting to build?
[Wait for user response - any project idea works]
Phase 2: The Interview Experience (2 minutes)
Once they share an idea, immediately start a simplified interview:
Great choice! Let me show you how Ouroboros thinks about this.
[Ask 3-4 targeted Socratic questions about their idea]
- "What's the primary problem this solves?"
- "Who are the main users?"
- "What's the one feature that would make this useful immediately?"
Notice something? Each question exposed an assumption you hadn't articulated.
This is the "aha moment" - requirements clarity BEFORE writing code.
Phase 3: The Quick Win (1 minute)
Generate a mini-seed to show immediate value:
Based on your answers, here's what we've uncovered:
[Display a simplified seed structure]
Goal: [their goal refined]
Constraints: [3 key constraints they mentioned]
Success Criteria: [2-3 clear metrics]
Ambiguity Score: 0.XX [show progress from vague to clear]
This seed is now ready for AI execution. No more "build me X" and hoping for the best!
Phase 4: Feature Discovery (1 minute)
Progressive disclosure of features:
Now that you've seen the core magic, here's what else Ouroboros can do:
Immediate Wins (Available Now):
- ooo unstuck - 5 lateral thinking personas when you're blocked
- ooo seed - Generate full specifications from interviews
- ooo evolve - Evolutionary loop until ontology converges
Advanced Features (Setup Required):
- ooo run - Execute with visual TUI dashboard
- ooo evaluate - 3-stage quality verification
- ooo status - Track project drift in real-time
Want to try any of these now? Or shall I show you the full workflow?
Phase 5: The Real Workflow (30 seconds)
Show the complete pipeline:
The Complete Ouroboros Workflow:
Idea → Interview → Seed → Route → Execute → Evaluate
↓ ↓ ↓ ↓ ↓ ↓
Vague Clear Frozen Right Build Verified
Assumptions Spec Model Visibly Quality
5 commands from idea to validated result:
1. ooo interview "your idea" # Expose assumptions
2. ooo seed # Crystallize spec
3. ooo run # Execute with TUI
4. ooo evaluate # 3-stage verification
5. ooo status # Check drift
Ready to try your first real project?
Phase 6: Call to Action
Your First Real Project awaits!
Pick a path:
Path A: Start Fresh
ooo interview "your actual project idea"
Path B: Learn More
ooo help # Full command reference
Path C: Setup Full Features
ooo setup # Enable TUI, evaluation, drift tracking
Which path interests you?
Tutorial Principles
- Immediate Value - Show something useful in the first 30 seconds
- Learn by Doing - Don't just explain, have them experience it
- Progressive Disclosure - Reveal features gradually, not all at once
- Quick Wins - Celebrate small milestones throughout
- Clear Next Steps - Always give them a specific action to take
Tutorial Checkpoints
Track progress through these checkpoints:
- [ ] User shares an idea
- [ ] User experiences the "aha moment" of exposed assumptions
- [ ] User sees their first mini-seed generated
- [ ] User understands the value proposition
- [ ] User chooses a next step (path A, B, or C)
Common Tutorial Responses
"I don't have a project idea"
No problem! Let's use a classic example: a task management CLI.
[Continue tutorial with task management CLI example]
"This seems complicated"
It's actually simpler than it sounds. Let me show you the 3 commands you'll use 90% of the time:
1. ooo interview "idea" # Clarify what you want
2. ooo seed # Generate the spec
3. ooo run # Build it
Everything else is optional power-user features.
"How is this different from just prompting Claude?"
Great question! The difference is:
Without Ouroboros:
"Build me a task CLI" → Claude guesses → You realize it's wrong → Rewrite prompt → Repeat
With Ouroboros:
Interview → Hidden assumptions exposed → Precise spec → Claude builds exactly what you want → First try
The interview saves you hours of iteration.
Success Metrics
A successful tutorial ends when:
- User has experienced the interview process
- User understands the seed specification concept
- User knows their next step
- User feels confident to try their real project
Tutorial Variations
For Technical Users
- Emphasize the TUI dashboard and evolutionary loop
- Show cost optimization features (PAL Router)
- Highlight evaluation pipeline
For Non-Technical Users
- Focus on the interview and clarification process
- Emphasize the "translate ideas to specs" value
- Minimize technical jargon
For OMC Users
- Highlight key differences (TUI, specs, cost optimization)
- Show migration path from OMC commands
- Compare feature sets side-by-side
04 同仓库更多 Skills
zoom-out
Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
zeroize-audit
Detects missing zeroization of sensitive data in source code and identifies zeroization removed by compiler optimizations, with assembly-level analysis, and control-flow verification. Use for auditing C/C++/Rust code handling secrets, keys, passwords, or other sensitive data.
yeet
Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).
yara-rule-authoring
Guides authoring of high-quality YARA-X detection rules for malware identification. Use when writing, reviewing, or optimizing YARA rules. Covers naming conventions, string selection, performance optimization, migration from legacy YARA, and false positive reduction. Triggers on: YARA, YARA-X, malware detection, threat hunting, IOC, signature, crx module, dex module.
x-twitter-growth
X/Twitter growth engine for building audience, crafting viral content, and analyzing engagement. Use when the user wants to grow on X/Twitter, write tweets or threads, analyze their X profile, research competitors on X, plan a posting strategy, or optimize engagement. Complements social-content (generic multi-platform) with X-specific depth: algorithm mechanics, thread engineering, reply strategy, profile optimization, and competitive intelligence via web search.
x-api
X/Twitter API integration for posting tweets, threads, reading timelines, search, and analytics. Covers OAuth auth patterns, rate limits, and platform-native content posting. Use when the user wants to interact with X programmatically.