nahisaho Learning Capture
Record consulting learnings and maintain Gotchas for Memory Persistence.
Use This Skill When
- Completing a consulting engagement and recording lessons.
- Discovering a framework limitation or edge case.
- Resolving an analysis error that others should avoid.
- Updating Gotchas in related co-consultant skills.
Workflow
Identify learning event:
- Framework misapplication that was corrected
- Source that proved unreliable
- Client feedback that changed the approach
- MECE gap discovered during review
Structure the learning:
- WHAT: Specific situation
- WHY: Impact and frequency
- HOW: Prevention or best practice
- WHERE: Which co-consultant skill to update
Generate Gotcha entry (1-2 lines, concrete, actionable).
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 500 lines after addition.
If any gate fails: identify the specific failing check, fix the issue, and re-validate before proceeding.
Gotchas
- 学びの記録は「ミス発生直後」に行うこと。時間が経つと詳細を忘れる
- 「フレームワークをもっと勉強しよう」のような汎用的な教訓は価値が低い。具体的な失敗と対策を書く
- 同じ学びを複数スキルに重複記載しない。最も関連性の高い1箇所に書く
Validation Loop
Run python coreclaw-skills-hub/.github/scripts/validate_skill.py on modified skills after Gotchas update.
- Gotcha エントリを生成
- チェック:
- 具体的な状況・対策が含まれるか
- 既存 Gotchas と重複していないか
- 追記後のスキルが 500 行以内か
- 不合格なら修正
- 合格後に追記実行