elicitation
npx machina-cli add skill fusengine/agents/elicitation --openclawFiles (1)
SKILL.md
4.6 KB
Elicitation Skill
Purpose
Enable expert agents to self-review and self-correct their code before external validation (sniper). Based on BMAD-METHOD's 75 elicitation techniques.
3 Execution Modes
Mode 1: MANUAL (default)
Expert presents 5 relevant techniques → User chooses → Expert applies
Mode 2: AUTO (--auto)
Expert auto-detects code type → Auto-selects techniques → Applies silently
Mode 3: SKIP (--skip)
Skip elicitation → Go directly to sniper validation
Quick Start
After Execute phase, expert runs:
# Manual mode (default)
> Apply elicitation skill
# Auto mode (no prompts)
> Apply elicitation skill --auto
# Skip self-review
> Apply elicitation skill --skip
Workflow Overview
┌─────────────────────────────────────────────────────────┐
│ ELICITATION WORKFLOW │
│ │
│ Step 0: Init → Load context │
│ Step 1: Analyze Code → Detect code type │
│ Step 2: Select → Choose techniques (or auto) │
│ Step 3: Apply Review → Execute techniques │
│ Step 4: Self-Correct → Fix own issues │
│ Step 5: Report → Summary before sniper │
└─────────────────────────────────────────────────────────┘
Auto-Detection Matrix
| Code Type Detected | Auto-Selected Techniques |
|---|---|
| Authentication/Security | Security Audit, OWASP Check, Input Validation |
| API Endpoints | Error Handling, Type Coverage, API Contracts |
| Database/ORM | N+1 Detection, Migration Safety, Data Integrity |
| UI Components | Accessibility, Edge Cases, Loading States |
| Business Logic | SOLID Compliance, Unit Test Coverage, Edge Cases |
| Refactoring | Breaking Changes, Regression Analysis, Backward Compat |
| Performance Critical | Profiling, Memory Analysis, Complexity Check |
Technique Categories (12)
Full catalog: references/techniques-catalog.md
- Code Quality (7): Code review, Pattern detection, Complexity analysis...
- Security (7): OWASP audit, Input validation, Auth check...
- Performance (6): Profiling, N+1 detection, Memory analysis...
- Architecture (6): SOLID check, Dependency analysis, Coupling review...
- Testing (6): Edge cases, Boundary testing, Error paths...
- Documentation (6): API review, Comment check, Type coverage...
- UX (6): Accessibility, Error messages, Loading states...
- Data (6): Schema validation, Migration safety, Data integrity...
- Concurrency (6): Race conditions, Deadlock analysis, State sync...
- Integration (7): API contracts, Backward compat, Breaking changes...
- Observability (6): Logging, Metrics, Error tracking...
- Maintainability (6): Readability, Naming, File organization...
Total: 75 techniques
Integration with APEX
A-nalyze → P-lan → E-xecute → [ELICIT] → X-amine
│ │ │
▼ ▼ ▼
Expert Expert sniper
code self-review (final)
Benefits:
- Expert catches own mistakes before sniper
- Faster validation (less sniper corrections)
- Knowledge retention (expert learns from self-review)
Forbidden
- ❌ Skip init step (must load context)
- ❌ Apply techniques without understanding code type
- ❌ Self-correct without documenting changes
- ❌ Report without listing applied techniques
- ❌ Use techniques outside expertise domain
Steps Reference
| Step | File | Purpose |
|---|---|---|
| 0 | steps/step-00-init.md | Load context, detect mode |
| 1 | steps/step-01-analyze-code.md | Analyze written code |
| 2 | steps/step-02-select-techniques.md | Select techniques |
| 3 | steps/step-03-apply-review.md | Apply review |
| 4 | steps/step-04-self-correct.md | Self-correct |
| 5 | steps/step-05-report.md | Generate report |
Source
git clone https://github.com/fusengine/agents/blob/main/plugins/ai-pilot/skills/elicitation/SKILL.mdView on GitHub Overview
An auto-review mechanism enabling expert agents to self-review and self-correct code before external validation. It leverages BMAD-METHOD's 75 elicitation techniques and supports manual, auto, or skip modes to streamline sniper validation.
How This Skill Works
The skill loads context, analyzes code to detect type, and selects applicable elicitation techniques (manual prompts or automatic). It then applies the review, performs self-corrections, and reports a summary before sniper validation, guided by the 75-technique BMAD-METHOD catalog.
When to Use It
- Before sniper validation to catch mistakes early and reduce corrections
- During refactoring to prevent regressions and maintain code quality
- When you want silent, prompt-free review using AUTO mode (--auto)
- When you need to bypass self-review for speed using SKIP (--skip)
- When a documented record of applied techniques is required for audits
Quick Start
- Step 1: Run "Apply elicitation skill" (Manual mode, default)
- Step 2: Run "Apply elicitation skill --auto" (Auto mode)
- Step 3: Run "Apply elicitation skill --skip" (Skip)
Best Practices
- Load context before analysis (Step 0) to ensure accurate code-type detection
- Explicitly document each applied technique in the final report
- Choose the appropriate mode based on urgency and risk (manual, auto, skip)
- Verify self-corrections with targeted tests or lightweight checks
- Keep technique usage within the BMAD-METHOD catalog and your domain expertise
Example Use Cases
- Security API: Self-review for input validation and error handling in endpoints
- UI Component: Accessibility checks and edge-case handling before release
- Database/ORM: N+1 detection and data integrity review during migrations
- Performance-Critical: Profiling and memory usage checks to avoid regressions
- Business Logic: SOLID compliance and comprehensive edge-case coverage
Frequently Asked Questions
Add this skill to your agents
