featbit

This is the English version of the FeatBit documentation Q&A assistant, optimized using the Skill Judge evaluation framework.

Optimization Results

• Before: 82/120 (68.3%, Grade C)
• After: 105/120 (87.5%, Grade A-)
• Improvement: +23 points (+19.2%)

Key Improvements

1. ✅ Fixed Progressive Disclosure Failure (D5: 6/15 → 15/15)

• Added MANDATORY loading trigger at workflow start
• Agent now loads page-map.md and keywords.md
• References utilization: 0% → 100%

2. ✅ Improved Knowledge Delta (D1: 10/20 → 16/20)

• Deleted 50% redundant content (generic tutorials, basic concepts)
• Expert content ratio: 45% → 75%
• Preserved FeatBit-specific decision logic

3. ✅ Enhanced Anti-Pattern Quality (D3: 8/15 → 13/15)

• NEVER rules expanded from 3 → 6
• Each rule includes specific consequence explanations
• Learned from real pitfalls

4. ✅ Added Mental Framework (D2: 9/15 → 13/15)

• "Before fetching docs, ask yourself" decision flow
• Fetch failure handling decision table
• Documentation source architecture logic

Quick Start

View SKILL.md

cat SKILL.md

Test Query Tool

python scripts/query.py "How to integrate .NET SDK"

View Optimization Report

cat OPTIMIZATION_REPORT.md

File Structure

featbit-skill-v4.0.0-en/
├── SKILL.md                 # Main file (259 lines, optimized)
├── README.md                # This file
├── CHANGELOG.md             # Version changelog
├── OPTIMIZATION_REPORT.md   # Detailed optimization report
├── scripts/
│   └── query.py            # Query tool (274 lines)
└── references/
    ├── page-map.md         # 29 doc page mappings
    ├── keywords.md         # Keyword matching rules
    └── usage.md            # Human usage guide (Agent doesn't load)

Usage Recommendations

For AI Agents

1. After activation, must load page-map.md and keywords.md first
2. Use query.py for quick doc page location
3. Follow 6 NEVER rules to avoid common mistakes
4. Judge documentation location based on decision framework

For Maintainers

1. When adding new docs, update 3 files synchronously
2. Regularly check if GitHub repository URLs changed
3. Update NEVER list when discovering new common pitfalls

Key Features

• ✅ Real-time Fetching: No cache, always latest information
• ✅ Precise Routing: 29 doc pages, keyword exact matching
• ✅ Complete Toolchain: query.py supports CLI and Python API
• ✅ Pitfall Prevention: 6 NEVER rules avoid common errors

Language Support

• English: This version (v4.0.0-en)
• Chinese: See featbit-skill-optimized/ for Chinese version

Both versions have identical functionality and optimizations.

Further Optimization

If you have extra time, consider:

1. Add unit tests to verify keyword matching
2. Add doc URL health check script
3. Create FAQ for common questions

Current version already meets production-ready standards (Grade A-).