nahisaho Learning Capture
Learning design insights, design pitfalls, and Gotchas maintenance.
Use This Skill When
- Completing a learning design task and recording lessons learned.
- Discovering a design pitfall or alignment edge case.
- Resolving an error that future designers should avoid.
- Updating Gotchas in related co-learning skills.
Workflow
- Identify learning event (misalignment, Bloom's mismatch, rubric gap, unexpected outcome).
- Structure: WHAT (situation) → WHY (impact) → HOW (prevention) → WHERE (target skill).
- Generate 1–2 line Gotcha entry with specific criteria. Avoid generic advice.
- Update target skill's Gotchas section.
- Record in
logs/learnings-log.jsonl.
Deliverables
- Updated Gotchas in target skill's SKILL.md.
logs/learnings-log.jsonl: timestamped learning record.
Quality Gates
- Learning is specific (not generic advice).
- Gotcha entry is 1–2 lines and actionable.
- No duplicate with existing Gotchas.
- Target skill remains under 60 lines after addition.
If any gate fails: identify the issue, fix, and re-validate.
CI Validation
Run python coreclaw-skills-hub/.github/scripts/validate_skill.py <skill-dir> after updates.
Gotchas
- 学習の記録はタスク完了直後に行うこと。セッション終了後は詳細が失われる
- 汎用的なアドバイス（「もっとテストする」）は価値がない。プロジェクト固有の具体的な知見を記録すること
- 1つのスキルに Gotchas が10項目を超えたらカテゴリ分けまたは分割を検討すること
Validation Loop
- Generate Gotcha entry
- Check: specific and actionable, no duplicates, skill stays under 60 lines
- If any check fails → revise entry
- Execute update after validation passes