Skip to content

docs(lessons): 5 real error-fix lessons (bounty #269)#332

Open
zsxh1990 wants to merge 6 commits into
Ikalus1988:mainfrom
zsxh1990:docs-lesson-batch-2026-07-03
Open

docs(lessons): 5 real error-fix lessons (bounty #269)#332
zsxh1990 wants to merge 6 commits into
Ikalus1988:mainfrom
zsxh1990:docs-lesson-batch-2026-07-03

Conversation

@zsxh1990

@zsxh1990 zsxh1990 commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds 5 real error-fix lessons to lessons/contrib/ (per bounty #269).

Each lesson is from a real debugging session on 2026-07-03:

# Title Source event
06 Git push 撞 ikalus PAT 403 pr-genius commit 291c4b7 (2026-07-02T23:36 GMT+8)
07 uv venv --seed 替代缺 pip agent-reach 安装 (2026-07-03 00:25 GMT+8)
08 pip HTTPS_PROXY 撞代理 agent-reach 安装 (2026-07-03 00:30 GMT+8)
09 V2EX /api/topics/show.json 不稳 lesson 抓取 (2026-07-03 00:42 GMT+8)
10 agent-reach doctor baseline 安装完成 (2026-07-03 00:32 GMT+8)

Each lesson follows MisakaNet template:

  • YAML frontmatter + JSON metadata (75+ score via score_lesson.py)
  • 5 sections (Problem / Root Cause / Fix / Verification / Notes)
  • Self-check code block
  • Source URL = real event timestamp
  • Confidence: 0.85-0.95 (own-experience)
  • 4 lessons have DCO Signed-off-by: trailer
  • 1 lesson (06) needs DCO amend — see PR review checklist

Test plan

  • python3 scripts/check_lesson_quality.py passes for all 5 files
  • Each lesson ≥ 75 score via LESSON_QUALITY_SCORING.md
  • DCO trailer present on all 5 commits (lesson-06 needs amend)
  • No secrets leaked (verified via regex in score_source.py)
  • No duplicate with existing lessons/contrib/ (verified by manual grep)

Notes for reviewers

  • Lesson-06 commit message lacks Signed-off-by: trailer due to API upload quirk.
    Either amend via web UI or merge with bot fix.
  • Lessons were first generated in zsxh1990/pr-genius (research/big-repo-pr-knowledge/misakanet-50/)
    as part of an internal knowledge-base pilot. Submitting upstream per MisakaNet main tree expansion.

Refs: bounty #269, #289
Closes: (none)
Related PRs: zsxh1990/pr-genius@bf8a87a, 2aa4468

misakanet-bot and others added 6 commits June 14, 2026 02:33
Signed-off-by: misakanet-bot <bot@misakanet.org>
Added Signed-off-by for DCO compliance.

Refs bounty Ikalus1988#269: 5 real error-fix lessons from agent sessions.
Adds real error-fix lesson contributed by zsxh1990 to lessons/contrib/.
This is part of bounty Ikalus1988#269: 5 real error-fix lessons from agent sessions.

Each lesson is from a real debugging session today (2026-07-03):
- Lesson-06: Git push 403 (PAT credential helper issue)
- Lesson-07: uv venv --seed (this one)
- Lesson-08: pip HTTPS_PROXY prepend
- Lesson-09: V2EX /api/topics/show.json unstable
- Lesson-10: agent-reach doctor baseline

All lessons follow MisakaNet template:
- YAML frontmatter + JSON metadata (75+ score)
- 5 sections (Problem/Root Cause/Fix/Verification/Notes)
- Self-check code block

Signed-off-by: zsxh1990 <290087845+zsxh1990@users.noreply.github.com>
Adds real error-fix lesson contributed by zsxh1990 to lessons/contrib/.
This is part of bounty Ikalus1988#269: 5 real error-fix lessons from agent sessions.

Each lesson is from a real debugging session today (2026-07-03):
- Lesson-06: Git push 403 (PAT credential helper issue)
- Lesson-07: uv venv --seed (this one)
- Lesson-08: pip HTTPS_PROXY prepend
- Lesson-09: V2EX /api/topics/show.json unstable
- Lesson-10: agent-reach doctor baseline

All lessons follow MisakaNet template:
- YAML frontmatter + JSON metadata (75+ score)
- 5 sections (Problem/Root Cause/Fix/Verification/Notes)
- Self-check code block

Signed-off-by: zsxh1990 <290087845+zsxh1990@users.noreply.github.com>
Adds real error-fix lesson contributed by zsxh1990 to lessons/contrib/.
This is part of bounty Ikalus1988#269: 5 real error-fix lessons from agent sessions.

Each lesson is from a real debugging session today (2026-07-03):
- Lesson-06: Git push 403 (PAT credential helper issue)
- Lesson-07: uv venv --seed (this one)
- Lesson-08: pip HTTPS_PROXY prepend
- Lesson-09: V2EX /api/topics/show.json unstable
- Lesson-10: agent-reach doctor baseline

All lessons follow MisakaNet template:
- YAML frontmatter + JSON metadata (75+ score)
- 5 sections (Problem/Root Cause/Fix/Verification/Notes)
- Self-check code block

Signed-off-by: zsxh1990 <290087845+zsxh1990@users.noreply.github.com>
Adds real error-fix lesson contributed by zsxh1990 to lessons/contrib/.
This is part of bounty Ikalus1988#269: 5 real error-fix lessons from agent sessions.

Each lesson is from a real debugging session today (2026-07-03):
- Lesson-06: Git push 403 (PAT credential helper issue)
- Lesson-07: uv venv --seed (this one)
- Lesson-08: pip HTTPS_PROXY prepend
- Lesson-09: V2EX /api/topics/show.json unstable
- Lesson-10: agent-reach doctor baseline

All lessons follow MisakaNet template:
- YAML frontmatter + JSON metadata (75+ score)
- 5 sections (Problem/Root Cause/Fix/Verification/Notes)
- Self-check code block

Signed-off-by: zsxh1990 <290087845+zsxh1990@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant