[Bounty] Write 3 lessons from your own debugging experience

[Ikalus1988]

Bounty: Write Lessons From Your Debugging Experience

This is a repeatable bounty. No /claim needed. Anyone can submit PRs at any time.
Each submission is independently reviewed and merged. The more lessons, the better.

Reward: Merge + Hall of Fame + "MisakaNet Contributor" badge
Flywheel: More lessons -> better search -> more agents find answers -> flywheel accelerates

How It Works

1. You debug a real error
2. You write it as a MisakaNet lesson
3. You submit a PR referencing this issue ([Bounty] Write 3 lessons from your own debugging experience #256)
4. Maintainer reviews and merges
5. Your name goes on the Hall of Fame
6. Repeat as many times as you want -- each batch of 3 lessons = 1 PR

No Claim Required

Unlike other competition issues, this one has no exclusive claim window. Submit anytime. Multiple people can submit simultaneously.

Submission Format

Each PR should contain 1-3 lessons in lessons/contrib/. Each lesson needs:

{
  "title": "Short descriptive title",
  "domain": "devops|python|network|feishu|rag|...",
  "tags": ["keyword1", "keyword2"],
  "status": "published",
  "source": "your-github-username"
}

Body structure:

## Problem
What went wrong (include actual error message)

## Root Cause
Why it happened

## Fix
Exact steps to fix (copy-pasteable commands)

## Verification
How to confirm the fix works

Quality Rules

• Real errors only (not hypothetical)
• Include actual error messages (redact secrets)
• Fix must be tested (not theoretical)
• No duplicates -- search existing lessons first

Getting Started

git clone https://github.com/Ikalus1988/MisakaNet.git
cd MisakaNet
pip install misakanet-core
python3 search_knowledge.py "your error"  # check no duplicate exists
python3 scripts/queue_lesson.py --title "Your Error" --domain "devops" --content "..."

Submissions Log

Contributor	Lessons	PR	Status
(comment with your PR link after submitting)

---

Difficulty: Easy | Time: 30min per lesson | Repeatable: Yes | Fork required: Yes

[xuhongchen521-debug]

/attempt #256

我来做这个，正在写PR。

[Ikalus1988]

Repeatable bounty activated. This issue is open to all contributors. No /claim needed. Submit PRs anytime. Each batch of 3 lessons = 1 PR = Hall of Fame entry.

[Ikalus1988]

Acceptance Criteria clarification

For each batch PR under this repeatable bounty:

• Adds exactly 3 real debugging lessons, unless the maintainer explicitly accepts a smaller batch.
• Each lesson lives under lessons/contrib/ and has valid frontmatter with title, domain, tags, status, and source.
• Each lesson includes Problem, Root Cause, Fix, and Verification sections.
• Each lesson includes the real error message or symptom, with secrets and private paths redacted.
• The contributor searched first to avoid duplicates, and includes the search query used.
• Run PYTHONIOENCODING=utf-8 python scripts/validate_lessons.py or the closest supported validation command, and paste the result.
• Commit is DCO-signed.

Not accepted

• AI-generated generic advice without a real incident.
• Lessons that only say "try reinstalling" without root cause and verification.
• Duplicate lessons that already exist in lessons/.

[Ikalus1988]

Acceptance Criteria

For each batch of3 lessons:

• Real errors only: From your actual debugging sessions, not hypothetical
• SKP format: frontmatter (title, domain, tags, status, source) + Problem/Root Cause/Fix/Verification
• Unique: No duplicate of existing lessons (search first with python3 search_knowledge.py)
• Quality score ≥0.5: Run python3 scripts/score_lessons.py to verify
• Desensitized: No secrets, tokens, internal URLs, or customer names
• One PR per batch:3 lessons in1 PR, each as separate commit

Repeatable bounty: Each batch of3 =1 PR = Hall of Fame entry. Submit anytime.

Difficulty: 🟢 Ring-1 — lesson writing.

[Ikalus1988]

✅ Success Example

3 lessons, each with: frontmatter + Problem + Root Cause + Fix + Verification. Example: python-gbk-encoding-error.md

Maintainer checklist: all4 sections present, errors real, no duplicates, quality ≥0.5

[zsxh1990]

Claiming 3 lessons. I have real debugging experience to contribute:

1. feishu-block-api-false-success — Feishu block API returning 200 but silently dropping content (already in contrib, will verify and improve)
2. rag-cross-encoder-cpu-bottleneck — cross-encoder reranking killing latency on CPU-only boxes
3. New: browser-automation-csp-bypass — hitting CSP blocks when automating authenticated pages, solutions that actually work

Will use the domain templates from #294 and #295 as format reference.

@zeroknowledge0x @2lll5 — feel free to claim more lessons from this bounty too, it is repeatable!