Skip to main content 首页 创作者 ruvnet ruview pair-programming
pair-programming AI-assisted pair programming with multiple modes (driver/navigator/switch), real-time verification, quality monitoring, and comprehensive testing. Supports TDD, debugging, refactoring, and learning sessions. Features automatic role switching, continuous code review, security scanning, and performance optimization with truth-score verification.
跳到安装 Skills Marketplace 发现并探索由社区构建的 Agent Skills
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/ruvnet/RuView --skill pair-programming命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
下载 Zip 下载中... name Pair Programming description AI-assisted pair programming with multiple modes (driver/navigator/switch), real-time verification, quality monitoring, and comprehensive testing. Supports TDD, debugging, refactoring, and learning sessions. Features automatic role switching, continuous code review, security scanning, and performance optimization with truth-score verification.
Pair Programming
Collaborative AI pair programming with intelligent role management, real-time quality monitoring, and comprehensive development workflows.
What This Skill Does
This skill provides professional pair programming capabilities with AI assistance, supporting multiple collaboration modes, continuous verification, and integrated testing. It manages driver/navigator roles, performs real-time code review, tracks quality metrics, and ensures high standards through truth-score verification.
Key Capabilities:
Multiple Modes : Driver, Navigator, Switch, TDD, Review, Mentor, DebugReal-Time Verification : Automatic quality scoring with rollback on failuresRole Management : Seamless switching between driver/navigator rolesTesting Integration : Auto-generate tests, track coverage, continuous testingCode Review : Security scanning, performance analysis, best practice enforcementSession Persistence : Auto-save, recovery, export, and sharing
Prerequisites
Required:
Claude Flow CLI installed (npm install -g claude-flow@alpha)
Git repository (optional but recommended)
Recommended:
Testing framework (Jest, pytest, etc.)
Linter configured (ESLint, pylint, etc.)
Code formatter (Prettier, Black, etc.)
Quick Start
Basic Session
TDD Session
claude-flow pair --start \
--mode tdd \
--test-first \
--coverage 90
Complete Guide
Session Control Commands
Starting Sessions
claude-flow pair --start
claude-flow pair --start \
--agent senior-dev \
--focus refactor \
--verify \
--threshold 0.98
claude-flow pair --start \
--agent debugger-expert \
--focus debug \
--review
claude-flow pair --start \
--mode mentor \
--pace slow \
--examples
Session Management
claude-flow pair --status
claude-flow pair --history
/pause [--reason <reason>]
/resume
claude-flow pair --end [--save] [--report]
Available Modes
Driver Mode You write code while AI provides guidance.
claude-flow pair --start --mode driver
Write actual code
Implement solutions
Make immediate decisions
Handle syntax and structure
Strategic guidance
Spot potential issues
Suggest improvements
Real-time review
Track overall direction
Learning new patterns
Implementing familiar features
Quick iterations
Hands-on debugging
/suggest - Get implementation suggestions
/review - Request code review
/explain - Ask for explanations
/optimize - Request optimization ideas
/patterns - Get pattern recommendations
Navigator Mode AI writes code while you provide direction.
claude-flow pair --start --mode navigator
Provide high-level direction
Review generated code
Make architectural decisions
Ensure business requirements
Write implementation code
Handle syntax details
Implement your guidance
Manage boilerplate
Execute refactoring
Rapid prototyping
Boilerplate generation
Learning from AI patterns
Exploring solutions
/implement - Direct implementation
/refactor - Request refactoring
/test - Generate tests
/document - Add documentation
/alternate - See alternative approaches
Switch Mode Automatically alternates roles at intervals.
claude-flow pair --start --mode switch
claude-flow pair --start --mode switch --interval 5m
claude-flow pair --start --mode switch --interval 15m
30-second warning before switch
Current driver completes thought
Context summary generated
Roles swap smoothly
New driver continues
Balanced collaboration
Knowledge sharing
Complex features
Extended sessions
Specialized Modes TDD Mode - Test-Driven Development:
claude-flow pair --start \
--mode tdd \
--test-first \
--coverage 100
Workflow: Write failing test → Implement → Refactor → Repeat
Review Mode - Continuous code review:
claude-flow pair --start \
--mode review \
--strict \
--security
Features: Real-time feedback, security scanning, performance analysis
Mentor Mode - Learning-focused:
claude-flow pair --start \
--mode mentor \
--explain-all \
--pace slow
Features: Detailed explanations, step-by-step guidance, pattern teaching
Debug Mode - Problem-solving:
claude-flow pair --start \
--mode debug \
--verbose \
--trace
Features: Issue identification, root cause analysis, fix suggestions
In-Session Commands
Code Commands /explain [--level basic|detailed|expert]
Explain the current code or selection
/suggest [--type refactor|optimize|security|style]
Get improvement suggestions
/implement <description>
Request implementation (navigator mode)
/refactor [--pattern <pattern>] [--scope function|file|module]
Refactor selected code
/optimize [--target speed|memory|both]
Optimize code for performance
/document [--format jsdoc|markdown|inline]
Add documentation to code
/comment [--verbose]
Add inline comments
/pattern <pattern-name> [--example]
Apply a design pattern
Testing Commands /test [--watch] [--coverage] [--only <pattern>]
Run test suite
/test-gen [--type unit|integration|e2e]
Generate tests for current code
/coverage [--report html|json|terminal]
Check test coverage
/mock <target> [--realistic]
Generate mock data or functions
/test-watch [--on-save]
Enable test watching
/snapshot [--update]
Create test snapshots
Review Commands /review [--scope current|file|changes] [--strict]
Perform code review
/security [--deep] [--fix]
Security analysis
/perf [--profile] [--suggestions]
Performance analysis
/quality [--detailed]
Check code quality metrics
/lint [--fix] [--config <config>]
Run linters
/complexity [--threshold <value>]
Analyze code complexity
Navigation Commands /goto <file>[:line[:column]]
Navigate to file or location
/find <pattern> [--regex] [--case-sensitive]
Search in project
/recent [--limit <n>]
Show recent files
/bookmark [add|list|goto|remove] [<name>]
Manage bookmarks
/history [--limit <n>] [--filter <pattern>]
Show command history
/tree [--depth <n>] [--filter <pattern>]
Show project structure
Git Commands /diff [--staged] [--file <file>]
Show git diff
/commit [--message <msg>] [--amend]
Commit with verification
/branch [create|switch|delete|list] [<name>]
Branch operations
/stash [save|pop|list|apply] [<message>]
Stash operations
/log [--oneline] [--limit <n>]
View git log
/blame [<file>]
Show git blame
AI Partner Commands /agent [switch|info|config] [<agent-name>]
Manage AI agent
/teach <preference>
Teach the AI your preferences
/feedback [positive|negative] <message>
Provide feedback to AI
/personality [professional|friendly|concise|verbose]
Adjust AI personality
/expertise [add|remove|list] [<domain>]
Set AI expertise focus
Metrics Commands /metrics [--period today|session|week|all]
Show session metrics
/score [--breakdown]
Show quality scores
/productivity [--chart]
Show productivity metrics
/leaderboard [--personal|team]
Show improvement leaderboard
Role & Mode Commands /switch [--immediate]
Switch driver/navigator roles
/mode <type>
Change mode (driver|navigator|switch|tdd|review|mentor|debug)
/role
Show current role
/handoff
Prepare role handoff
Command Shortcuts Alias Full Command /s/suggest/e/explain/t/test/r/review/c/commit/g/goto/f/find/h/help/sw/switch/st/status
Configuration
Basic Configuration Create .claude-flow/pair-config.json:
{
"pair" : {
"enabled" : true ,
"defaultMode" : "switch" ,
"defaultAgent" : "auto" ,
"autoStart" : false ,
"theme" : "professional"
}
}
Complete Configuration {
"pair" : {
"general" : {
"enabled" : true ,
"defaultMode" : "switch" ,
"defaultAgent" : "senior-dev" ,
"language" : "javascript" ,
"timezone" : "UTC"
} ,
"modes" : {
"driver" : {
"enabled" : true ,
"suggestions" : true ,
"realTimeReview" : true ,
"autoComplete" : false } ,
"navigator" : {
"enabled" : true ,
"codeGeneration" : true ,
"explanations" : true ,
"alternatives" : true } ,
"switch" : {
"enabled" : true ,
"interval" : "10m" ,
"warning" : "30s" ,
"autoSwitch" : true ,
"pauseOnIdle" : true }
} ,
"verification" : {
"enabled" : true ,
"threshold" : 0.95 ,
"autoRollback" : true ,
"preCommitCheck" : true ,
"continuousMonitoring" : true ,
"blockOnFailure" : true } ,
"testing" : {
"enabled" : true ,
"autoRun" : true ,
"framework" : "jest" ,
"onSave" : true ,
"coverage" : {
"enabled" : true ,
"minimum" : 80 ,
"enforce" : true ,
"reportFormat" : "html"
}
} ,
"review" : {
"enabled" : true ,
"continuous" : true ,
"preCommit" : true ,
"security" : true ,
"performance" : true ,
"style" : true ,
"complexity" : {
"maxComplexity" : 10 ,
"maxDepth" : 4 ,
"maxLines" : 100
}
} ,
"git" : {
"enabled" : true ,
"autoCommit" : false ,
"commitTemplate" : "feat: {message}" ,
"signCommits" : false ,
"pushOnEnd" : false ,
"branchProtection" : true } ,
"session" : {
"autoSave" : true ,
"saveInterval" : "5m" ,
"maxDuration" : "4h" ,
"idleTimeout" : "15m" ,
"breakReminder" : "45m" ,
"metricsInterval" : "1m"
} ,
"ai" : {
"model" : "advanced" ,
"temperature" : 0.7 ,
"maxTokens" : 4000 ,
"personality" : "professional" ,
"expertise" : [ "backend" , "testing" , "security" ] ,
"learningEnabled" : true }
}
}
Built-in Agents {
"agents" : {
"senior-dev" : {
"expertise" : [ "architecture" , "patterns" , "optimization" ] ,
"style" : "thorough" ,
"reviewLevel" : "strict"
} ,
"tdd-specialist" : {
"expertise" : [ "testing" , "mocks" , "coverage" ] ,
"style" : "test-first" ,
"reviewLevel" : "comprehensive"
} ,
"debugger-expert" : {
"expertise" : [ "debugging" , "profiling" , "tracing" ] ,
"style" : "analytical" ,
"reviewLevel" : "focused"
} ,
"junior-dev" : {
"expertise" : [ "learning" , "basics" , "documentation" ] ,
"style" : "questioning" ,
"reviewLevel" : "educational"
}
}
}
CLI Configuration
claude-flow pair config set defaultMode switch
claude-flow pair config set verification.threshold 0.98
claude-flow pair config get
claude-flow pair config get defaultMode
claude-flow pair config export > config.json
claude-flow pair config import config.json
claude-flow pair config reset
Profile Management Create reusable profiles:
claude-flow pair profile create refactoring \
--mode driver \
--verify true \
--threshold 0.98 \
--focus refactor
claude-flow pair --start --profile refactoring
claude-flow pair profile list
{
"profiles" : {
"refactoring" : {
"mode" : "driver" ,
"verification" : {
"enabled" : true ,
"threshold" : 0.98
} ,
"focus" : "refactor"
} ,
"debugging" : {
"mode" : "navigator" ,
"agent" : "debugger-expert" ,
"trace" : true ,
"verbose" : true } ,
"learning" : {
"mode" : "mentor" ,
"pace" : "slow" ,
"explanations" : "detailed" ,
"examples" : true }
}
}
Real-World Examples
Example 1: Feature Implementation Implementing user authentication with JWT tokens:
claude-flow pair --start \
--mode switch \
--agent senior-dev \
--focus implement \
--verify \
--test
👥 Starting pair programming for authentication feature...
[DRIVER: You - 10 minutes]
/explain JWT authentication flow
> AI explains JWT concepts and best practices
/suggest implementation approach
> AI suggests using middleware pattern with refresh tokens
# You write the basic auth middleware structure
[SWITCH TO NAVIGATOR]
[NAVIGATOR: AI - 10 minutes]
/implement JWT token generation with refresh tokens
> AI generates secure token implementation
/test-gen
> AI creates comprehensive test suite
[SWITCH TO DRIVER]
[DRIVER: You - 10 minutes]
# You refine the implementation
/review --security
> AI performs security review, suggests improvements
/commit --message "feat: JWT authentication with refresh tokens"
✅ Truth Score: 0.98 - Committed successfully
Example 2: Bug Fixing Debugging a memory leak in Node.js:
claude-flow pair --start \
--mode navigator \
--agent debugger-expert \
--focus debug \
--trace
👥 Starting debugging session...
/status
> Analyzing application for memory issues...
/perf --profile
> Memory usage growing: 150MB → 450MB over 10 minutes
/find "new EventEmitter" --regex
> Found 3 instances of EventEmitter creation
/inspect eventEmitters --deep
> Discovering listeners not being removed
/suggest fix for memory leak
> AI suggests: "Add removeListener in cleanup functions"
/implement cleanup functions for all event emitters
> AI generates proper cleanup code
/test
> Memory stable at 150MB ✅
/commit --message "fix: memory leak in event emitters"
Example 3: TDD Session Building shopping cart with test-driven development:
claude-flow pair --start \
--mode tdd \
--agent tdd-specialist \
--test-first
👥 TDD Session: Shopping Cart Feature
[RED PHASE]
/test-gen "add item to cart"
> AI writes failing test:
✗ should add item to cart
✗ should update quantity for existing item
✗ should calculate total price
[GREEN PHASE]
/implement minimal cart functionality
> You write just enough code to pass tests
/test
> Tests passing: 3/3 ✅
[REFACTOR PHASE]
/refactor --pattern repository
> AI refactors to repository pattern
/test
> Tests still passing: 3/3 ✅
[NEXT CYCLE]
/test-gen "remove item from cart"
> AI writes new failing tests...
Example 4: Code Refactoring
claude-flow pair --start \
--mode driver \
--focus refactor \
--verify \
--threshold 0.98
👥 Refactoring Session: Modernizing UserService
/analyze UserService.js
> AI identifies:
- Callback hell (5 levels deep)
- No error handling
- Tight coupling
- No tests
/suggest refactoring plan
> AI suggests:
1. Convert callbacks to async/await
2. Add error boundaries
3. Extract dependencies
4. Add unit tests
/test-gen --before-refactor
> AI generates tests for current behavior
/refactor callbacks to async/await
# You refactor with AI guidance
/test
> All tests passing ✅
/review --compare
> AI shows before/after comparison
> Code complexity: 35 → 12
> Truth score: 0.99 ✅
/commit --message "refactor: modernize UserService with async/await"
Example 5: Performance Optimization Optimizing slow React application:
claude-flow pair --start \
--mode switch \
--agent performance-expert \
--focus optimize \
--profile
👥 Performance Optimization Session
/perf --profile
> React DevTools Profiler Results:
- ProductList: 450ms render
- CartSummary: 200ms render
- Unnecessary re-renders: 15
/suggest optimizations for ProductList
> AI suggests:
1. Add React.memo
2. Use useMemo for expensive calculations
3. Implement virtualization for long lists
/implement React.memo and useMemo
# You implement with AI guidance
/perf --profile
> ProductList: 45ms render (90% improvement!) ✅
/implement virtualization with react-window
> AI implements virtual scrolling
/perf --profile
> ProductList: 12ms render (97% improvement!) ✅
> FPS: 60 stable ✅
/commit --message "perf: optimize ProductList with memoization and virtualization"
Example 6: API Development Building RESTful API with Express:
claude-flow pair --start \
--mode navigator \
--agent backend-expert \
--focus implement \
--test
👥 API Development Session
/design REST API for blog platform
> AI designs endpoints:
POST /api/posts
GET /api/posts
GET /api/posts/:id
PUT /api/posts/:id
DELETE /api/posts/:id
/implement CRUD endpoints with validation
> AI implements with Express + Joi validation
/test-gen --integration
> AI generates integration tests
/security --api
> AI adds:
- Rate limiting
- Input sanitization
- JWT authentication
- CORS configuration
/document --openapi
> AI generates OpenAPI documentation
/test --integration
> All endpoints tested: 15/15 ✅
Session Templates
Quick Start Templates
claude-flow pair --template refactor
claude-flow pair --template feature
claude-flow pair --template debug
claude-flow pair --template learn
Session Management
Session Status claude-flow pair --status
👥 Pair Programming Session
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Session ID: pair_1755021234567
Duration: 45 minutes
Status: Active
Partner: senior-dev
Current Role: DRIVER (you)
Mode: Switch (10m intervals)
Next Switch: in 3 minutes
📊 Metrics:
├── Truth Score: 0.982 ✅
├── Lines Changed: 234
├── Files Modified: 5
├── Tests Added: 12
├── Coverage: 87% ↑3%
└── Commits: 3
🎯 Focus: Implementation
📝 Current File: src/auth/login.js
Session History claude-flow pair --history
📚 Session History
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. 2024-01-15 14:30 - 16:45 (2h 15m)
Partner: expert-coder
Focus: Refactoring
Truth Score: 0.975
Changes: +340 -125 lines
2. 2024-01-14 10:00 - 11:30 (1h 30m)
Partner: tdd-specialist
Focus: Testing
Truth Score: 0.991
Tests Added: 24
3. 2024-01-13 15:00 - 17:00 (2h)
Partner: debugger-expert
Focus: Bug Fixing
Truth Score: 0.968
Issues Fixed: 5
Session Persistence
claude-flow pair --save [--name <name>]
claude-flow pair --load <session-id>
claude-flow pair --export <session-id> [--format json|md]
claude-flow pair --report <session-id>
Background Sessions
claude-flow pair --start --background
claude-flow pair --monitor
claude-flow pair --attach <session-id>
claude-flow pair --end <session-id>
Advanced Features
Custom Commands {
"customCommands" : {
"tdd" : "/test-gen && /test --watch" ,
"full-review" : "/lint --fix && /test && /review --strict" ,
"quick-fix" : "/suggest --type fix && /implement && /test"
}
}
/custom tdd
/custom full-review
Command Chaining /test && /commit && /push
/lint --fix && /test && /review --strict
Session Recording
claude-flow pair --start --record
claude-flow pair --replay <session-id>
claude-flow pair --analytics <session-id>
Integration Options claude-flow pair --start --git --auto-commit
claude-flow pair --start --ci --non-interactive
claude-flow pair --start --ide vscode
Best Practices
Session Practices
Clear Goals - Define session objectives upfrontAppropriate Mode - Choose based on task typeEnable Verification - For critical code pathsRegular Testing - Maintain quality continuouslySession Notes - Document important decisionsRegular Breaks - Take breaks every 45-60 minutes
Code Practices
Test Early - Run tests after each changeVerify Before Commit - Check truth scoresReview Security - Always for sensitive codeProfile Performance - Use /perf for optimizationSave Sessions - For complex workLearn from AI - Ask questions frequently
Mode Selection
Driver Mode : When learning, controlling implementationNavigator Mode : For rapid prototyping, generationSwitch Mode : Long sessions, balanced collaborationTDD Mode : Building with testsReview Mode : Quality focusMentor Mode : Learning priorityDebug Mode : Fixing issues
Troubleshooting
Session Won't Start
Check agent availability
Verify configuration file syntax
Ensure clean workspace
Review log files
Session Disconnected
Use --recover to restore
Check network connection
Verify background processes
Review auto-save files
Poor Performance
Reduce verification threshold
Disable continuous testing
Check system resources
Use lighter AI model
Configuration Issues
Validate JSON syntax
Check file permissions
Review priority order (CLI > env > project > user > global)
Run claude-flow pair config validate
Quality Metrics
Truth Score Thresholds Error: < 0.90 ❌
Warning: 0.90 - 0.95 ⚠️
Good: 0.95 - 0.98 ✅
Excellent: > 0.98 🌟
Coverage Thresholds Error: < 70% ❌
Warning: 70% - 80% ⚠️
Good: 80% - 90% ✅
Excellent: > 90% 🌟
Complexity Thresholds Error: > 15 ❌
Warning: 10 - 15 ⚠️
Good: 5 - 10 ✅
Excellent: < 5 🌟
Environment Variables Override configuration via environment:
export CLAUDE_PAIR_MODE=driver
export CLAUDE_PAIR_VERIFY=true
export CLAUDE_PAIR_THRESHOLD=0.98
export CLAUDE_PAIR_AGENT=senior-dev
export CLAUDE_PAIR_AUTO_TEST=true
Command History
↑/↓ - Navigate through command historyCtrl+R - Search command history!! - Repeat last command!<n> - Run command n from history
Keyboard Shortcuts (Configurable) {
"shortcuts" : {
"switch" : "ctrl+shift+s" ,
"suggest" : "ctrl+space" ,
"review" : "ctrl+r" ,
"test" : "ctrl+t"
}
}
Related Commands
claude-flow pair --help - Show helpclaude-flow pair config - Manage configurationclaude-flow pair profile - Manage profilesclaude-flow pair templates - List templatesclaude-flow pair agents - List available agents 